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
Copy file name to clipboardExpand all lines: docs/BuildFromSource.md
+8-8Lines changed: 8 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
Build ASP.NET Core from Source
2
2
==============================
3
3
4
-
Building ASP.NET Core from source allows you tweak and customize ASP.NET Core, and to contribute your improvements back to the project.
4
+
Building ASP.NET Core from source allows you to tweak and customize ASP.NET Core, and to contribute your improvements back to the project.
5
5
6
6
See https://github.com/aspnet/AspNetCore/labels/area-infrastructure for known issues and to track ongoing work.
7
7
8
-
## Install pre-requistes
8
+
## Install pre-requisites
9
9
10
10
### Windows
11
11
@@ -44,7 +44,7 @@ Building ASP.NET Core on macOS or Linux requires:
44
44
45
45
## Clone the source code
46
46
47
-
ASP.NET Core uses git submodules to include source from a few other projects.
47
+
ASP.NET Core uses git submodules to include the source from a few other projects.
48
48
49
49
For a new copy of the project, run:
50
50
```
@@ -64,19 +64,19 @@ Before opening our .sln files in Visual Studio or VS Code, you need to perform t
64
64
```
65
65
.\restore.cmd
66
66
```
67
-
This will download required tools and build the entire repository once. At that point, you should be able to open .sln files to work on the projects you care about.
67
+
This will download the required tools and build the entire repository once. At that point, you should be able to open .sln files to work on the projects you care about.
68
68
69
69
> :bulb: Pro tip: you will also want to run this command after pulling large sets of changes. On the master branch, we regularly update the versions of .NET Core SDK required to build the repo.
70
70
> You will need to restart Visual Studio every time we update the .NET Core SDK.
71
71
72
-
2. Use the `startvs.cmd` script to open Visual Studio .sln files. This script first sets required environment variables.
72
+
2. Use the `startvs.cmd` script to open Visual Studio .sln files. This script first sets the required environment variables.
73
73
74
74
### Solution files
75
75
76
76
We don't have a single .sln file for all of ASP.NET Core because Visual Studio doesn't currently handle projects of this scale.
77
77
Instead, we have many .sln files which include a sub-set of projects. These principles guide how we create and manage .slns:
78
78
79
-
1. Solution files are not used by CI or command line build scripts. They are for meant for use by developers only.
79
+
1. Solution files are not used by CI or command line build scripts. They are meant for use by developers only.
80
80
2. Solution files group together projects which are frequently edited at the same time.
81
81
3. Can't find a solution that has the projects you care about? Feel free to make a PR to add a new .sln file.
82
82
@@ -91,7 +91,7 @@ Opening solution files and building may produce an error code CS0006 with a mess
91
91
The cause of this problem is that the solution you are using does not include the project that produces this .dll. This most often occurs after we have added new projects to the repo, but failed to update our .sln files to include the new project. In some cases, it is sometimes the intended behavior of the .sln which has been crafted to only include a subset of projects.
92
92
93
93
**You can fix this in one of two ways**
94
-
1. Build the project on command line. In most cases, running `build.cmd` on command line solve this problem.
94
+
1. Build the project on command line. In most cases, running `build.cmd` on command line solves this problem.
95
95
2. Update the solution to include the missing project. You can either do this one by one using `dotnet sln`
By default, all of the C# projects are built. Some C# projects requires 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 /p:BuildNodeJs=false on the command line.
142
+
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 /p:BuildNodeJs=false on the command line.
0 commit comments