Skip to content

Commit 0f04d34

Browse files
cw2hoyosjs
andauthored
Added Visual Studio build tools (#55629) (#56234)
* Added Visual Studio build tools (#55629) Added description of build tools (CMake, Ninja and Python) installation as Visual Studio Individual Components. Added emphasis (bold) of Visual Studio installer sections and components (replaces previously used different styles of quotes). * Removed Python 32-bit VS component Python 64-bit component is enough for building x86 and x64 target architectures. Co-authored-by: Juan Hoyos <[email protected]>
1 parent b0cb96e commit 0f04d34

File tree

1 file changed

+18
-11
lines changed

1 file changed

+18
-11
lines changed

docs/workflow/requirements/windows-requirements.md

Lines changed: 18 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -22,35 +22,42 @@ git config --system core.longpaths true
2222
- Install [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/). The Community edition is available free of charge.
2323

2424
Visual Studio 2019 installation process:
25-
- It's recommended to use 'Workloads' installation approach. The following are the minimum requirements:
26-
- .NET Desktop Development with all default components.
27-
- Desktop Development with C++ with all default components.
28-
- To build for Arm32 or Arm64, make sure that you have the right architecture-specific compilers installed. In the "Individual components" window, in the "Compilers, build tools, and runtimes" section:
29-
- For Arm32, check the box for "MSVC v142 - VS 2019 C++ ARM build tools (v14.23 or newer)".
30-
- For Arm64, check the box for "MSVC v142 - VS 2019 C++ ARM64 build tools (v14.23 or newer)".
25+
- It's recommended to use **Workloads** installation approach. The following are the minimum requirements:
26+
- **.NET Desktop Development** with all default components,
27+
- **Desktop Development with C++** with all default components.
28+
- The build tools (CMake, Ninja and Python) can be downloaded and installed separately (see detailed instructions in the [section below](#build-tools)) or by selecting the following **Individual Components**:
29+
- **C++ CMake tools for Windows** (includes Ninja),
30+
- **Python 3 64-bit** (3.7.4 or newer).
31+
- To build for Arm32 or Arm64, make sure that you have the right architecture-specific compilers installed. In the **Individual components** window, in the **Compilers, build tools, and runtimes** section:
32+
- For Arm32, check the box for **MSVC v142 - VS 2019 C++ ARM build tools (Latest)** (v14.23 or newer),
33+
- For Arm64, check the box for **MSVC v142 - VS 2019 C++ ARM64 build tools (Latest)** (v14.23 or newer).
3134
- To build the tests, you will need some additional components:
32-
- Windows 10 SDK component version 10.0.18362 or newer. This component is installed by default as a part of 'Desktop Development with C++' workload.
33-
- C++/CLI support for v142 build tools (v14.23 or newer)
35+
- **Windows 10 SDK (10.0.18362)** or newer. This component is installed by default as a part of **Desktop Development with C++** workload.
36+
- **C++/CLI support for v142 build tools (Latest)** (v14.23 or newer).
3437

3538
A `.vsconfig` file is included in the root of the dotnet/runtime repository that includes all components needed to build the dotnet/runtime repository. You can [import `.vsconfig` in your Visual Studio installer](https://docs.microsoft.com/en-us/visualstudio/install/import-export-installation-configurations?view=vs-2019#import-a-configuration) to install all necessary components.
3639

3740
Visual Studio 2019 16.6 or later is required for building the repository. Visual Studio 2019 16.10 is required to work with the libraries projects inside the Visual Studio IDE.
3841

39-
## CMake
42+
## Build Tools
43+
44+
These steps are required only in case the tools have not been installed as Visual Studio **Individual Components** (described above).
45+
46+
### CMake
4047

4148
- Install [CMake](https://cmake.org/download) for Windows.
4249
- Add its location (e.g. C:\Program Files (x86)\CMake\bin) to the PATH environment variable.
4350
The installation script has a check box to do this, but you can do it yourself after the fact following the instructions at [Adding to the Default PATH variable](#adding-to-the-default-path-variable).
4451

4552
The dotnet/runtime repository recommends using CMake 3.16.4 or newer, but it may work with CMake 3.15.5.
4653

47-
## Ninja
54+
### Ninja
4855

4956
- Install Ninja in one of the two following ways
5057
- [Download the executable](https://github.com/ninja-build/ninja/releases) and add its location to [the Default PATH variable](#adding-to-the-default-path-variable).
5158
- [Install via a package manager](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages), which should automatically add it to the PATH environment variable.
5259

53-
## Python
60+
### Python
5461

5562
- Install [Python](https://www.python.org/downloads/) for Windows.
5663
- Add its location (e.g. C:\Python*\) to the PATH environment variable.

0 commit comments

Comments
 (0)