From f18ec1ab1e1c5b5889a500d24d983f1a21a0d981 Mon Sep 17 00:00:00 2001 From: Mounir IDRASSI Date: Tue, 2 Jun 2026 18:35:07 +0900 Subject: [PATCH] Update Windows build documentation for VS2022 Replace outdated Visual Studio 2010/2019 and legacy Windows SDK 7.1, WDK 7.1, and Windows 8.1 SDK guidance with the current Visual Studio 2022/v143 toolchain, Windows 10/11 SDK, and WDK requirements. Document NASM, YASM, WiX Toolset v3.x, signtool.exe, and optional legacy BIOS bootloader tools separately. Update the build flow for x64, ARM64, Win32 setup/helper projects, and explicit Driver project builds. Align the zh-cn and ru translated guides with the updated English content while preserving their existing translation style. Fix test certificate paths to use src/Signing/TestCertificate. --- doc/html/en/CompilingGuidelineWin.html | 854 +++------------------- doc/html/ru/CompilingGuidelineWin.html | 847 +++------------------ doc/html/zh-cn/CompilingGuidelineWin.html | 847 +++------------------ 3 files changed, 342 insertions(+), 2206 deletions(-) diff --git a/doc/html/en/CompilingGuidelineWin.html b/doc/html/en/CompilingGuidelineWin.html index c913bced..424888d5 100644 --- a/doc/html/en/CompilingGuidelineWin.html +++ b/doc/html/en/CompilingGuidelineWin.html @@ -61,30 +61,22 @@

-This guide describes how to set up a Windows system that can compile the VeraCrypt. Further it is described how VeraCrypt is going to be compiled.
-The procedure for a Windows 10 system is described here as an example, but the procedure for other Windows systems is analogous. +This guide describes how to set up a Windows system that can compile VeraCrypt. Further it is described how VeraCrypt is going to be compiled.
+The procedure for a Windows 10/11 system is described here as an example, but the procedure for other Windows systems is analogous.
-The following components are required for compiling VeraCrypt: +The following components are required for compiling the current VeraCrypt Windows binaries and drivers; optional alternatives or release-only tools are marked accordingly:
    -
  1. Microsoft Visual Studio 2010
    2. -
  2. Microsoft Visual Studio 2010 Service Pack 1
    3. +
  3. Microsoft Visual Studio 2022, or Build Tools for Visual Studio 2022 as a command-line alternative
    4. +
  4. MSVC v143 C++ toolset with x86/x64 and ARM64 components
    5. +
  5. Windows 10/11 SDK (10.0.19041.0 or newer), including signtool.exe for signing scripts. If the SDK and WDK are installed separately, use matching build numbers.
    6. +
  6. Windows Driver Kit for Windows 10/11 with the Visual Studio 2022 extension
  7. NASM
  8. YASM
    9. -
  9. Visual C++ 1.52
    10. -
  10. Windows SDK 7.1
    11. -
  11. Windows Driver Kit 7.1
    12. -
  12. Windows 8.1 SDK
    13. -
  13. gzip
    14. -
  14. upx
    15. -
  15. 7zip
    16. -
  16. Wix3
    17. -
  17. Microsoft Visual Studio 2019
    18. -
  18. Windows 10 SDK
    19. -
  19. Windows Driver Kit 1903
    20. -
  20. Visual Studio build tools
    21. +
  21. WiX Toolset v3.x (required for MSI packages)
    22. +
  22. Legacy BIOS bootloader tools (optional; required only when rebuilding the Boot project): Microsoft Visual C++ 1.52, gzip, UPX, and dd.exe
@@ -93,24 +85,15 @@ The following components are required for compiling VeraCrypt:
Below are the procedure steps. Clicking on any of the link takes directly to the related step:
-
- Installation of Microsoft Visual Studio 2010 -
-

-

    -
  1. - Visit the following Microsoft website and log in with a free Microsoft account:
    - https://my.visualstudio.com/Downloads?q=Visual%20Studio%202010%20Professional&pgroup= -
    2. -
  2. - Please download a (trial) version of “Visual Studio Professional 2010”
    - -
    3. -
  3. - Mount the downloaded ISO file by doubleclicking it -
    4. -
  4. - Run the file "autorun.exe" as administrator -
    5. -
  5. - Install Microsoft Visual Studio 2010 with the default settings -
    6. -
- The installation of the Microsoft SQL Server 2008 Express Service Pack 1 (x64) may fail, but it is not required for compiling VeraCrypt. -

-
-
- -
- Installation of Microsoft Visual Studio 2010 Service Pack 1 -
-

- Note: The content the official installer from Microsoft tries to download is no longer available. Therefore, it is necessary to use an offline installer. -

    -
  1. - Visit the website of the internet archive and download the iso image of the Microsoft Visual Studio 2010 Service Pack 1:
    - https://archive.org/details/vs-2010-sp-1dvd-1 -
    2. -
  2. - Mount the downloaded ISO file by doubleclicking it -
    3. -
  3. - Run the file "Setup.exe" as administrator -
    4. -
  4. - Install Microsoft Visual Studio 2010 Service Pack 1 with the default settings -
    5. -
-

-
-
-
Installation of NASM
@@ -236,7 +167,7 @@ Below are the procedure steps. Clicking on any of the link takes directly to the C:\Program Files\YASM
  • - Please download the file "Win64 VS2010 .zip" at:
    + Please download the prebuilt Win64 YASM zip archive at:
    https://yasm.tortall.net/Download.html
  • @@ -309,349 +240,46 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    • -
    - Installation of Microsoft Visual C++ 1.52 +
    + Installation of Legacy BIOS Bootloader Tools (optional)

    + These tools are not required to compile the standard VeraCrypt application binaries or the Windows driver with Visual Studio 2022 and the current WDK. Install them only when you need to rebuild the legacy BIOS bootloader in "src\Boot\Windows" or build solution configurations that include the Boot project, such as "ReleaseCustomEFI".

    1. - Visual C++ 1.52 is available via the paid Microsoft MSDN subscription. If you do not have a subscription, you download the ISO image via the internet archive:
      + Install Microsoft Visual C++ 1.52. It is available via the paid Microsoft MSDN subscription. If you do not have a subscription, the ISO image is also archived at:
      https://archive.org/details/ms-vc152
    2. - Create the folder “C:\MSVC15” + Create the folder "C:\MSVC15". Mount the ISO file and copy the content of the folder "MSVC" to "C:\MSVC15".
    3. - Mount the ISO file and copy the content of the folder “MSVC” to “C:\MSVC15” + Create a system variable named "MSVC16_ROOT" with the value "C:\MSVC15".
    4. - Create a system variable for Microsoft Visual C++ 1.52
      -
        -
      1. - Open a file explorer -
        2. -
      2. - Within the left file tree, please make a right click on "This PC" and select "Properties"
        - -
        3. -
      3. - Within the right menu, please click on "Advanced system settings"
        - -
        4. -
      4. - Please click on "Environment Variables"
        - -
        5. -
      5. - Within the area of the system variables, please click on "New..."
        - -
        6. -
      6. - Fill out the form with the following values:
        -

        Variable name: MSVC16_ROOT
        Variable value: C:\MSVC15

        -
        7. -
      7. - Close the windows by clicking on "OK" -
        8. -
      -
      5. -
    -

    -
    -
    - -
    - Installation of the Windows SDK 7.1 -
    -

    - The installer requires .Net Framework 4 (Not a newer one like .Net Framework 4.8!). Since a newer version is already preinstalled with Windows 10, the installer has to be tricked: -

      -
    1. - Click on the start button and search for: "regedit.msc". Start the first finding. + Install gzip and add the folder containing "gzip.exe" to the Path variable.
    2. - Navigate to "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\" + Install UPX and add the folder containing "upx.exe" to the Path variable.
    3. - Change the permissions for the "Client" folder, so you can edit the keys:
      -
        -
      1. - Right click on the subfolder "Client" and select "Permissions..." -
        2. -
      2. - Click on "Advanced"
        - -
        3. -
      3. - Change the owner to your user and click on "Add"
        - -
        4. -
      4. - Set the principal to your user, select "Full Control" and click on "OK"
        - -
        5. -
      5. - Within the folder "Client" note down the value of the entry "Version" -
        6. -
      6. - Doubleclick on the entry "Version" and change the value to "4.0.30319"
        - -
        7. -
      + Install a Windows port of dd and add the folder containing "dd.exe" to the Path variable.
    4. - Change the permissions for the "Full" folder, so you can edit the keys:
      -
        -
      1. - Right click on the subfolder "Full" and select "Permissions..." -
        2. -
      2. - Click on "Advanced"
        - -
        3. -
      3. - Change the owner to your user and click on "Add"
        - -
        4. -
      4. - Set the principal to your user, select "Full Control" and click on "OK"
        - -
        5. -
      5. - Within the folder "Full" note down the value of the entry "Version" -
        6. -
      6. - Doubleclick on the entry "Version" and change the value to "4.0.30319"
        - -
        7. -
      -
      5. -
    5. - Download the Windows SDK 7.1 at:
      - https://www.microsoft.com/en-us/download/details.aspx?id=8279 -
      6. -
    6. - Run the downloaded file as administrator and install the application with default settings -
      7. -
    7. - After the installation, revert the changes done in the registry editor.
      - Note: The owner "TrustedInstaller" can be restored by searching for: "NT Service\TrustedInstaller" -
      8. -
    -

    -
    -
    - -
    - Installation of the Windows Driver Kit 7.1 -
    -

    -

      -
    1. - Please download the ISO of the Windows Diver Kit 7.1 at:
      - https://www.microsoft.com/en-us/download/details.aspx?id=11800 -
      2. -
    2. - Mount the downloaded ISO file by doubleclicking it -
      3. -
    3. - Run the file "KitSetup.exe" as administrator. Within the installation select all features to be installed.
      - Note: It might be that during the installed you are requested to install the .NET Framework 3.5. In this case click on "Download and install this feature". -
      4. -
    4. - Install the Driver Kit to the default location + Open a new command prompt and verify that the following commands are found:
      +

      nasm
      gzip
      upx
      dd --help

    - -
    - Installation of the Windows 8.1 SDK -
    -

    -

      -
    1. - Please download the ISO of the Windows 8.1 SDK at:
      - https://developer.microsoft.com/de-de/windows/downloads/sdk-archive/ -
      2. -
    2. - Run the downloaded file as administrator and install the Windows 8.1 SDK with default settings -
      3. -
    3. - Create a system variable for the Windows 8.1 SDK
      -
        -
      1. - Open a file explorer -
        2. -
      2. - Within the left file tree, please make a right click on "This PC" and select "Properties"
        - -
        3. -
      3. - Within the right menu, please click on "Advanced system settings"
        - -
        4. -
      4. - Please click on "Environment Variables"
        - -
        5. -
      5. - Within the area of the system variables, please click on "New..."
        - -
        6. -
      6. - Fill out the form with the following values:
        -

        Variable name: WSDK81
        Variable value: C:\Program Files (x86)\Windows Kits\8.1\

        -
        7. -
      7. - Close the windows by clicking on "OK" -
        8. -
      -
      4. -
    -

    -
    -
    - -
    - Installation of gzip -
    -

    -

      -
    1. - Please create the following folder:
      - C:\Program Files (x86)\gzip -
      2. -
    2. - Please download gzip version at:
      - https://sourceforge.net/projects/gnuwin32/files/gzip/1.3.12-1/gzip-1.3.12-1-bin.zip/download?use-mirror=netix&download= -
      3. -
    3. - Copy the content of the downloaded zip to “C:\Program Files (x86)\gzip” -
      4. -
    4. - Add gzip to the path Variable. This will make the command globally available on the command line.
      -
        -
      1. - Open a file explorer -
        2. -
      2. - Within the left file tree, please make a right click on "This PC" and select "Properties"
        - -
        3. -
      3. - Within the right menu, please click on "Advanced system settings"
        - -
        4. -
      4. - Please click on "Environment Variables"
        - -
        5. -
      5. - Within the area of the system variables, please select the "Path" variable and click on "Edit..."
        - -
        6. -
      6. - Click on "New" and add the following value:
        -

        C:\Program Files (x86)\gzip\bin

        -
        7. -
      7. - Close the windows by clicking on "OK" -
        8. -
      -
      5. -
    5. - To check if the configuration is working correctly, please open a command prompt and watch the output of the following command:
      -

      gzip


      - -
      6. -
    -

    -
    -
    - -
    - Installation of upx -
    -

    -

      -
    1. - Please create the following folder:
      - C:\Program Files (x86)\upx -
      2. -
    2. - Please download the latest upx-X-XX-win64.zip version at:
      - https://github.com/upx/upx/releases/tag/v3.96 -
      3. -
    3. - Copy the content of the downloaded zip to “C:\Program Files (x86)\upx” -
      4. -
    4. - Add gzip to the path Variable. This will make the command globally available on the command line.
      -
        -
      1. - Open a file explorer -
        2. -
      2. - Within the left file tree, please make a right click on "This PC" and select "Properties"
        - -
        3. -
      3. - Within the right menu, please click on "Advanced system settings"
        - -
        4. -
      4. - Please click on "Environment Variables"
        - -
        5. -
      5. - Within the area of the system variables, please select the "Path" variable and click on "Edit..."
        - -
        6. -
      6. - Click on "New" and add the following value:
        -

        C:\Program Files (x86)\upx

        -
        7. -
      7. - Close the windows by clicking on "OK" -
        8. -
      -
      5. -
    5. - To check if the configuration is working correctly, please open a command prompt and watch the output of the following command:
      -

      upx


      - -
      6. -
    -

    -
    -
    - -
    - Installation of 7zip -
    -

    -

      -
    1. - Please download the latest version of 7zip at:
      - https://www.7-zip.de/ -
      2. -
    2. - Run the downloaded file as administrator and install 7zip with default settings -
      3. -
    -

    -
    -
    -
    - Installation of Wix3 + Installation of WiX Toolset v3.x

    1. - Please download wix311.exe at:
      + Please download WiX Toolset v3.x at:
      https://github.com/wixtoolset/wix3/releases
    2. @@ -662,234 +290,37 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    -
    - Installation of Microsoft Visual Studio 2019 +
    + Installation of Microsoft Visual Studio 2022

    1. - Visit the following Microsoft website and log in with a free Microsoft account:
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20Professional + Download Visual Studio 2022 at:
      + https://visualstudio.microsoft.com/vs/
    2. - Please download the latest (trial) version of “Visual Studio Professional 2019”
      - + Run the downloaded installer as administrator.
    3. - Run the downloaded file as administrator and go through the wizard.
      - Select the following Workloads for installation:
      + Select the "Desktop development with C++" workload. +
      4. +
    4. + Select the following individual components:
        -
      1. - Desktop development with C++ -
        2. -
      2. - .NET desktop development -
        3. -
      - Select the following individual components for installation: -
        -
      1. - .NET -
          -
        1. - .NET 6.0 Runtime -
          2. -
        2. - .NET Core 3.1 Runtime (LTS) -
          3. -
        3. - .NET Framework 4 targeting pack -
          4. -
        4. - .NET Framework 4.5 targeting pack -
          5. -
        5. - .NET Framework 4.5.1 targeting pack -
          6. -
        6. - .NET Framework 4.5.2 targeting pack -
          7. -
        7. - .NET Framework 4.6 targeting pack -
          8. -
        8. - .NET Framework 4.6.1 targeting pack -
          9. -
        9. - .NET Framework 4.7.2 targeting pack -
          10. -
        10. - .NET Framework 4.8 SDK -
          11. -
        11. - .NET Framework 4.8 targeting pack -
          12. -
        12. - .NET SDK -
          13. -
        13. - ML.NET Model Builder (Preview) -
          14. -
        -
        2. -
      2. - Cloud, database, and server -
          -
        1. - CLR data types for SQL Server -
          2. -
        2. - Connectivity and publishing tools -
          3. -
        -
        3. -
      3. - Code tools -
          -
        1. - NuGet package manager -
          2. -
        2. - Text Template Transformation -
          3. -
        -
        4. -
      4. - Compilers, build tools, and runtimes -
          -
        1. - .NET Compiler Platform SDK -
          2. -
        2. - C# and Visual Basic Roslyn compilers -
          3. -
        3. - C++ 2019 Redistributable Update -
          4. -
        4. - C++ CMake tools for Windows -
          5. -
        5. - C++/CLI support for v142 build tools (Latest) -
          6. -
        6. - MSBuild -
          7. -
        7. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          8. -
        8. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          9. -
        9. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          10. -
        10. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          11. -
        -
        5. -
      5. - Debugging and testing -
          -
        1. - .NET profiling tools -
          2. -
        2. - C++ AddressSanatizer -
          3. -
        3. - C++ profiling tools -
          4. -
        4. - Just-In-Time debugger -
          5. -
        5. - Test Adapter for Boost.Test -
          6. -
        6. - Test Adapter for Google Test -
          7. -
        -
        6. -
      6. - Development activities -
          -
        1. - C# and Visual Basic -
          2. -
        2. - C++ core features -
          3. -
        3. - F# language support -
          4. -
        4. - IntelliCode -
          5. -
        5. - JavaScript and TypeScript language support -
          6. -
        6. - Live Share -
          7. -
        -
        7. -
      7. - Emulators -
          - NONE -
        -
        8. -
      8. - Games and Graphics -
          -
        1. - Graphics debugger and GPU profiler for DirectX -
          2. -
        -
        9. -
      9. - SDKs, libraries, and frameworks -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        5. - C++ MFC for latest v142 build tools (ARM64) -
          6. -
        6. - C++ MFC for latest v142 build tools (x86 & x64) -
          7. -
        7. - C++ MFC for latest v142 build tools with Spectre Mitigations (ARM64) -
          8. -
        8. - C++ MFC for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          9. -
        9. - Entity Framework 6 tools -
          10. -
        10. - TypeScript 4.3 SDK -
          11. -
        11. - Windows 10 SDK (10.0.19041.0) -
          12. -
        12. - Windows Universal C Runtime -
          13. -
        -
        10. +
      10. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        12. +
      12. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        13. +
      13. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        14. +
      14. C++ ATL for latest v143 build tools (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools (ARM64)
        16. +
      16. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        17. +
      17. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools (ARM64)
        20. +
      20. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        21. +
      21. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        22. +
      22. Windows 10/11 SDK (10.0.19041.0 or newer)
    @@ -898,24 +329,25 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    - Installation of the Windows Driver Kit version 2004 + Installation of the Windows Driver Kit

    1. - Please download the Windows Driver Kit (WDK) version 2004 at:
      - https://docs.microsoft.com/en-us/windows-hardware/drivers/other-wdk-downloads + Please download a Windows Driver Kit (WDK) version compatible with Visual Studio 2022 at:
      + https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk
    2. - Run the downloaded file as administrator and install the WDK with default settings + Run the downloaded file as administrator and install the WDK with default settings.
    3. - At the end of the installation you will be asked if you want to "install Windows Driver Kit Visual Studio extension".
      - Please make sure, that this option is selected before closing the dialog. + If you install the Windows SDK and WDK separately, make sure their build numbers match.
    4. - A different setup will start automatically and will detect Visual Studio Professional 2019 as possible target for the extension.
      - Please select it and proceed with the installation. + Make sure the WDK Visual Studio extension is installed. If the WDK installer asks whether to "install Windows Driver Kit Visual Studio extension", select this option before closing the dialog. On current Visual Studio 2022 installers, this can also be installed from Individual Components by selecting "Windows Driver Kit". +
      5. +
    5. + If a separate VSIX setup starts automatically, it will detect Visual Studio 2022 as a possible target for the extension. Please select it and proceed with the installation.

    @@ -923,88 +355,34 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    - Installation of the Visual Studio build tools + Installation of the Build Tools for Visual Studio 2022

    + If you installed Visual Studio 2022 with the components listed above, this step can be skipped. Install the Build Tools only if you need a command-line build environment without the full Visual Studio IDE.

    1. - Visit the following Microsoft website and log in with a free Microsoft account:
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20build%20tools + Download the Build Tools for Visual Studio 2022 at:
      + https://visualstudio.microsoft.com/downloads/
    2. - Please download the latest version of “Build Tools for Visual Studio 2019”
      - + Run the downloaded installer as administrator and select the "C++ build tools" workload.
    3. - Run the downloaded file as administrator and go through the wizard. Select the following individual components for installation: + Select the following individual components:
        -
      1. - .NET -
          - NONE -
        -
        2. -
      2. - Cloud, database, and server -
          - NONE -
        -
        3. -
      3. - Code tools -
          - NONE -
        -
        4. -
      4. - Compilers, build tools, and runtimes -
          -
        1. - C++/CLI support for v142 build tools (Latest) -
          2. -
        2. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          3. -
        3. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          4. -
        4. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          5. -
        5. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          6. -
        -
        5. -
      5. - Debugging and testing -
          - NONE -
        -
        6. -
      6. - Development activities -
          - NONE -
        -
        7. -
      7. - SDKs, libraries, and frameworks -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        -
        8. +
      8. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        9. +
      9. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        10. +
      10. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        12. +
      12. C++ ATL for latest v143 build tools (x86 & x64)
        13. +
      13. C++ ATL for latest v143 build tools (ARM64)
        14. +
      14. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        16. +
      16. C++ MFC for latest v143 build tools (x86 & x64)
        17. +
      17. C++ MFC for latest v143 build tools (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        20. +
      20. Windows 10/11 SDK (10.0.19041.0 or newer)
    @@ -1031,60 +409,60 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    - Compile the Win32/x64 Versions of VeraCrypt + Compile the x64, ARM64 and Driver Builds of VeraCrypt

    1. - Please open the file "src/VeraCrypt.sln" in Visual Studio 2010 + Please open the file "src/VeraCrypt.sln" in Visual Studio 2022
    2. - Please select "All|Win32" as active configuration
      - + Please select "Release|x64" as active configuration.
    3. - Please click on "Build -> Build Solution"
      - + Please click on "Build -> Build Solution".
    4. The compiling process should end with warnings, but without errors. Some projects should be skipped.
    5. - Please select "All|x64" as active configuration
      - + Please select "Release|ARM64" as active configuration.
    6. - Please click on "Build -> Build Solution"
      - + Please click on "Build -> Build Solution".
    7. - The compiling process should end with warnings, but without errors. Some projects should be skipped.
      - Please close Visual Studio 2010 after the compiling process finished -
      8. -
    -

    -
    -
    - -
    - Compile the ARM64 Version of VeraCrypt -
    -

    -

      -
    1. - Please open the file "src/VeraCrypt_vs2019.sln" in Visual Studio 2019 + The compiling process should end with warnings, but without errors. Some projects should be skipped.
    2. - Please select "All|ARM64" as active configuration
      - + Please select "Release|Win32" as active configuration and build the solution to compile the Win32 setup/helper projects used by the release packaging scripts.
    3. - Please click on "Build -> Build Solution"
      - + To build VeraCrypt drivers, select the "Driver" project and build it for "Release|x64" and "Release|ARM64".
    4. - The compiling process should end with warnings, but without errors. One project should be skipped.
      - Please close Visual Studio 2019 after the compiling process finished + Build "ReleaseCustomEFI|x64" or "ReleaseCustomEFI|ARM64" only if you need the custom EFI/bootloader release configurations. These configurations include the Boot project and require the optional legacy BIOS bootloader tools listed above. +
      5. +
    5. + If you are using Build Tools for Visual Studio 2022 instead of the Visual Studio IDE, open "Developer Command Prompt for VS 2022" or "Developer PowerShell for VS 2022" as administrator, change to the VeraCrypt source root, and run the equivalent MSBuild commands: +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=ARM64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=Win32
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=ARM64 +       +
      + To build the optional custom EFI/bootloader release configurations, also run: +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=ARM64 +       +
      6. +
    6. + If you built from the IDE, please close Visual Studio 2022 after the compiling process finished.

    @@ -1097,7 +475,7 @@ Below are the procedure steps. Clicking on any of the link takes directly to the

    1. - Please open a command line as administrator + Please open a Visual Studio 2022 command line as administrator so that the Windows SDK signing tools, including "signtool.exe", are available on the Path.
    2. Go into the folder "src/Signing/" @@ -1106,7 +484,7 @@ Below are the procedure steps. Clicking on any of the link takes directly to the Run the script "sign_test.bat"
    3. - You will find the generated exectuables within the folder "src/Release/Setup Files" + You will find the generated executables within the folder "src/Release/Setup Files"

    @@ -1127,10 +505,10 @@ Below are the procedure steps. Clicking on any of the link takes directly to the
    • GlobalSign_R3Cross.cer
    • GlobalSign_SHA256_EV_CodeSigning_CA.cer
      • -
    • TestCertificates/idrix_codeSign.pfx
      • -
    • TestCertificates/idrix_Sha256CodeSign.pfx
      • -
    • TestCertificates/idrix_SHA256TestRootCA.crt
      • -
    • TestCertificates/idrix_TestRootCA.crt
      • +
    • TestCertificate/idrix_codeSign.pfx
      • +
    • TestCertificate/idrix_Sha256CodeSign.pfx
      • +
    • TestCertificate/idrix_SHA256TestRootCA.crt
      • +
    • TestCertificate/idrix_TestRootCA.crt
    Note: If prompted, the password for .pfx certificates is idrix. diff --git a/doc/html/ru/CompilingGuidelineWin.html b/doc/html/ru/CompilingGuidelineWin.html index dfbdb9dc..0f673f16 100644 --- a/doc/html/ru/CompilingGuidelineWin.html +++ b/doc/html/ru/CompilingGuidelineWin.html @@ -60,29 +60,21 @@
    В этом руководстве описано, как настроить систему Windows для компилирования VeraCrypt и как cкомпилировать программу.
    -Здесь как пример приведена процедура для Windows 10, процедуры для других версий Windows аналогичны. +Здесь как пример приведена процедура для Windows 10/11, процедуры для других версий Windows аналогичны.
    -Для компиляции VeraCrypt необходимы следующие компоненты: +Для компиляции текущих двоичных файлов VeraCrypt для Windows и драйверов необходимы следующие компоненты; необязательные альтернативы или инструменты, нужные только для выпуска, отмечены отдельно:
      -
    1. Microsoft Visual Studio 2010
      2. -
    2. Microsoft Visual Studio 2010 Service Pack 1
      3. +
    3. Microsoft Visual Studio 2022 или Build Tools for Visual Studio 2022 как альтернатива для командной строки
      4. +
    4. Набор инструментов MSVC v143 C++ с компонентами x86/x64 и ARM64
      5. +
    5. Windows 10/11 SDK (10.0.19041.0 или новее), включая signtool.exe для скриптов подписи. Если SDK и WDK устанавливаются отдельно, используйте совпадающие номера сборок.
      6. +
    6. Windows Driver Kit для Windows 10/11 с расширением Visual Studio 2022
    7. NASM
    8. YASM
      9. -
    9. Visual C++ 1.52
      10. -
    10. Windows SDK 7.1
      11. -
    11. Windows Driver Kit 7.1
      12. -
    12. Windows 8.1 SDK
      13. -
    13. gzip
      14. -
    14. UPX
      15. -
    15. 7-Zip
      16. -
    16. WiX3
      17. -
    17. Microsoft Visual Studio 2019
      18. -
    18. Windows 10 SDK
      19. -
    19. Windows Driver Kit 1903
      20. -
    20. Средства сборки Visual Studio
      21. +
    21. WiX Toolset v3.x (требуется для MSI-пакетов)
      22. +
    22. Инструменты устаревшего загрузчика BIOS (необязательно; требуются только при пересборке проекта Boot): Microsoft Visual C++ 1.52, gzip, UPX и dd.exe
    @@ -91,24 +83,15 @@
    Ниже приведены шаги процедуры. Нажав на любую ссылку, вы сразу перейдёте к соответствующему шагу:
    -
    - Установка Microsoft Visual Studio 2010 -
    -

    -

      -
    1. - Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
      - https://my.visualstudio.com/Downloads?q=Visual%20Studio%202010%20Professional&pgroup= -
      2. -
    2. - Загрузите (пробную) версию "Visual Studio Professional 2010".
      - -
      3. -
    3. - Смонтируйте загруженный файл ISO, дважды щёлкнув по нему. -
      4. -
    4. - Запустите файл "autorun.exe" от имени администратора. -
      5. -
    5. - Установите Microsoft Visual Studio 2010 с настройками по умолчанию. -
      6. -
    - Установка Microsoft SQL Server 2008 Express Service Pack 1 (x64) может завершиться ошибкой, но это не требуется для компиляции VeraCrypt. -

    -
    -
    - -
    - Установка Microsoft Visual Studio 2010 Service Pack 1 -
    -

    - ПРИМЕЧАНИЕ: Содержимое, которое пытается загрузить официальный установщик Microsoft, больше недоступно. Поэтому необходимо использовать автономный установщик. -

      -
    1. - Посетите сайт интернет-архива и загрузите ISO-образ Microsoft Visual Studio 2010 Service Pack 1:
      - https://archive.org/details/vs-2010-sp-1dvd-1 -
      2. -
    2. - Смонтируйте загруженный файл ISO, дважды щёлкнув по нему. -
      3. -
    3. - Запустите файл "Setup.exe" от имени администратора. -
      4. -
    4. - Установите Microsoft Visual Studio 2010 Service Pack 1 с настройками по умолчанию. -
      5. -
    -

    -
    -
    -
    Установка NASM
    @@ -234,7 +165,7 @@ C:\Program Files\YASM
  • - Загрузите файл "Win64 VS2010 .zip" отсюда:
    + Загрузите предварительно собранный Win64 zip-архив YASM отсюда:
    https://yasm.tortall.net/Download.html
  • @@ -307,336 +238,34 @@
    • -
    - Установка Microsoft Visual C++ 1.52 +
    + Установка инструментов устаревшего загрузчика BIOS (необязательно)

    + Эти инструменты не требуются для компиляции стандартных двоичных файлов приложения VeraCrypt или драйвера Windows с помощью Visual Studio 2022 и текущего WDK. Устанавливайте их только если нужно пересобрать устаревший загрузчик BIOS в "src\Boot\Windows" или собрать конфигурации решения, включающие проект Boot, например "ReleaseCustomEFI".

    1. - Пакет Visual C++ 1.52 доступен по платной подписке Microsoft MSDN. Если у вас нет подписки, загрузите образ ISO через интернет-архив:
      + Установите Microsoft Visual C++ 1.52. Он доступен по платной подписке Microsoft MSDN. Если у вас нет подписки, образ ISO также доступен в интернет-архиве:
      https://archive.org/details/ms-vc152
    2. - Создайте папку "C:\MSVC15". + Создайте папку "C:\MSVC15". Смонтируйте файл ISO и скопируйте содержимое папки "MSVC" в "C:\MSVC15".
    3. - Смонтируйте файл ISO и скопируйте содержимое папки "MSVC" в "C:\MSVC15". + Создайте системную переменную "MSVC16_ROOT" со значением "C:\MSVC15".
    4. - Создайте системную переменную для Microsoft Visual C++ 1.52.
      -
        -
      1. - Откройте Проводник. -
        2. -
      2. - В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
        - -
        3. -
      3. - В правой части окна щёлкните по "Дополнительные параметры системы".
        - -
        4. -
      4. - Нажмите кнопку "Переменные среды".
        - -
        5. -
      5. - В поле "Системные переменные" нажмите кнопку "Создать...".
        - -
        6. -
      6. - Заполните форму следующими значениями:
        -

        Имя переменной: MSVC16_ROOT
        Значение переменной: C:\MSVC15

        -
        7. -
      7. - Закройте окна, нажимая кнопки OK. -
        8. -
      -
      5. -
    -

    -
    -
    - -
    - Установка Windows SDK 7.1 -
    -

    - Для установки требуется платформа .NET Framework 4 (более новая, например .NET Framework 4.8, не годится!). Поскольку вместе с Windows 10 уже предустановлена более новая версия, установщик придётся обмануть: -

      -
    1. - Нажмите кнопку Пуск и найдите "regedit.exe". Запустите первое найденное. + Установите gzip и добавьте папку с "gzip.exe" в переменную Path.
    2. - Перейдите в ветвь "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\". + Установите UPX и добавьте папку с "upx.exe" в переменную Path.
    3. - Измените разрешения у папки "Client", чтобы можно было редактировать ключи:
      -
        -
      1. - Щёлкните правой кнопкой мыши по подпапке "Client" и выберите "Разрешения...". -
        2. -
      2. - Нажмите кнопку "Дополнительно".
        - -
        3. -
      3. - Измените владельца на своего пользователя и нажмите "Добавить".
        - -
        4. -
      4. - Укажите субъектом своего пользователя, включите опцию "Полный доступ" и нажмите OK.
        - -
        5. -
      5. - В папке "Client" запишите значение элемента "Version". -
        6. -
      6. - Дважды щёлкните мышью по элементу "Version" и измените значение на "4.0.30319".
        - -
        7. -
      + Установите Windows-порт dd и добавьте папку с "dd.exe" в переменную Path.
    4. - Измените разрешения у папки "Full", чтобы можно было редактировать ключи:
      -
        -
      1. - Щёлкните правой кнопкой мыши по подпапке "Full" и выберите "Разрешения...". -
        2. -
      2. - Нажмите кнопку "Дополнительно".
        - -
        3. -
      3. - Измените владельца на своего пользователя и нажмите "Добавить".
        - -
        4. -
      4. - Укажите субъектом своего пользователя, включите опцию "Полный доступ" и нажмите OK.
        - -
        5. -
      5. - В папке "Full" запишите значение элемента "Version". -
        6. -
      6. - Дважды щёлкните мышью по элементу "Version" и измените значение на "4.0.30319".
        - -
        7. -
      -
      5. -
    5. - Загрузите Windows SDK 7.1 отсюда:
      - https://www.microsoft.com/en-us/download/details.aspx?id=8279 -
      6. -
    6. - Запустите загруженный файл от имени администратора и установите приложение с настройками по умолчанию. -
      7. -
    7. - После установки отмените изменения, сделанные в редакторе реестра.
      - ПРИМЕЧАНИЕ: Владельца "TrustedInstaller" можно восстановить, выполнив поиск: "NT Service\TrustedInstaller". -
      8. -
    -

    -
    -
    - -
    - Установка Windows Driver Kit 7.1 -
    -

    -

      -
    1. - Загрузите ISO-файл Windows Diver Kit 7.1 отсюда:
      - https://www.microsoft.com/en-us/download/details.aspx?id=11800 -
      2. -
    2. - Смонтируйте загруженный файл ISO, дважды щёлкнув по нему. -
      3. -
    3. - Запустите файл "KitSetup.exe" от имени администратора. Выберите для установки все компоненты.
      - ПРИМЕЧАНИЕ: Возможно, во время установки вас попросят установить .NET Framework 3.5. В этом случае нажмите "Загрузить и установить". -
      4. -
    4. - Установите комплект драйверов в папку по умолчанию. -
      5. -
    -

    -
    -
    - -
    - Установка Windows 8.1 SDK -
    -

    -

      -
    1. - Загрузите ISO-файл Windows 8.1 SDK отсюда:
      - https://developer.microsoft.com/de-de/windows/downloads/sdk-archive/ -
      2. -
    2. - Запустите загруженный файл от имени администратора и установите Windows 8.1 SDK с настройками по умолчанию. -
      3. -
    3. - Создайте системную переменную для Windows 8.1 SDK.
      -
        -
      1. - Откройте Проводник. -
        2. -
      2. - В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
        - -
        3. -
      3. - В правой части окна щёлкните по "Дополнительные параметры системы".
        - -
        4. -
      4. - Нажмите кнопку "Переменные среды".
        - -
        5. -
      5. - В поле "Системные переменные" нажмите кнопку "Создать...".
        - -
        6. -
      6. - Заполните форму следующими значениями:
        -

        Имя переменной: WSDK81
        Значение переменной: C:\Program Files (x86)\Windows Kits\8.1\

        -
        7. -
      7. - Закройте окна, нажимая кнопки OK. -
        8. -
      -
      4. -
    -

    -
    -
    - -
    - Установка gzip -
    -

    -

      -
    1. - Создайте следующую папку:
      - C:\Program Files (x86)\gzip -
      2. -
    2. - Загрузите версию gzip отсюда:
      - https://sourceforge.net/projects/gnuwin32/files/gzip/1.3.12-1/gzip-1.3.12-1-bin.zip/download?use-mirror=netix&download= -
      3. -
    3. - Скопируйте содержимое загруженного zip-архива в папку "C:\Program Files (x86)\gzip". -
      4. -
    4. - Добавьте путь к папке с gzip в переменную PATH. Это сделает команду доступной отовсюду при вызове из командной строки.
      -
        -
      1. - Откройте Проводник. -
        2. -
      2. - В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
        - -
        3. -
      3. - В правой части окна щёлкните по "Дополнительные параметры системы".
        - -
        4. -
      4. - Нажмите кнопку "Переменные среды".
        - -
        5. -
      5. - В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
        - -
        6. -
      6. - Нажмите кнопку "Создать" и добавьте следующее значение:
        -

        C:\Program Files (x86)\gzip\bin

        -
        7. -
      7. - Закройте окна, нажимая кнопки OK. -
        8. -
      -
      5. -
    5. - Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:
      -

      gzip


      - -
      6. -
    -

    -
    -
    - -
    - Установка UPX -
    -

    -

      -
    1. - Создайте следующую папку:
      - C:\Program Files (x86)\upx -
      2. -
    2. - Загрузите новейшую версию файла upx-X.X.X-win64.zip отсюда:
      - https://github.com/upx/upx/releases/tag/v4.0.2 -
      3. -
    3. - Скопируйте содержимое загруженного zip-архива в папку "C:\Program Files (x86)\upx". -
      4. -
    4. - Добавьте путь к папке с gzip в системную переменную PATH. Это сделает команду доступной отовсюду при вызове из командной строки.
      -
        -
      1. - Откройте Проводник. -
        2. -
      2. - В левой панели щёлкните правой кнопкой мыши по "Этот компьютер" и выберите "Свойства".
        - -
        3. -
      3. - В правой части окна щёлкните по "Дополнительные параметры системы".
        - -
        4. -
      4. - Нажмите кнопку "Переменные среды".
        - -
        5. -
      5. - В поле "Системные переменные" выберите переменную "Path" и нажмите кнопку "Изменить...".
        - -
        6. -
      6. - Нажмите кнопку "Создать" и добавьте следующее значение:
        -

        C:\Program Files (x86)\upx

        -
        7. -
      7. - Закройте окна, нажимая кнопки OK. -
        8. -
      -
      5. -
    5. - Чтобы проверить, правильно ли работает конфигурация, откройте командную строку и посмотрите вывод следующей команды:
      -

      upx


      - -
      6. -
    -

    -
    -
    - -
    - Установка 7-Zip -
    -

    -

      -
    1. - Загрузите новейшую версию 7-Zip отсюда:
      - https://www.7-zip.org/ -
      2. -
    2. - Запустите загруженный файл от имени администратора и установите 7-Zip с настройками по умолчанию. + Откройте новую командную строку и убедитесь, что находятся следующие команды:
      +

      nasm
      gzip
      upx
      dd --help

    @@ -644,12 +273,12 @@
    - Установка WiX3 + Установка WiX Toolset v3.x

    1. - Загрузите файл "wix311.exe" отсюда:
      + Загрузите WiX Toolset v3.x отсюда:
      https://github.com/wixtoolset/wix3/releases
    2. @@ -660,234 +289,37 @@
    -
    - Установка Microsoft Visual Studio 2019 +
    + Установка Microsoft Visual Studio 2022

    1. - Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20Professional + Загрузите Visual Studio 2022 отсюда:
      + https://visualstudio.microsoft.com/vs/
    2. - Загрузите новейшую (пробную) версию "Visual Studio Professional 2019".
      - + Запустите загруженный установщик от имени администратора.
    3. - Запустите загруженный файл от имени администратора и следуйте указаниям мастера.
      - Выберите следующие Workloads для установки:
      + Выберите рабочую нагрузку "Desktop development with C++". +
      4. +
    4. + Выберите следующие отдельные компоненты:
        -
      1. - Desktop development with C++ -
        2. -
      2. - .NET desktop development -
        3. -
      - Выберите следующие отдельные компоненты для установки: -
        -
      1. - .NET -
          -
        1. - .NET 6.0 Runtime -
          2. -
        2. - .NET Core 3.1 Runtime (LTS) -
          3. -
        3. - .NET Framework 4 targeting pack -
          4. -
        4. - .NET Framework 4.5 targeting pack -
          5. -
        5. - .NET Framework 4.5.1 targeting pack -
          6. -
        6. - .NET Framework 4.5.2 targeting pack -
          7. -
        7. - .NET Framework 4.6 targeting pack -
          8. -
        8. - .NET Framework 4.6.1 targeting pack -
          9. -
        9. - .NET Framework 4.7.2 targeting pack -
          10. -
        10. - .NET Framework 4.8 SDK -
          11. -
        11. - .NET Framework 4.8 targeting pack -
          12. -
        12. - .NET SDK -
          13. -
        13. - ML.NET Model Builder (Preview) -
          14. -
        -
        2. -
      2. - Облако, база данных и сервер -
          -
        1. - CLR data types for SQL Server -
          2. -
        2. - Connectivity and publishing tools -
          3. -
        -
        3. -
      3. - Инструменты кода -
          -
        1. - NuGet package manager -
          2. -
        2. - Text Template Transformation -
          3. -
        -
        4. -
      4. - Компиляторы, инструменты сборки и среды выполнения -
          -
        1. - .NET Compiler Platform SDK -
          2. -
        2. - C# and Visual Basic Roslyn compilers -
          3. -
        3. - C++ 2019 Redistributable Update -
          4. -
        4. - C++ CMake tools for Windows -
          5. -
        5. - C++/CLI support for v142 build tools (Latest) -
          6. -
        6. - MSBuild -
          7. -
        7. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          8. -
        8. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          9. -
        9. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          10. -
        10. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          11. -
        -
        5. -
      5. - Отладка и тестирование -
          -
        1. - .NET profiling tools -
          2. -
        2. - C++ AddressSanatizer -
          3. -
        3. - C++ profiling tools -
          4. -
        4. - Just-In-Time debugger -
          5. -
        5. - Test Adapter for Boost.Test -
          6. -
        6. - Test Adapter for Google Test -
          7. -
        -
        6. -
      6. - Средства разработки -
          -
        1. - C# and Visual Basic -
          2. -
        2. - C++ core features -
          3. -
        3. - F# language support -
          4. -
        4. - IntelliCode -
          5. -
        5. - JavaScript and TypeScript language support -
          6. -
        6. - Live Share -
          7. -
        -
        7. -
      7. - Эмуляторы -
          - НЕТ -
        -
        8. -
      8. - Игры и графика -
          -
        1. - Graphics debugger and GPU profiler for DirectX -
          2. -
        -
        9. -
      9. - SDK, библиотеки и фреймворки -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        5. - C++ MFC for latest v142 build tools (ARM64) -
          6. -
        6. - C++ MFC for latest v142 build tools (x86 & x64) -
          7. -
        7. - C++ MFC for latest v142 build tools with Spectre Mitigations (ARM64) -
          8. -
        8. - C++ MFC for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          9. -
        9. - Entity Framework 6 tools -
          10. -
        10. - TypeScript 4.3 SDK -
          11. -
        11. - Windows 10 SDK (10.0.19041.0) -
          12. -
        12. - Windows Universal C Runtime -
          13. -
        -
        10. +
      10. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        12. +
      12. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        13. +
      13. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        14. +
      14. C++ ATL for latest v143 build tools (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools (ARM64)
        16. +
      16. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        17. +
      17. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools (ARM64)
        20. +
      20. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        21. +
      21. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        22. +
      22. Windows 10/11 SDK (10.0.19041.0 или новее)
    @@ -896,24 +328,25 @@
    - Установка Windows Driver Kit 2004 + Установка Windows Driver Kit

    1. - Загрузите Windows Driver Kit (WDK) 2004 отсюда:
      - https://docs.microsoft.com/en-us/windows-hardware/drivers/other-wdk-downloads + Загрузите Windows Driver Kit (WDK), совместимый с Visual Studio 2022, отсюда:
      + https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk
    2. Запустите загруженный файл от имени администратора и установите WDK с настройками по умолчанию.
    3. - В конце установки вас спросят, нужно ли установить расширение Windows Driver Kit Visual Studio.
      - Перед закрытием диалогового окна убедитесь, что эта опция включена. + Если Windows SDK и WDK устанавливаются отдельно, убедитесь, что их номера сборок совпадают.
    4. - Автоматически запустится другая установка и определит пакет Visual Studio Professional 2019 как цель для расширения.
      - Выберите его и продолжите установку. + Убедитесь, что установлено расширение WDK для Visual Studio. Если установщик WDK спрашивает, нужно ли установить расширение Windows Driver Kit Visual Studio, выберите эту опцию перед закрытием диалогового окна. В текущих установщиках Visual Studio 2022 его также можно установить через Individual Components, выбрав "Windows Driver Kit". +
      5. +
    5. + Если автоматически запустится отдельный установщик VSIX, он определит Visual Studio 2022 как возможную цель для расширения. Выберите её и продолжите установку.

    @@ -921,88 +354,34 @@
    - Установка средств сборки Visual Studio + Установка Build Tools for Visual Studio 2022

    + Если вы установили Visual Studio 2022 с перечисленными выше компонентами, этот шаг можно пропустить. Устанавливайте Build Tools только если нужна среда сборки из командной строки без полного IDE Visual Studio.

    1. - Посетите следующий сайт Microsoft и войдите в систему с помощью бесплатной учётной записи Microsoft:
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20build%20tools + Загрузите Build Tools for Visual Studio 2022 отсюда:
      + https://visualstudio.microsoft.com/downloads/
    2. - Загрузите новейшую версию "Build Tools for Visual Studio 2019".
      - + Запустите загруженный установщик от имени администратора и выберите рабочую нагрузку "C++ build tools".
    3. - Запустите загруженный файл от имени администратора и следуйте указаниям мастера. Выберите для установки следующие отдельные компоненты: + Выберите следующие отдельные компоненты:
        -
      1. - .NET -
          - НЕТ -
        -
        2. -
      2. - Облако, база данных и сервер -
          - НЕТ -
        -
        3. -
      3. - Инструменты кода -
          - НЕТ -
        -
        4. -
      4. - Компиляторы, инструменты сборки и среды выполнения -
          -
        1. - C++/CLI support for v142 build tools (Latest) -
          2. -
        2. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          3. -
        3. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          4. -
        4. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          5. -
        5. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          6. -
        -
        5. -
      5. - Отладка и тестирование -
          - НЕТ -
        -
        6. -
      6. - Средства разработки -
          - НЕТ -
        -
        7. -
      7. - SDK, библиотеки и фреймворки -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        -
        8. +
      8. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        9. +
      9. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        10. +
      10. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        12. +
      12. C++ ATL for latest v143 build tools (x86 & x64)
        13. +
      13. C++ ATL for latest v143 build tools (ARM64)
        14. +
      14. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        16. +
      16. C++ MFC for latest v143 build tools (x86 & x64)
        17. +
      17. C++ MFC for latest v143 build tools (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        20. +
      20. Windows 10/11 SDK (10.0.19041.0 или новее)
    @@ -1029,60 +408,60 @@
    - Компиляция Win32/x64-версий VeraCrypt + Компиляция x64-, ARM64- и драйверных сборок VeraCrypt

    1. - Откройте файл "src/VeraCrypt.sln" в Visual Studio 2010. + Откройте файл "src/VeraCrypt.sln" в Visual Studio 2022.
    2. - Выберите "All|Win32" как активную конфигурацию.
      - + Выберите "Release|x64" как активную конфигурацию.
    3. - Нажмите "Build -> Build Solution".
      - + Нажмите "Build -> Build Solution".
    4. Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Некоторые проекты следует пропустить.
    5. - Выберите "All|x64" как активную конфигурацию.
      - + Выберите "Release|ARM64" как активную конфигурацию.
    6. - Нажмите "Build -> Build Solution".
      - + Нажмите "Build -> Build Solution".
    7. - Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Некоторые проекты следует пропустить.
      - Закройте Visual Studio 2010 после завершения процесса компиляции. -
      8. -
    -

    -
    -
    - -
    - Компиляция ARM64-версии VeraCrypt -
    -

    -

      -
    1. - Откройте файл "src/VeraCrypt_vs2019.sln" в Visual Studio 2019. + Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Некоторые проекты следует пропустить.
    2. - Выберите "All|ARM64" как активную конфигурацию.
      - + Выберите "Release|Win32" как активную конфигурацию и соберите решение, чтобы скомпилировать Win32-проекты установщика и вспомогательные проекты, используемые скриптами выпуска.
    3. - Нажмите "Build -> Build Solution".
      - + Чтобы собрать драйверы VeraCrypt, выберите проект "Driver" и соберите его для "Release|x64" и "Release|ARM64".
    4. - Процесс компиляции должен завершиться с предупреждениями, но без ошибок. Один проект следует пропустить.
      - Закройте Visual Studio 2019 после завершения процесса компиляции. + Собирайте "ReleaseCustomEFI|x64" или "ReleaseCustomEFI|ARM64" только если нужны конфигурации выпуска с пользовательским EFI/загрузчиком. Эти конфигурации включают проект Boot и требуют необязательные инструменты устаревшего загрузчика BIOS, перечисленные выше. +
      5. +
    5. + Если вы используете Build Tools for Visual Studio 2022 вместо IDE Visual Studio, откройте "Developer Command Prompt for VS 2022" или "Developer PowerShell for VS 2022" от имени администратора, перейдите в корневой каталог исходного кода VeraCrypt и выполните эквивалентные команды MSBuild: +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=ARM64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=Win32
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=ARM64 +       +
      + Для сборки необязательных конфигураций выпуска с пользовательским EFI/загрузчиком также выполните: +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=ARM64 +       +
      6. +
    6. + Если сборка выполнялась из IDE, закройте Visual Studio 2022 после завершения процесса компиляции.

    @@ -1095,7 +474,7 @@

    1. - Откройте командную строку от имени администратора. + Откройте командную строку Visual Studio 2022 от имени администратора, чтобы средства подписи Windows SDK, включая "signtool.exe", были доступны через Path.
    2. Перейдите в папку "src/Signing/". @@ -1125,10 +504,10 @@
      • GlobalSign_R3Cross.cer
      • GlobalSign_SHA256_EV_CodeSigning_CA.cer
        • -
      • TestCertificates/idrix_codeSign.pfx
        • -
      • TestCertificates/idrix_Sha256CodeSign.pfx
        • -
      • TestCertificates/idrix_SHA256TestRootCA.crt
        • -
      • TestCertificates/idrix_TestRootCA.crt
        • +
      • TestCertificate/idrix_codeSign.pfx
        • +
      • TestCertificate/idrix_Sha256CodeSign.pfx
        • +
      • TestCertificate/idrix_SHA256TestRootCA.crt
        • +
      • TestCertificate/idrix_TestRootCA.crt
    diff --git a/doc/html/zh-cn/CompilingGuidelineWin.html b/doc/html/zh-cn/CompilingGuidelineWin.html index 78b47cc9..c634d239 100644 --- a/doc/html/zh-cn/CompilingGuidelineWin.html +++ b/doc/html/zh-cn/CompilingGuidelineWin.html @@ -60,29 +60,21 @@
    本指南介绍了如何设置一个能够编译VeraCrypt的Windows系统。此外，还描述了如何编译VeraCrypt。
    -这里以Windows 10系统为例进行说明，但其他Windows系统的操作过程类似。 +这里以Windows 10/11系统为例进行说明，但其他Windows系统的操作过程类似。
    -编译VeraCrypt需要以下组件： +编译当前VeraCrypt Windows二进制文件和驱动程序需要以下组件；可选替代项或仅发布时需要的工具会另行标明：
      -
    1. Microsoft Visual Studio 2010（微软Visual Studio 2010）
      2. -
    2. Microsoft Visual Studio 2010 Service Pack 1（微软Visual Studio 2010服务包1）
      3. +
    3. Microsoft Visual Studio 2022，或作为命令行替代方案的Build Tools for Visual Studio 2022
      4. +
    4. MSVC v143 C++工具集，包含x86/x64和ARM64组件
      5. +
    5. Windows 10/11 SDK（10.0.19041.0或更高版本），包括签名脚本所需的signtool.exe。如果SDK和WDK分开安装，请使用匹配的内部版本号。
      6. +
    6. 适用于Windows 10/11并带有Visual Studio 2022扩展的Windows Driver Kit
    7. NASM
    8. YASM
      9. -
    9. Visual C++ 1.52
      10. -
    10. Windows SDK 7.1（Windows软件开发工具包7.1）
      11. -
    11. Windows Driver Kit 7.1（Windows驱动程序开发工具包7.1）
      12. -
    12. Windows 8.1 SDK（Windows 8.1软件开发工具包）
      13. -
    13. gzip
      14. -
    14. upx
      15. -
    15. 7zip
      16. -
    16. Wix3
      17. -
    17. Microsoft Visual Studio 2019（微软Visual Studio 2019）
      18. -
    18. Windows 10 SDK（Windows 10软件开发工具包）
      19. -
    19. Windows Driver Kit 1903（Windows驱动程序开发工具包1903）
      20. -
    20. Visual Studio构建工具
      21. +
    21. WiX Toolset v3.x（生成MSI包时需要）
      22. +
    22. 旧版BIOS引导加载程序工具（可选；仅在重新构建Boot项目时需要）：Microsoft Visual C++ 1.52、gzip、UPX和dd.exe
    @@ -91,24 +83,15 @@
    以下是操作步骤。点击任何链接可直接跳转到相关步骤：
    -
    - 安装Microsoft Visual Studio 2010 -
    -

    -

      -
    1. - 访问以下微软网站，使用免费的微软账户登录：
      - https://my.visualstudio.com/Downloads?q=Visual%20Studio%202010%20Professional&pgroup= -
      2. -
    2. - 请下载“Visual Studio Professional 2010”的（试用）版本
      - -
      3. -
    3. - 双击下载的ISO文件进行挂载 -
      4. -
    4. - 以管理员身份运行“autorun.exe”文件 -
      5. -
    5. - 使用默认设置安装Microsoft Visual Studio 2010 -
      6. -
    - Microsoft SQL Server 2008 Express Service Pack 1 (x64)的安装可能会失败，但这对于编译VeraCrypt不是必需的。 -

    -
    -
    - -
    - 安装Microsoft Visual Studio 2010 Service Pack 1 -
    -

    - 注意：微软官方安装程序试图下载的内容已不再可用。因此，需要使用离线安装程序。 -

      -
    1. - 访问互联网档案馆的网站，下载Microsoft Visual Studio 2010 Service Pack 1的ISO镜像：
      - https://archive.org/details/vs-2010-sp-1dvd-1 -
      2. -
    2. - 双击下载的ISO文件进行挂载 -
      3. -
    3. - 以管理员身份运行“Setup.exe”文件 -
      4. -
    4. - 使用默认设置安装Microsoft Visual Studio 2010 Service Pack 1 -
      5. -
    -

    -
    -
    -
    安装NASM
    @@ -234,7 +165,7 @@ C:\Program Files\YASM
  • - 请在以下链接下载“Win64 VS2010 .zip”文件：
    + 请在以下链接下载预构建的Win64 YASM zip压缩包：
    https://yasm.tortall.net/Download.html
  • @@ -307,336 +238,34 @@
    • -
    - Microsoft Visual C++ 1.52的安装 +
    + 安装旧版BIOS引导加载程序工具（可选）

    + 使用Visual Studio 2022和当前WDK编译标准VeraCrypt应用程序二进制文件或Windows驱动程序不需要这些工具。仅当你需要重新构建“src\Boot\Windows”中的旧版BIOS引导加载程序，或者构建包含Boot项目的解决方案配置（例如“ReleaseCustomEFI”）时才安装它们。

    1. - 可以通过付费的Microsoft MSDN订阅获取Visual C++ 1.52。如果您没有订阅，可以通过互联网档案馆下载ISO镜像：
      + 安装Microsoft Visual C++ 1.52。它可通过付费的Microsoft MSDN订阅获取。如果你没有订阅，也可以从互联网档案馆获取ISO镜像：
      https://archive.org/details/ms-vc152
    2. - 创建文件夹“C:\MSVC15” + 创建文件夹“C:\MSVC15”。挂载ISO文件并将“MSVC”文件夹的内容复制到“C:\MSVC15”。
    3. - 挂载ISO文件并将“MSVC”文件夹的内容复制到“C:\MSVC15” + 创建名为“MSVC16_ROOT”的系统变量，其值为“C:\MSVC15”。
    4. - 为Microsoft Visual C++ 1.52创建一个系统变量
      -
        -
      1. - 打开文件资源管理器 -
        2. -
      2. - 在左侧文件树中，右键单击“此电脑”并选择“属性”
        - -
        3. -
      3. - 在右侧菜单中，请点击“高级系统设置”
        - -
        4. -
      4. - 请点击“环境变量”
        - -
        5. -
      5. - 在系统变量区域内，请点击“新建...”
        - -
        6. -
      6. - 使用以下值填写表单：
        -

        变量名：MSVC16_ROOT
        变量值：C:\MSVC15

        -
        7. -
      7. - 点击“确定”关闭窗口 -
        8. -
      -
      5. -
    -

    -
    -
    - -
    - Windows SDK 7.1的安装 -
    -

    - 安装程序需要 .Net Framework 4（不是像 .Net Framework 4.8 这样的较新版本！）。由于Windows 10已经预装了较新版本，因此必须欺骗安装程序： -

      -
    1. - 点击开始按钮并搜索：“regedit.msc”。启动第一个搜索结果。 + 安装gzip，并将包含“gzip.exe”的文件夹添加到Path变量。
    2. - 导航到“HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\” + 安装UPX，并将包含“upx.exe”的文件夹添加到Path变量。
    3. - 更改“Client”文件夹的权限，以便您可以编辑键：
      -
        -
      1. - 右键单击子文件夹“Client”并选择“权限...” -
        2. -
      2. - 点击“高级”
        - -
        3. -
      3. - 将所有者更改为您的用户并点击“添加”
        - -
        4. -
      4. - 将主体设置为您的用户，选择“完全控制”并点击“确定”
        - -
        5. -
      5. - 在“Client”文件夹中记录“Version”条目的值 -
        6. -
      6. - 双击“Version”条目并将值更改为“4.0.30319”
        - -
        7. -
      + 安装Windows版本的dd，并将包含“dd.exe”的文件夹添加到Path变量。
    4. - 更改“Full”文件夹的权限，以便您可以编辑密钥：
      -
        -
      1. - 右键单击子文件夹“Full”，然后选择“权限...” -
        2. -
      2. - 点击“高级”
        - -
        3. -
      3. - 将所有者更改为您的用户，然后点击“添加”
        - -
        4. -
      4. - 将主体设置为您的用户，选择“完全控制”，然后点击“确定”
        - -
        5. -
      5. - 在“Full”文件夹中，记下“Version”条目的值。 -
        6. -
      6. - 双击“Version”条目，并将值更改为“4.0.30319”
        - -
        7. -
      -
      5. -
    5. - 从以下链接下载 Windows SDK 7.1：
      - https://www.microsoft.com/en-us/download/details.aspx?id=8279 -
      6. -
    6. - 以管理员身份运行下载的文件，并使用默认设置安装应用程序。 -
      7. -
    7. - 安装完成后，还原在注册表编辑器中所做的更改。
      - 注意： 可以通过搜索“NT Service\TrustedInstaller”来恢复所有者“TrustedInstaller”。 -
      8. -
    -

    -
    -
    - -
    - 安装 Windows 驱动工具包 7.1 -
    -

    -

      -
    1. - 请从以下链接下载 Windows 驱动工具包 7.1 的 ISO 文件：
      - https://www.microsoft.com/en-us/download/details.aspx?id=11800 -
      2. -
    2. - 双击下载的 ISO 文件进行挂载。 -
      3. -
    3. - 以管理员身份运行“KitSetup.exe”文件。在安装过程中，选择安装所有功能。
      - 注意： 安装过程中可能会提示您安装 .NET Framework 3.5。在这种情况下，请点击“下载并安装此功能”。 -
      4. -
    4. - 将驱动工具包安装到默认位置。 -
      5. -
    -

    -
    -
    - -
    - 安装 Windows 8.1 SDK -
    -

    -

      -
    1. - 请从以下链接下载 Windows 8.1 SDK 的 ISO 文件：
      - https://developer.microsoft.com/de-de/windows/downloads/sdk-archive/ -
      2. -
    2. - 以管理员身份运行下载的文件，并使用默认设置安装 Windows 8.1 SDK。 -
      3. -
    3. - 为 Windows 8.1 SDK 创建一个系统变量
      -
        -
      1. - 打开文件资源管理器。 -
        2. -
      2. - 在左侧文件树中，右键单击“此电脑”，然后选择“属性”
        - -
        3. -
      3. - 在右侧菜单中，点击“高级系统设置”
        - -
        4. -
      4. - 点击“环境变量”
        - -
        5. -
      5. - 在系统变量区域，点击“新建...”
        - -
        6. -
      6. - 使用以下值填写表单：
        -

        变量名：WSDK81
        变量值：C:\Program Files (x86)\Windows Kits\8.1\

        -
        7. -
      7. - 点击“确定”关闭窗口。 -
        8. -
      -
      4. -
    -

    -
    -
    - -
    - 安装 gzip -
    -

    -

      -
    1. - 请创建以下文件夹：
      - C:\Program Files (x86)\gzip -
      2. -
    2. - 请从以下链接下载 gzip 版本：
      - https://sourceforge.net/projects/gnuwin32/files/gzip/1.3.12-1/gzip-1.3.12-1-bin.zip/download?use-mirror=netix&download= -
      3. -
    3. - 将下载的 ZIP 文件内容复制到“C:\Program Files (x86)\gzip”。 -
      4. -
    4. - 将 gzip 添加到路径变量中。这样可以使该命令在命令行中全局可用。
      -
        -
      1. - 打开文件资源管理器。 -
        2. -
      2. - 在左侧文件树中，右键单击“此电脑”，然后选择“属性”
        - -
        3. -
      3. - 在右侧菜单中，点击“高级系统设置”
        - -
        4. -
      4. - 点击“环境变量”
        - -
        5. -
      5. - 在系统变量区域，选择“Path”变量，然后点击“编辑...”
        - -
        6. -
      6. - 点击“新建”，并添加以下值：
        -

        C:\Program Files (x86)\gzip\bin

        -
        7. -
      7. - 点击“确定”关闭窗口。 -
        8. -
      -
      5. -
    5. - 要检查配置是否正常工作，请打开命令提示符，并查看以下命令的输出：
      -

      gzip


      - -
      6. -
    -

    -
    -
    - -
    - 安装 upx -
    -

    -

      -
    1. - 请创建以下文件夹：
      - C:\Program Files (x86)\upx -
      2. -
    2. - 请从以下链接下载最新的 upx-X-XX-win64.zip 版本：
      - https://github.com/upx/upx/releases/tag/v3.96 -
      3. -
    3. - 将下载的 ZIP 文件内容复制到“C:\Program Files (x86)\upx”。 -
      4. -
    4. - 将 gzip 添加到路径变量中。这样可以使该命令在命令行中全局可用。
      -
        -
      1. - 打开文件资源管理器。 -
        2. -
      2. - 在左侧文件树中，右键单击“此电脑”，然后选择“属性”
        - -
        3. -
      3. - 在右侧菜单中，请点击“高级系统设置”
        - -
        4. -
      4. - 请点击“环境变量”
        - -
        5. -
      5. - 在系统变量区域内，请选择“Path”变量并点击“编辑...”
        - -
        6. -
      6. - 点击“新建”并添加以下值：
        -

        C:\Program Files (x86)\upx

        -
        7. -
      7. - 点击“确定”关闭窗口 -
        8. -
      -
      5. -
    5. - 要检查配置是否正常工作，请打开命令提示符并查看以下命令的输出：
      -

      upx


      - -
      6. -
    -

    -
    -
    - -
    - 7-Zip 的安装 -
    -

    -

      -
    1. - 请从以下链接下载最新版本的 7-Zip：
      - https://www.7-zip.de/ -
      2. -
    2. - 以管理员身份运行下载的文件，并使用默认设置安装 7-Zip + 打开新的命令提示符，并确认能够找到以下命令：
      +

      nasm
      gzip
      upx
      dd --help

    @@ -644,12 +273,12 @@
    - WiX 3 的安装 + 安装WiX Toolset v3.x

    1. - 请从以下链接下载 wix311.exe：
      + 请从以下链接下载WiX Toolset v3.x：
      https://github.com/wixtoolset/wix3/releases
    2. @@ -660,234 +289,37 @@
    -
    - Microsoft Visual Studio 2019 的安装 +
    + 安装Microsoft Visual Studio 2022

    1. - 访问以下 Microsoft 网站，并用免费的 Microsoft 账户登录：
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20Professional + 在以下链接下载Visual Studio 2022：
      + https://visualstudio.microsoft.com/vs/
    2. - 请下载最新的（试用版）“Visual Studio Professional 2019”
      - + 以管理员身份运行下载的安装程序。
    3. - 以管理员身份运行下载的文件，并完成安装向导。
      - 选择以下工作负载进行安装：
      + 选择“Desktop development with C++”工作负载。 +
      4. +
    4. + 选择以下单个组件：
        -
      1. - Desktop development with C++ -
        2. -
      2. - .NET desktop development -
        3. -
      - 选择以下单个组件进行安装： -
        -
      1. - .NET -
          -
        1. - .NET 6.0 Runtime -
          2. -
        2. - .NET Core 3.1 Runtime (LTS) -
          3. -
        3. - .NET Framework 4 targeting pack -
          4. -
        4. - .NET Framework 4.5 targeting pack -
          5. -
        5. - .NET Framework 4.5.1 targeting pack -
          6. -
        6. - .NET Framework 4.5.2 targeting pack -
          7. -
        7. - .NET Framework 4.6 targeting pack -
          8. -
        8. - .NET Framework 4.6.1 targeting pack -
          9. -
        9. - .NET Framework 4.7.2 targeting pack -
          10. -
        10. - .NET Framework 4.8 SDK -
          11. -
        11. - .NET Framework 4.8 targeting pack -
          12. -
        12. - .NET SDK -
          13. -
        13. - ML.NET Model Builder (Preview) -
          14. -
        -
        2. -
      2. - 云、数据库和服务器 -
          -
        1. - CLR data types for SQL Server -
          2. -
        2. - 连接和发布工具 -
          3. -
        -
        3. -
      3. - 代码工具 -
          -
        1. - NuGet package manager -
          2. -
        2. - Text Template Transformation -
          3. -
        -
        4. -
      4. - 编译器、构建工具和运行时 -
          -
        1. - .NET Compiler Platform SDK -
          2. -
        2. - C# and Visual Basic Roslyn compilers -
          3. -
        3. - C++ 2019 Redistributable Update -
          4. -
        4. - C++ CMake tools for Windows -
          5. -
        5. - C++/CLI support for v142 build tools (Latest) -
          6. -
        6. - MSBuild -
          7. -
        7. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          8. -
        8. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          9. -
        9. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          10. -
        10. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          11. -
        -
        5. -
      5. - 调试和测试 -
          -
        1. - .NET profiling tools -
          2. -
        2. - C++ AddressSanatizer -
          3. -
        3. - C++ profiling tools -
          4. -
        4. - Just-In-Time debugger -
          5. -
        5. - Test Adapter for Boost.Test -
          6. -
        6. - Test Adapter for Google Test -
          7. -
        -
        6. -
      6. - 开发活动 -
          -
        1. - C# and Visual Basic -
          2. -
        2. - C++ core features -
          3. -
        3. - F# language support -
          4. -
        4. - 智能代码助手（IntelliCode） -
          5. -
        5. - JavaScript 和 TypeScript 语言支持 -
          6. -
        6. - 实时共享（Live Share） -
          7. -
        -
        7. -
      7. - 模拟器 -
          - 无 -
        -
        8. -
      8. - 游戏与图形 -
          -
        1. - DirectX 图形调试器和 GPU 性能分析器 -
          2. -
        -
        9. -
      9. - 软件开发工具包（SDK）、库和框架 -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        5. - C++ MFC for latest v142 build tools (ARM64) -
          6. -
        6. - C++ MFC for latest v142 build tools (x86 & x64) -
          7. -
        7. - C++ MFC for latest v142 build tools with Spectre Mitigations (ARM64) -
          8. -
        8. - C++ MFC for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          9. -
        9. - Entity Framework 6 tools -
          10. -
        10. - TypeScript 4.3 SDK -
          11. -
        11. - Windows 10 SDK (10.0.19041.0) -
          12. -
        12. - Windows Universal C Runtime -
          13. -
        -
        10. +
      10. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        12. +
      12. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        13. +
      13. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        14. +
      14. C++ ATL for latest v143 build tools (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools (ARM64)
        16. +
      16. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        17. +
      17. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools (ARM64)
        20. +
      20. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        21. +
      21. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        22. +
      22. Windows 10/11 SDK (10.0.19041.0或更高版本)
    @@ -896,24 +328,25 @@
    - Windows 驱动程序工具包 2004 版本的安装 + 安装Windows Driver Kit

    1. - 请在以下链接下载 Windows 驱动程序工具包（WDK）2004 版本：
      - https://docs.microsoft.com/en-us/windows-hardware/drivers/other-wdk-downloads + 请在以下链接下载与Visual Studio 2022兼容的Windows Driver Kit（WDK）：
      + https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk
    2. 以管理员身份运行下载的文件，并使用默认设置安装 WDK。
    3. - 安装结束时，系统会询问您是否要“安装 Windows 驱动程序工具包 Visual Studio 扩展”。
      - 请确保在关闭对话框之前选择此选项。 + 如果Windows SDK和WDK分开安装，请确保它们的内部版本号匹配。
    4. - 另一个安装程序将自动启动，并会检测到 Visual Studio Professional 2019 作为该扩展的可能目标。
      - 请选择它并继续进行安装。 + 确保已安装WDK Visual Studio扩展。如果WDK安装程序询问是否要“安装 Windows 驱动程序工具包 Visual Studio 扩展”，请在关闭对话框前选择此选项。在当前的Visual Studio 2022安装程序中，也可以在“单个组件”里选择“Windows Driver Kit”进行安装。 +
      5. +
    5. + 如果单独的VSIX安装程序自动启动，它会检测到Visual Studio 2022作为该扩展的可能目标。请选择它并继续安装。

    @@ -921,88 +354,34 @@
    - Visual Studio 构建工具的安装 + 安装Build Tools for Visual Studio 2022

    + 如果已安装上面列出的Visual Studio 2022组件，则可以跳过此步骤。仅在需要不带完整Visual Studio IDE的命令行构建环境时安装Build Tools。

    1. - 访问以下 Microsoft 网站，并用免费的 Microsoft 账户登录：
      - https://my.visualstudio.com/Downloads?q=visual%20studio%202019%20build%20tools + 在以下链接下载Build Tools for Visual Studio 2022：
      + https://visualstudio.microsoft.com/downloads/
    2. - 请下载最新版本的“Visual Studio 2019 构建工具”
      - + 以管理员身份运行下载的安装程序，并选择“C++ build tools”工作负载。
    3. - 以管理员身份运行下载的文件，并通过向导进行安装。选择以下单个组件进行安装： + 选择以下单个组件：
        -
      1. - .NET -
          - 无 -
        -
        2. -
      2. - 云、数据库和服务器 -
          - 无 -
        -
        3. -
      3. - 代码工具 -
          - 无 -
        -
        4. -
      4. - 编译器、构建工具和运行时 -
          -
        1. - C++/CLI support for v142 build tools (Latest) -
          2. -
        2. - MSVC v142 - VS 2019 C++ ARM64 build tools (Latest) -
          3. -
        3. - MSVC v142 - VS 2019 C++ ARM64 Spectre-mitigated libs (Latest) -
          4. -
        4. - MSVC v142 - VS 2019 C++ x64/x86 build tools (Latest) -
          5. -
        5. - MSVC v142 - VS 2019 C++ x64/x86 Spectre-mitigated libs (Latest) -
          6. -
        -
        5. -
      5. - 调试和测试 -
          - 无 -
        -
        6. -
      6. - 开发活动 -
          - 无 -
        -
        7. -
      7. - 软件开发工具包（SDK）、库和框架 -
          -
        1. - C++ ATL for latest v142 build tools (ARM64) -
          2. -
        2. - C++ ATL for latest v142 build tools (x86 & x64) -
          3. -
        3. - C++ ATL for latest v142 build tools with Spectre Mitigations (ARM64) -
          4. -
        4. - C++ ATL for latest v142 build tools with Spectre Mitigations (x86 & x64) -
          5. -
        -
        8. +
      8. MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
        9. +
      9. MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)
        10. +
      10. MSVC v143 - VS 2022 C++ ARM64 build tools (Latest)
        11. +
      11. MSVC v143 - VS 2022 C++ ARM64 Spectre-mitigated libs (Latest)
        12. +
      12. C++ ATL for latest v143 build tools (x86 & x64)
        13. +
      13. C++ ATL for latest v143 build tools (ARM64)
        14. +
      14. C++ ATL for latest v143 build tools with Spectre Mitigations (x86 & x64)
        15. +
      15. C++ ATL for latest v143 build tools with Spectre Mitigations (ARM64)
        16. +
      16. C++ MFC for latest v143 build tools (x86 & x64)
        17. +
      17. C++ MFC for latest v143 build tools (ARM64)
        18. +
      18. C++ MFC for latest v143 build tools with Spectre Mitigations (x86 & x64)
        19. +
      19. C++ MFC for latest v143 build tools with Spectre Mitigations (ARM64)
        20. +
      20. Windows 10/11 SDK (10.0.19041.0或更高版本)
    @@ -1029,60 +408,60 @@
    - 编译VeraCrypt的Win32/x64版本 + 编译VeraCrypt的x64、ARM64和驱动程序版本

    1. - 在Visual Studio 2010中打开文件“src/VeraCrypt.sln” + 在Visual Studio 2022中打开文件“src/VeraCrypt.sln”
    2. - 选择“All|Win32”作为活动配置
      - + 选择“Release|x64”作为活动配置。
    3. - 点击“Build -> Build Solution”
      - + 点击“Build -> Build Solution”。
    4. 编译过程应仅出现警告，而无错误。部分项目可能会被跳过。
    5. - 选择“All|x64”作为活动配置
      - + 选择“Release|ARM64”作为活动配置。
    6. - 点击“Build -> Build Solution”
      - + 点击“Build -> Build Solution”。
    7. - 编译过程应仅出现警告，而无错误。部分项目可能会被跳过。
      - 编译完成后，请关闭Visual Studio 2010 -
      8. -
    -

    -
    -
    - -
    - 编译VeraCrypt的ARM64版本 -
    -

    -

      -
    1. - 在Visual Studio 2019中打开文件“src/VeraCrypt_vs2019.sln” + 编译过程应仅出现警告，而无错误。部分项目可能会被跳过。
    2. - 选择“All|ARM64”作为活动配置
      - + 选择“Release|Win32”作为活动配置并构建解决方案，以编译发布打包脚本使用的Win32安装程序/辅助项目。
    3. - 点击“Build -> Build Solution”
      - + 要构建VeraCrypt驱动程序，请选择“Driver”项目，并分别为“Release|x64”和“Release|ARM64”构建它。
    4. - 编译过程应仅出现警告，而无错误。有一个项目可能会被跳过。
      - 编译完成后，请关闭Visual Studio 2019 + 仅当需要自定义EFI/引导加载程序发布配置时，才构建“ReleaseCustomEFI|x64”或“ReleaseCustomEFI|ARM64”。这些配置包含Boot项目，并需要上面列出的可选旧版BIOS引导加载程序工具。 +
      5. +
    5. + 如果使用Build Tools for Visual Studio 2022而不是Visual Studio IDE，请以管理员身份打开“Developer Command Prompt for VS 2022”或“Developer PowerShell for VS 2022”，切换到VeraCrypt源代码根目录，并运行等效的MSBuild命令： +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=ARM64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=Release /p:Platform=Win32
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=x64
      + msbuild src\Driver\Driver.vcxproj /m /p:Configuration=Release /p:Platform=ARM64 +       +
      + 要构建可选的自定义EFI/引导加载程序发布配置，还请运行： +
      + + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=x64
      + msbuild src\VeraCrypt.sln /m /p:Configuration=ReleaseCustomEFI /p:Platform=ARM64 +       +
      6. +
    6. + 如果是从IDE构建的，请在编译完成后关闭Visual Studio 2022。

    @@ -1095,7 +474,7 @@

    1. - 以管理员身份打开命令行 + 以管理员身份打开Visual Studio 2022命令行，以确保Windows SDK签名工具（包括“signtool.exe”）在Path中可用
    2. 进入“src/Signing/”文件夹 @@ -1125,10 +504,10 @@
      • GlobalSign_R3Cross.cer
      • GlobalSign_SHA256_EV_CodeSigning_CA.cer
        • -
      • TestCertificates/idrix_codeSign.pfx
        • -
      • TestCertificates/idrix_Sha256CodeSign.pfx
        • -
      • TestCertificates/idrix_SHA256TestRootCA.crt
        • -
      • TestCertificates/idrix_TestRootCA.crt
        • +
      • TestCertificate/idrix_codeSign.pfx
        • +
      • TestCertificate/idrix_Sha256CodeSign.pfx
        • +
      • TestCertificate/idrix_SHA256TestRootCA.crt
        • +
      • TestCertificate/idrix_TestRootCA.crt
      注意：如果提示输入密码，.pfx证书的密码为 idrix。