You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Clean up verbiage on build scripts
* Update docs/BuildFromSource.md
Co-authored-by: Kevin Pilch <[email protected]>
Co-authored-by: Kevin Pilch <[email protected]>
Copy file name to clipboardExpand all lines: docs/BuildFromSource.md
+4-18Lines changed: 4 additions & 18 deletions
Original file line number
Diff line number
Diff line change
@@ -224,6 +224,8 @@ code .
224
224
225
225
When developing in VS Code, you'll need to use the `build.cmd` or `build.sh` scripts in order to build the project. You can learn more about the command line options available, check out [the section below](using-dotnet-on-command-line-in-this-repo).
226
226
227
+
> :warning: Most of the time, you will want to build a particular project instead of the entire repository. It's faster and will allow you to focus on a particular area of concern. If you need to build all code in the repo for any reason, you can use the top-level build script located under `eng\build.cmd` or `eng\build.sh`.
228
+
227
229
The source code in this repo is divided into directories for each project area. Each directory will typically contain a `src` directory that contains the source files for a project and a `test` directory that contains the test projects and assets within a project.
228
230
229
231
Some projects, like the `Components` project or the `Razor` project, might contain additional subdirectories.
@@ -242,6 +244,8 @@ On macOS/Linux, you can run the shell script:
242
244
./build.sh
243
245
```
244
246
247
+
> :bulb: Before using the `build.cmd` or `build.sh` at the top-level or in a subfolder, you will need to make sure that [the dependencies documented above](#step-2-install-pre-requisites) have been installed.
248
+
245
249
By default, all of the C# projects are built. Some C# projects require NodeJS to be installed to compile JavaScript assets which are then checked in as source. If NodeJS is detected on the path, the NodeJS projects will be compiled as part of building C# projects. If NodeJS is not detected on the path, the JavaScript assets checked in previously will be used instead. To disable building NodeJS projects, specify `-noBuildNodeJS` or `--no-build-nodejs` on the command line.
246
250
247
251
## Step 4: Make your code changes
@@ -288,24 +292,6 @@ On macOS/Linux:
288
292
289
293
> :bulb: If you're working on changes for a particular subset of the project, you might not want to execute the entire test suite. Instead, only run the tests within the subdirectory where changes were made. This can be accomplished by passing the `projects` property like so: `.\build.cmd -test -projects .\src\Framework\test\Microsoft.AspNetCore.App.UnitTests.csproj`.
290
294
291
-
### Building a subset of the code
292
-
293
-
When working in the repository, you'll typically be focused on one project area, such as Blazor and SignalR. In that case, it's easier to use the `build.cmd` and `build.sh` that are available in each subfolder. When invoked in a subfolder on Windows:
294
-
295
-
```ps1
296
-
.\build.cmd
297
-
```
298
-
299
-
Or on macOS or Linux:
300
-
301
-
```bash
302
-
./build.sh
303
-
```
304
-
305
-
> :bulb: Before using the `build.cmd` or `build.sh` at the top-level or in a subfolder, you will need to make sure that [the dependencies documented above](#step-2-install-pre-requisites) have been installed.
306
-
307
-
These scripts will build and test the projects within a specific directory. Furthermore, you can use flags on `build.cmd`/`.sh` to build subsets based on language type, like C++, TypeScript, or C#. Run `build.sh --help` or `build.cmd -help` for details.
308
-
309
295
### Build properties
310
296
311
297
Additional properties can be added as an argument in the form `/property:$name=$value`, or `/p:$name=$value` for short. For example:
0 commit comments