Skip to content

Commit f4409a4

Browse files
Bart RoossienDevGeniusCode
authored andcommitted
Updating build instructions for VCPKG (#43)
1 parent 0dfd388 commit f4409a4

File tree

1 file changed

+40
-4
lines changed

1 file changed

+40
-4
lines changed

SourceCode/Builds/build_with_msvc22.md

Lines changed: 40 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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

1617
1. **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

Comments
 (0)