Commit 513df82
doc: update to Visual Studio 2026 manual install
PR-URL: #61655
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Stefan Stojanovic <stefan.stojanovic@janeasystems.com>1 parent 7fb7030 commit 513df82
1 file changed
Lines changed: 23 additions & 18 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -737,14 +737,20 @@ Refs: | |||
| 737 | 737 | ||
| 738 | 738 | * The current [version of Python][Python downloads] by following the instructions in | |
| 739 | 739 | [Using Python on Windows][]. | |
| 740 | - * The "Desktop development with C++" workload from | ||
| 741 | - [Visual Studio 2022 (17.13 or newer)](https://visualstudio.microsoft.com/downloads/) | ||
| 742 | - or the "C++ build tools" workload from the | ||
| 743 | - [Build Tools](https://aka.ms/vs/17/release/vs_buildtools.exe), | ||
| 744 | - with the default optional components. As of Node.js 24.0.0, ClangCL is required to compile | ||
| 745 | - on Windows. To enable it, two additional components are needed: | ||
| 740 | + * Select and download the Visual Studio Community Edition 2026 from | ||
| 741 | + [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/) or alternatively download | ||
| 742 | + [Build Tools for Visual Studio 2026](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2026), | ||
| 743 | + and then install. | ||
| 744 | + The Build Tools Edition has the lowest disk space requirements of all editions. | ||
| 745 | + Professional or Enterprise Editions can also be alternatively selected. | ||
| 746 | + * During installation of Visual Studio, select the "Desktop development with C++" workload. | ||
| 747 | + As of Node.js 24.0.0, ClangCL is required to compile on Windows. | ||
| 748 | + To install it, select the following two optional components: | ||
| 746 | 749 | * C++ Clang Compiler for Windows (Microsoft.VisualStudio.Component.VC.Llvm.Clang) | |
| 747 | - * MSBuild support for LLVM toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset) | ||
| 750 | + * MSBuild support for LLVM (clang-cl) toolset (Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset) | ||
| 751 | + * As an alternative to Visual Studio 2026, download Visual Studio 2022 Current channel Version 17.4 from the | ||
| 752 | + [Evergreen bootstrappers](https://learn.microsoft.com/en-us/visualstudio/releases/2022/release-history#evergreen-bootstrappers) | ||
| 753 | + table and install using the same workload and optional component selection as described above. | ||
| 748 | 754 | * Basic Unix tools required for some tests, | |
| 749 | 755 | [Git for Windows](https://git-scm.com/download/win) includes Git Bash | |
| 750 | 756 | and tools which can be included in the global `PATH`. | |
@@ -753,24 +759,23 @@ Refs: | |||
| 753 | 759 | to `PATH`. A build with the `openssl-no-asm` option does not need this, nor | |
| 754 | 760 | does a build targeting ARM64 Windows. | |
| 755 | 761 | ||
| 756 | - Optional requirements to build the MSI installer package: | ||
| 762 | + After you have installed any Visual Studio Edition you can add optional components using the | ||
| 763 | + Modify / Individual Components tab of Visual Studio Installer. | ||
| 757 | 764 | ||
| 758 | - * The .NET SDK component from [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) | ||
| 759 | - * This component can be installed via the Visual Studio Installer Application | ||
| 765 | + Optional component required to build the MSI installer package: | ||
| 760 | 766 | ||
| 761 | - Optional requirements for compiling for Windows on ARM (ARM64): | ||
| 767 | + * The .NET SDK individual component (Microsoft.NetCore.Component.SDK) | ||
| 762 | 768 | ||
| 763 | - * Visual Studio 17.13.0 or newer | ||
| 764 | - * Visual Studio optional components | ||
| 765 | - * Visual C++ compilers and libraries for ARM64 | ||
| 766 | - * Visual C++ ATL for ARM64 | ||
| 767 | - * Windows 10 SDK 10.0.17763.0 or newer | ||
| 769 | + Optional components required to compile for Windows on ARM64: | ||
| 770 | + | ||
| 771 | + * MSVC Build Tools for ARM64/ARM64EC (Microsoft.VisualStudio.Component.VC.Tools.ARM64) | ||
| 772 | + * C++ ATL for ARM64 (Microsoft.VisualStudio.Component.VC.ATL.ARM64) | ||
| 768 | 773 | ||
| 769 | 774 | NOTE: Currently we only support compiling with Clang that comes from Visual Studio. | |
| 770 | 775 | ||
| 771 | - When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed | ||
| 776 | + When building with ClangCL, if the output from `vcbuild.bat` shows that the components are not installed, | ||
| 772 | 777 | even when the Visual Studio Installer shows that they are installed, try removing the components | |
| 773 | - first and then reinstalling them again. | ||
| 778 | + first and then reinstalling them. | ||
| 774 | 779 | ||
| 775 | 780 | ##### Option 2: Automated install with WinGet | |
| 776 | 781 | ||
0 commit comments