3party/vcpkg
0
0
Fork 0
mirror of https://github.com/microsoft/vcpkg.git synced 2025-01-15 14:58:05 +08:00
Code Issues Projects Releases Wiki Activity

[vcpkg-docs] Improve documentation for Visual Studio 2019

Browse Source
This commit is contained in:
Robert Schumacher 2019-01-30 17:47:36 -08:00
parent 0e759709dd
commit 36cb7592b1
1 changed files with 17 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/users/triplets.md
View File

@ -53,25 +53,33 @@ This option also has forms for configuration-specific and C flags:
## Windows Variables ## Windows Variables
### VCPKG_PLATFORM_TOOLSET
Specifies the VS-based C/C++ compiler toolchain to use.
This can be set to `v141`, `v140`, or left blank. If left blank, we select the latest compiler toolset available on your machine.
Visual Studio 2015 platform toolset is `v140`
Visual Studio 2017 platform toolset is `v141`
<a name="VCPKG_VISUAL_STUDIO_PATH"></a> <a name="VCPKG_VISUAL_STUDIO_PATH"></a>
### VCPKG_VISUAL_STUDIO_PATH ### VCPKG_VISUAL_STUDIO_PATH
Specifies the Visual Studio installation to use. Specifies the Visual Studio installation to use.
When unspecified, a Visual Studio instance is selected automatically, preferring Stable 2017, then Preview 2017, then 2015. To select the precise combination of Visual Studio instance and toolset version, we walk through the following algorithm:
1. Determine the setting for `VCPKG_VISUAL_STUDIO_PATH` from the triplet, or the environment variable `VCPKG_VISUAL_STUDIO_PATH`, or consider it unset
2. Determine the setting for `VCPKG_PLATFORM_TOOLSET` from the triplet or consider it unset
3. Gather a list of all pairs of Visual Studio Instances with all toolsets available in those instances
1. This is ordered first by instance type (Stable, Prerelease, Legacy) and then by toolset version (v142, v141, v140)
4. Filter the list based on the settings for `VCPKG_VISUAL_STUDIO_PATH` and `VCPKG_PLATFORM_TOOLSET`.
5. Select the best remaining option
The path should be absolute, formatted with backslashes, and have no trailing slash: The path should be absolute, formatted with backslashes, and have no trailing slash:
```cmake ```cmake
set(VCPKG_VISUAL_STUDIO_PATH "C:\\Program Files (x86)\\Microsoft Visual Studio\\Preview\\Community") set(VCPKG_VISUAL_STUDIO_PATH "C:\\Program Files (x86)\\Microsoft Visual Studio\\Preview\\Community")
``` ```
### VCPKG_PLATFORM_TOOLSET
Specifies the VS-based C/C++ compiler toolchain to use.
See [`VCPKG_VISUAL_STUDIO_PATH`](#VCPKG_VISUAL_STUDIO_PATH) for the full selection algorithm.
Valid settings:
* The Visual Studio 2019 platform toolset is `v142`.
* The Visual Studio 2017 platform toolset is `v141`.
* The Visual Studio 2015 platform toolset is `v140`.
## MacOS Variables ## MacOS Variables
### VCPKG_INSTALL_NAME_DIR ### VCPKG_INSTALL_NAME_DIR