Name |
Type |
Default |
Info |
|---|---|---|---|
VCPKG_ROOT |
PATH |
Git repo root folder - must contain an empty file named |
This environment variable can be set to a directory to use as the root of the vcpkg instance. This will only be used if the vcpkg executable is not located within a valid root and the command line switch |
VCPKG_BINARY_SOURCES |
STRING |
|
This environment variable adds or removes binary sources. See Binary Caching for more details. |
VCPKG_DEFAULT_BINARY_CACHE |
PATH |
|
This environment variable redirects the default location to store binary packages. |
VCPKG_DOWNLOADS |
PATH |
|
This environment variable can be set to an existing directory to use for storing downloads instead of the internal |
VCPKG_INSTALLED_DIR |
PATH |
|
The directory which contains the installed libraries for each triplet. |
VCPKG_OVERLAY_PORTS |
PATH |
|
Overlay ports to use for vcpkg install in manifest mode. |
VCPKG_OVERLAY_TRIPLETS |
PATH |
|
Overlay triplets to use for vcpkg install in manifest mode. |
VCPKG_VERBOSE |
BOOL |
|
Enables messages from the VCPKG toolchain for debugging purposes. |
VCPKG_USE_HOST_TOOLS |
BOOL |
|
Setup |
VCPKG_SETUP_CMAKE_PROGRAM_PATH |
BOOL |
|
Enable the setup of |
VCPKG_PREFER_SYSTEM_LIBS |
BOOL |
|
Appends the vcpkg paths to Deprecated!! Use empty overlay ports instead... |
VCPKG_FORCE_SYSTEM_BINARIES |
BOOL |
This environment variable, if set, suppresses the downloading of CMake and Ninja and forces the use of the system binaries. |
|
VCPKG_FORCE_DOWNLOADED_BINARIES |
BOOL |
This environment variable, if set, ignores the use of the system binaries and will always download and use the version defined by vcpkg. |
|
VCPKG_LIBRARY_LINKAGE |
STRING |
|
Specifies the preferred library linkage. Valid options are |
VCPKG_CRT_LINKAGE |
STRING |
|
Specifies the desired CRT linkage (for MSVC). Valid options are |
VCPKG_BUILD_TYPE |
STRING |
|
You can set this value to |
VCPKG_CMAKE_SYSTEM_NAME |
STRING |
|
Specifies the target platform. Valid options include any CMake system name, such as:
|
VCPKG_CMAKE_SYSTEM_VERSION |
STRING |
|
Specifies the target platform system version. This field is optional and, if present, will be passed in as |
VCPKG_HOST_TRIPLET |
STRING |
This variable controls which triplet host dependencies will be installed for. If unset, vcpkg will automatically detect an appropriate native triplet ( See also Host dependencies. |
|
VCPKG_TARGET_TRIPLET |
STRING |
This setting controls the triplet vcpkg will install and consume libraries from. If unset, vcpkg will automatically detect an appropriate default triplet given the current compiler settings. If you change this CMake variable, you must delete your cache and reconfigure. |
|
VCPKG_TARGET_ARCHITECTURE |
STRING |
Specifies the target machine architecture. Valid options are |
|
PORT |
STRING |
The name of the port that is currently being built. |
|
VERSION |
STRING |
The version of the port that is currently being built. |
|
HOST_TRIPLET |
STRING |
The name of the triplet that matches the building system. |
|
TARGET_TRIPLET |
STRING |
The name of the triplet being built for. |
|
CURRENT_HOST_INSTALLED_DIR |
STRING |
The absolute path to the installed files for the host triplet. |
|
CURRENT_INSTALLED_DIR |
STRING |
The absolute path to the installed files for the target triplet. |
|
EDITOR |
ENV |
This environment variable can be set to the full path of an executable to be used for |
|
AR |
ENV |
|
Default archive compiler filepath and flags. |
CC |
ENV |
|
Default C compiler filepath and flags. |
CXX |
ENV |
|
Default C++ compiler filepath and flags. |
LD |
ENV |
|
Default object linker filepath and flags. |
RC |
ENV |
|
Default resource compiler filepath and flags. |
CFLAGS |
ENV |
||
CXXFLAGS |
ENV |
||
LDFLAGS |
ENV |
||
PKG_CONFIG_PATH |
|||
VSLANG |
This environment variable sets the language vcpkg uses to display messages. It should be set to one of the 14 supported LCIDs (locale identifier, 4-byte value corresponding to a language). For example: 1033 corresponds to the English (US) language. For a full list of supported LCIDs see Localization. |
||
BUILD_BENCHMARKING |
|||
BUILD_FUZZING_TESTS |
|||
BUILD_SHARED_LIBS |
|||
BUILD_TESTS |
|||
PEDANTIC |
Enable extra warnings and expensive tests. |
||
VERBOSE |
|||
WERROR |
Halt the compilation with an error on compiler warnings. |
||
USE_FOLDERS |
|||
USE_X64 |
|||
CMAKE_TOOLCHAIN_FILE |
FILEPATH |
When vcpkg executable is not found in 'VCPKG_ROOT' - When vcpkg executable is found in 'VCPKG_ROOT' - |
The CMake toolchain file. |
VCPKG_CHAINLOAD_TOOLCHAIN_FILE |
FILEPATH |
|
Specifies an alternate CMake Toolchain file to use. This (if set) will override all other compiler detection logic. By default, a toolchain file is selected from |
VCPKG_INSTALL_OPTIONS |
Clean buildtrees, packages and downloads after building each package: Clean buildtrees after building each package: Clean downloads after building each package: Clean packages after building each package: |
This variable can be set to a list of additional command line parameters to pass to the vcpkg tool during automatic installation. |
|
VCPKG_FEATURE_FLAGS |
Specifies the vcpkg root folder: |
This variable can be set to a list of additional command line parameters to pass to the vcpkg tool during automatic installation to opt in to experimental behaviour. |
|
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|