From bd9a3244f149c7e519027e36ba89753aa9991059 Mon Sep 17 00:00:00 2001 From: Peter Shipton Date: Wed, 10 Jan 2024 13:40:28 -0500 Subject: [PATCH] Update the Windows build instructions for VS2022 Signed-off-by: Peter Shipton --- .../Build_Instructions_V11.md | 12 ++++----- .../Build_Instructions_V17.md | 12 ++++----- .../Build_Instructions_V8.md | 26 ++++++++++++------- 3 files changed, 29 insertions(+), 21 deletions(-) diff --git a/doc/build-instructions/Build_Instructions_V11.md b/doc/build-instructions/Build_Instructions_V11.md index 6747e744589..65626160d88 100644 --- a/doc/build-instructions/Build_Instructions_V11.md +++ b/doc/build-instructions/Build_Instructions_V11.md @@ -385,7 +385,7 @@ You must install a number of software dependencies to create a suitable build en - [Cygwin](https://cygwin.com/install.html), which provides a Unix-style command line interface. Install all packages in the `Devel` category. In the `Archive` category, install the packages `zip` and `unzip`. In the `Utils` category, install the `cpio` package. Install any further package dependencies that are identified by the installer. More information about using Cygwin can be found [here](https://cygwin.com/docs.html). - [Windows JDK 11](https://api.adoptopenjdk.net/v3/binary/latest/11/ga/windows/x64/jdk/openj9/normal/adoptopenjdk), which is used as the boot JDK. -- [Microsoft Visual Studio 2019](https://aka.ms/vs/16/release/vs_community.exe), which is the version currently used by OpenJ9 builds. +- [Microsoft Visual Studio 2022](https://aka.ms/vs/17/release/vs_community.exe), which is the version currently used by OpenJ9 builds. - [Freemarker V2.3.8](https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download) - only when building with `--with-cmake=no` - [LLVM/Clang](https://releases.llvm.org/7.0.0/LLVM-7.0.0-win64.exe) - [NASM Assembler v2.13.03 or newer](https://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D) @@ -409,17 +409,17 @@ cd /cygdrive/c/temp - Run the following command: ``` -wget https://aka.ms/vs/16/release/vs_community.exe -O vs2019.exe +wget https://aka.ms/vs/17/release/vs_community.exe -O vs2022.exe ``` -- Before installing Visual Studio, change the permissions on the installation file by running `chmod u+x vs2019.exe`. -- Install Visual Studio by running the file `vs2019.exe` (There is no special step required for installing. Please follow the guide of the installer to install all desired components, the C++ compiler is required). +- Before installing Visual Studio, change the permissions on the installation file by running `chmod u+x vs2022.exe`. +- Install Visual Studio by running the file `vs2022.exe` (There is no special step required for installing. Please follow the guide of the installer to install all desired components, the C++ compiler is required). Not all of the shared libraries that are included with Visual Studio are registered during installation. In particular, the `msdia140.dll` libraries must be registered manually by running command prompt as administrator. To do so, execute the following from a command prompt: ``` -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\DIA SDK\bin\msdia140.dll" -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\DIA SDK\bin\amd64\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\amd64\msdia140.dll" ``` - When building with `--with-cmake=no`, unpack the Freemarker archive: diff --git a/doc/build-instructions/Build_Instructions_V17.md b/doc/build-instructions/Build_Instructions_V17.md index fb2b55359ad..b3d80f44672 100644 --- a/doc/build-instructions/Build_Instructions_V17.md +++ b/doc/build-instructions/Build_Instructions_V17.md @@ -378,7 +378,7 @@ You must install a number of software dependencies to create a suitable build en - [Cygwin](https://cygwin.com/install.html), which provides a Unix-style command line interface. Install all packages in the `Devel` category. In the `Archive` category, install the packages `zip` and `unzip`. In the `Utils` category, install the `cpio` package. Install any further package dependencies that are identified by the installer. More information about using Cygwin can be found [here](https://cygwin.com/docs.html). - [Windows JDK 17](https://api.adoptopenjdk.net/v3/binary/latest/17/ga/windows/x64/jdk/openj9/normal/adoptopenjdk), which is used as the boot JDK. -- [Microsoft Visual Studio 2019](https://aka.ms/vs/16/release/vs_community.exe), which is the default compiler level used by OpenJDK17. +- [Microsoft Visual Studio 2022](https://aka.ms/vs/17/release/vs_community.exe), which is the default compiler level used by OpenJDK17. - [Freemarker V2.3.8](https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download) - only when building with `--with-cmake=no` - [LLVM/Clang](https://releases.llvm.org/7.0.0/LLVM-7.0.0-win64.exe) - [NASM Assembler v2.13.03 or newer](https://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D) @@ -402,18 +402,18 @@ cd /cygdrive/c/temp - Run the following command: ``` -wget https://aka.ms/vs/16/release/vs_community.exe -O vs2019.exe +wget https://aka.ms/vs/17/release/vs_community.exe -O vs2022.exe ``` -- Before installing Visual Studio, change the permissions on the installation file by running `chmod u+x vs2019.exe`. -- Install Visual Studio by running the file `vs2019.exe` (There is no special step required for installing. Please follow the guide of the installer to install all desired components, the C++ compiler is required). +- Before installing Visual Studio, change the permissions on the installation file by running `chmod u+x vs2022.exe`. +- Install Visual Studio by running the file `vs2022.exe` (There is no special step required for installing. Please follow the guide of the installer to install all desired components, the C++ compiler is required). Not all of the shared libraries that are included with Visual Studio are registered during installation. In particular, the `msdia140.dll` libraries must be registered manually by running command prompt as administrator. To do so, execute the following from a command prompt: ``` -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\DIA SDK\bin\msdia140.dll" -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\DIA SDK\bin\amd64\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\amd64\msdia140.dll" ``` - When building with `--with-cmake=no`, unpack the Freemarker archive: diff --git a/doc/build-instructions/Build_Instructions_V8.md b/doc/build-instructions/Build_Instructions_V8.md index df7a7a9673f..c178a8daee4 100644 --- a/doc/build-instructions/Build_Instructions_V8.md +++ b/doc/build-instructions/Build_Instructions_V8.md @@ -379,7 +379,7 @@ You must install a number of software dependencies to create a suitable build en - [Cygwin for 64-bit versions of Windows](https://cygwin.com/install.html), which provides a Unix-style command line interface. Install all packages in the `Devel` category. In the `Archive` category, install the packages `zip` and `unzip`. In the `Utils` category, install the `cpio` package. Install any further package dependencies that are identified by the installer. More information about using Cygwin can be found [here](https://cygwin.com/docs.html). - [Windows JDK 8](https://api.adoptopenjdk.net/v3/binary/latest/8/ga/windows/x64/jdk/openj9/normal/adoptopenjdk), which is used as the boot JDK. -- [Microsoft Visual Studio 2019](https://aka.ms/vs/16/release/vs_community.exe), which is the version currently used by OpenJ9 builds. +- [Microsoft Visual Studio 2022](https://aka.ms/vs/17/release/vs_community.exe), which is the version currently used by OpenJ9 builds. - [Freemarker V2.3.8](https://sourceforge.net/projects/freemarker/files/freemarker/2.3.8/freemarker-2.3.8.tar.gz/download) - only when building with `--with-cmake=no` - [LLVM/Clang 64bit](https://releases.llvm.org/7.0.0/LLVM-7.0.0-win64.exe) or [LLVM/Clang 32bit](https://releases.llvm.org/7.0.0/LLVM-7.0.0-win32.exe) - [NASM Assembler v2.13.03 or newer](https://www.nasm.us/pub/nasm/releasebuilds/?C=M;O=D) @@ -396,18 +396,26 @@ Add the path to `nasm.exe` to the `PATH` environment variable to override the ol export PATH="/cygdrive/c/Program Files/NASM:$PATH" (in Cygwin) ``` -Not all of the shared libraries that are included with Visual Studio 2013 or 2017 are registered during installation. -In particular, the `msdia120.dll` or `msdia140.dll` libraries must be registered manually by running command prompt as administrator. To do so, execute the following from a command prompt: + You can download Visual Studio manually or obtain it using the [wget](https://www.gnu.org/software/wget/faq.html#download) utility. If you choose to use `wget`, follow these steps: -VS2013: +- Open a cygwin terminal and change to the `/temp` directory: ``` -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio 12.0\DIA SDK\bin\msdia120.dll" -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio 12.0\DIA SDK\bin\amd64\msdia120.dll" +cd /cygdrive/c/temp ``` -VS2017: + +- Run the following command: +``` +wget https://aka.ms/vs/17/release/vs_community.exe -O vs2022.exe +``` +- Before installing Visual Studio, change the permissions on the installation file by running `chmod u+x vs2022.exe`. +- Install Visual Studio by running the file `vs2022.exe` (There is no special step required for installing. Please follow the guide of the installer to install all desired components, the C++ compiler is required). + +Not all of the shared libraries that are included with Visual Studio are registered during installation. +In particular, the `msdia140.dll` libraries must be registered manually by running command prompt as administrator. To do so, execute the following from a command prompt: + ``` -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\DIA SDK\bin\msdia140.dll" -regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\DIA SDK\bin\amd64\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\msdia140.dll" +regsvr32 "C:\Program Files (x86)\Microsoft Visual Studio\2022\Community\DIA SDK\bin\amd64\msdia140.dll" ``` - When building with `--with-cmake=no`, unpack the Freemarker archive: