Skip to content

Document the new VcpkgInstalledDirRoot property #566

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
stinos wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Document the new VcpkgInstalledDirRoot property #566

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions vcpkg/users/buildsystems/msbuild-integration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -208,6 +208,15 @@ This property defines the location vcpkg will install and consume libraries from

In manifest mode, this defaults to `$(VcpkgManifestRoot)\vcpkg_installed\$(VcpkgTriplet)\`. In
classic mode, this defaults to `$(VcpkgRoot)\installed\`.
Use [`VcpkgInstalledDirRoot`](#vcpkginstalleddirroot) to change the default location in manifest mode.

### <a name="vcpkginstalleddirroot"></a> `VcpkgInstalledDirRoot` (Installed Directory Root)

This property defines the installation directory for libraries when using manifest mode.
Subdirectories are created as needed for each triplet. This property is ignored when `VcpkgInstalledDir` is explicitly defined.

The installed directory is derived as `$(VcpkgInstalledDirRoot)\$(VcpkgTriplet)`. `VcpkgInstalledDirRoot`
defaults to `$(VcpkgManifestRoot)\vcpkg_installed\`.

### `VcpkgApplocalDeps` (App-locally deploy DLLs)

Expand Down Expand Up @@ -235,6 +244,7 @@ reload the IDE to see the vcpkg Property Page.
vcpkg will run during your project's build and install any listed dependencies to
`vcpkg_installed/$(VcpkgTriplet)/` adjacent to the `vcpkg.json` file; these libraries will then
automatically be included in and linked to your MSBuild projects.
You can use the [`VcpkgInstalledDirRoot`](#vcpkginstalleddirroot) property to change this directory.

### Known issues

Expand Down