vcpkg/config-environment.md at 23306bdfe67d081915c798695a780366775ed288

mirror of https://github.com/microsoft/vcpkg.git synced 2024-12-13 00:09:01 +08:00

Kevin Lalumiere f60b947e13

[vcpkg] Allow to use Nuget's cache for Nuget binary caching sources (fix #15169 ) (#15512 )

* Fix warning on clang version 10.0.0-4ubuntu1

The warning was

```shell
../src/vcpkg/commands.porthistory.cpp:55:14: error: unused function 'is_date' [-Werror,-Wunused-function]
```

* Add environment variable VCPKG_USE_NUGET_CACHE

As the name suggests, this environment variable allow tu use Nuget
cache for Nuget binary caching sources.

* Document NuGet's Cache environment variable

2021-01-24 23:11:02 -08:00

3.3 KiB

Raw Blame History

Environment and Configuration

Environment Variables

VCPKG_DOWNLOADS

This environment variable can be set to an existing directory to use for storing downloads instead of the internal downloads/ directory. It should always be set to an absolute path.

VCPKG_FEATURE_FLAGS

This environment variable can be set to a comma-separated list of off-by-default features in vcpkg. These features are subject to change without notice and should be considered highly unstable.

Non-exhaustive list of off-by-default features:

binarycaching
manifest

EDITOR

This environment variable can be set to the full path of an executable to be used for vcpkg edit. Please see vcpkg help edit for command-specific help.

VCPKG_ROOT

This environment variable can be set to a directory to use as the root of the vcpkg instance. Note that mixing vcpkg repo versions and executable versions can cause issues.

VCPKG_VISUAL_STUDIO_PATH

This environment variable can be set to the full path to a Visual Studio instance on the machine. This Visual Studio instance will be used if the triplet does not override it via the VCPKG_VISUAL_STUDIO_PATH triplet setting.

Example: D:\2017

VCPKG_DEFAULT_TRIPLET

This environment variable can be set to a triplet name which will be used for unqualified triplet references in command lines.

VCPKG_OVERLAY_PORTS

This environment variable allows users to override ports with alternate versions according to the ports overlay specification. List paths to overlays using the platform dependent PATH seperator (Windows ; | others :)

Example (Windows): C:\custom-ports\boost;C:\custom-ports\sqlite3

VCPKG_OVERLAY_TRIPLETS

This environment variable allows users to add directories to search for triplets. Example: overlay triplets. List paths to overlays using the platform dependent PATH seperator (Windows ;, others :)

VCPKG_FORCE_SYSTEM_BINARIES

This environment variable, if set, suppresses the downloading of CMake and Ninja and forces the use of the system binaries.

VCPKG_KEEP_ENV_VARS

This environment variable can be set to a list of environment variables, separated by ;, which will be propagated to the build environment.

Example: FOO_SDK_DIR;BAR_SDK_DIR

VCPKG_MAX_CONCURRENCY

This environment variables limits the amount of concurrency requested by underlying buildsystems. If unspecified, this defaults to logical cores + 1.

VCPKG_DEFAULT_BINARY_CACHE

This environment variable redirects the default location to store binary packages. See Binary Caching for more details.

VCPKG_BINARY_SOURCES

This environment variable adds or removes binary sources. See Binary Caching for more details.

VCPKG_NUGET_REPOSITORY

This environment variable changes the metadata of produced NuGet packages. See Binary Caching for more details.

VCPKG_USE_NUGET_CACHE

This environment variable allows using NuGet's cache for every nuget-based binary source. See Binary Caching for more details.

3.3 KiB Raw Blame History