@@ -9,13 +9,15 @@ For build using solutions and more advanced build configurations, see below.
99- [ Build through CMake target view] ( #build-through-cmake-target-view )
1010- [ Build using command line] ( #build-using-command-line )
1111- [ Build using solutions] ( #build-with-solutions )
12+ - [ Build with VCPKG] ( #build-with-vcpkg )
1213- [ Troubleshooting] ( #troubleshooting )
1314
1415## Prerequisites
1516
16171 . ** Visual Studio 2022**
1718
1819- Ensure that the necessary C++ development components, ** including MFC** , are installed.
20+ - For _ vcpkg_ builds, you also must have ** vcpkg** installed, which you can find under individual components.
1921
2022> [ !NOTE]
2123> You must have the MFC components installed to compile the source code. You can find it in Visual Studio Installer.
@@ -39,10 +41,14 @@ For build using solutions and more advanced build configurations, see below.
3941### 2. Build the Project
4042
4143- Select the appropriate build configuration:
42- - ` Build Windows build ` for a release build.
43- - ` Build Windows Debug build ` for a debug build.
44- - ` Build Windows Internal build ` for an internal build.
45- - ` Build Windows Profile build ` for a profile build.
44+ - ` Build Windows 32bit build ` for a release build.
45+ - ` Build Windows 32bit Debug build ` for a debug build.
46+ - ` Build Windows 32bit Internal build ` for an internal build.
47+ - ` Build Windows 32bit Profile build ` for a profile build.
48+ - ` Build Windows 32bit VCPKG build ` for a release build with the VCPKG package manager.
49+ - ` Build Windows 32bit VCPKG Debug build ` for a debug build with the VCPKG package manager.
50+ - ` Build Windows 32bit VCPKG Internal build ` for an internal build with the VCPKG package manager.
51+ - ` Build Windows 32bit VCPKG Profile build ` for a profile build with the VCPKG package manager.
4652
4753![ image] ( https://github.com/user-attachments/assets/2bc0aa26-3342-4aac-ae5b-6cf91db21214 )
4854
@@ -126,6 +132,36 @@ For more CMake options, see the [CMake Guide](cmake_guide).
126132
127133---
128134
135+ ## Build with VCPKG
136+
137+ To build configurations that make use of VCPKG you must set the environment variable ` VCPKG_ROOT ` to the location
138+ where the VCPKG is found. If you have installed Visual Studio 2022 with the VCPKG component, you will most likely
139+ find it in one of these paths:
140+
141+ - ` C:\Program Files\Microsoft Visual Studio\2022\Community\VC\vcpkg `
142+ - ` C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\vcpkg `
143+ - ` C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\vcpkg `
144+
145+ If you use the stand-alone version of VCPKG, you need to use the folder you installed it in.
146+
147+ ### Set environment variable in command prompt
148+
149+ You can set the environment variable in the command prompt. You will have to set it again if you (re)open the prompt:
150+
151+ - ` set VCPKG_ROOT=<path_to_vcpkg> `
152+
153+ ### Set environment variable in Windows
154+
155+ You can also permanently set the environment variable in Windows
156+
157+ - Search for ` edit the system environment variables ` in Windows Search or Control Panel
158+ - Choose ` Environment Variables `
159+ - Add a new user variable
160+ - Set the variable name to ` VCPKG_ROOT `
161+ - Set the variable value to the VCPKG path.
162+
163+ ---
164+
129165## Troubleshooting
130166
131167- ** Missing DLLs?** Ensure that all required dependencies are installed.
0 commit comments