Skip to content

Commit 47b2883

Browse files
authored
doc: updated building docs for windows
PR-URL: #49767 Reviewed-By: Jacob Smith <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Richard Lau <[email protected]> Reviewed-By: Rafael Gonzaga <[email protected]> Reviewed-By: Moshe Atlow <[email protected]>
1 parent aadfea4 commit 47b2883

File tree

2 files changed

+24
-15
lines changed

2 files changed

+24
-15
lines changed

BUILDING.md

+20-11
Original file line numberDiff line numberDiff line change
@@ -576,9 +576,9 @@ to run it again before invoking `make -j4`.
576576

577577
* [Python 3.11](https://apps.microsoft.com/store/detail/python-311/9NRWMJP3717K)
578578
* The "Desktop development with C++" workload from
579-
[Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2019-and-other-products) or
579+
[Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) or
580580
the "C++ build tools" workload from the
581-
[Build Tools](https://aka.ms/vs/16/release/vs_buildtools.exe),
581+
[Build Tools](https://aka.ms/vs/17/release/vs_buildtools.exe),
582582
with the default optional components
583583
* Basic Unix tools required for some tests,
584584
[Git for Windows](https://git-scm.com/download/win) includes Git Bash
@@ -590,11 +590,12 @@ to run it again before invoking `make -j4`.
590590

591591
Optional requirements to build the MSI installer package:
592592

593-
* The .NET SDK component from [Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2019-and-other-products)
593+
* The .NET SDK component from [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/)
594+
* This component can be installed via the Visual Studio Installer Application
594595

595596
Optional requirements for compiling for Windows 10 on ARM (ARM64):
596597

597-
* Visual Studio 15.9.0 or newer
598+
* Visual Studio 17.6.0 or newer
598599
* Visual Studio optional components
599600
* Visual C++ compilers and libraries for ARM64
600601
* Visual C++ ATL for ARM64
@@ -610,17 +611,17 @@ packages:
610611
* [Git for Windows](https://chocolatey.org/packages/git) with the `git` and
611612
Unix tools added to the `PATH`
612613
* [Python 3.x](https://chocolatey.org/packages/python)
613-
* [Visual Studio 2019 Build Tools](https://chocolatey.org/packages/visualstudio2019buildtools)
614-
with [Visual C++ workload](https://chocolatey.org/packages/visualstudio2019-workload-vctools)
614+
* [Visual Studio 2022 Build Tools](https://chocolatey.org/packages/visualstudio2022buildtools)
615+
with [Visual C++ workload](https://chocolatey.org/packages/visualstudio2022-workload-vctools)
615616
* [NetWide Assembler](https://chocolatey.org/packages/nasm)
616617

617618
To install Node.js prerequisites using
618619
[Boxstarter WebLauncher](https://boxstarter.org/weblauncher), open
619620
<https://boxstarter.org/package/nr/url?https://raw.githubusercontent.com/nodejs/node/HEAD/tools/bootstrap/windows_boxstarter>
620621
with Internet Explorer or Edge browser on the target machine.
621622

622-
Alternatively, you can use PowerShell. Run those commands from an elevated
623-
PowerShell terminal:
623+
Alternatively, you can use PowerShell. Run those commands from
624+
an elevated (Administrator) PowerShell terminal:
624625

625626
```powershell
626627
Set-ExecutionPolicy Unrestricted -Force
@@ -635,8 +636,16 @@ disk space.
635636

636637
#### Building Node.js
637638

638-
If the path to your build directory contains a space or a non-ASCII character,
639-
the build will likely fail.
639+
* Remember to first clone the Node.js repository with the Git command
640+
and head to the directory that Git created; If you haven't already
641+
```powershell
642+
git clone https://github.com/nodejs/node.git
643+
cd node
644+
```
645+
* If the path to your build directory contains a space or a non-ASCII character,
646+
the build will likely fail
647+
648+
To start the build process:
640649

641650
```powershell
642651
.\vcbuild
@@ -697,7 +706,7 @@ This is the default option.
697706
### Trimmed: `small-icu` (English only) support
698707

699708
In this configuration, only English data is included, but
700-
the full `Intl` (ECMA-402) APIs. It does not need to download
709+
the full `Intl` (ECMA-402) APIs. It does not need to download
701710
any dependencies to function. You can add full data at runtime.
702711

703712
#### Unix/macOS

tools/bootstrap/windows_boxstarter

+4-4
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,11 @@
1414

1515
# Git and Unix tools will be added to the PATH
1616
choco install git -params /GitAndUnixToolsOnPath -y
17-
choco install python python2 -y
17+
choco install python3 -y
1818

19-
# Installs VS 2019 Build Tools
20-
choco install visualstudio2019buildtools -y
21-
choco install visualstudio2019-workload-vctools -y --params="--add Microsoft.VisualStudio.Component.VC.Tools.ARM64 --add Microsoft.VisualStudio.Component.VC.ATL.ARM64"
19+
# Installs VS 2022 Build Tools
20+
choco install visualstudio2022buildtools -y
21+
choco install visualstudio2022-workload-vctools -y --params="--add Microsoft.VisualStudio.Component.VC.Tools.ARM64 --add Microsoft.VisualStudio.Component.VC.ATL.ARM64"
2222

2323
# NASM
2424
choco install nasm -y

0 commit comments

Comments
 (0)