Edit

Share via

vcpkg integrate

  • Article

Synopsis

  • Build system integration
vcpkg integrate [options] install
vcpkg integrate [options] remove
vcpkg integrate [options] project
  • Shell integration
vcpkg integrate [options] powershell
vcpkg integrate [options] bash
vcpkg integrate [options] zsh
vcpkg integrate [options] x-fish

Description

Integrate vcpkg with shells and buildsystems.

vcpkg integrate install

Integrates with Visual Studio (Windows-only), sets the user-wide vcpkg instance, and displays CMake integration help.

On Windows with Visual Studio 2015, this subcommand will add redirecting logic into the MSBuild installation which will automatically pick up each user's user-wide vcpkg instance. Visual Studio 2017 and newer have this logic in the box.

To set the user-wide vcpkg instance, vcpkg creates a few short files containing the absolute path to the vcpkg instance inside the user's user-wide configuration location:

  • %LOCALAPPDATA%\vcpkg or %APPDATA%\Local\vcpkg on Windows
  • $HOME/.vcpkg or /var/.vcpkg on non-Windows

Displays the full path to the CMake toolchain file. Running this command is not required to use the toolchain file.

vcpkg integrate remove

Removes the user-wide vcpkg instance setting.

This command deletes the linking files from the user-wide configuration location created by vcpkg integrate install.

vcpkg integrate project

Creates a linked NuGet package for MSBuild integration.

See MSBuild Per-Project Integration for more information.

vcpkg integrate powershell

  • Windows only

Adds vcpkg tab-completion support to the current user's Powershell profile.

vcpkg integrate bash

  • Non-Windows only

Adds vcpkg tab-completion support to the current user's .bashrc (.bash_profile on MacOS).

vcpkg integrate zsh

  • Non-Windows only

Adds vcpkg tab-completion support to the current user's .zshrc.

vcpkg integrate x-fish

  • Non-Windows only

Adds vcpkg tab-completion support to the current user's fish shell completions directory.

Example

$ vcpkg integrate install
Applied user-wide integration for this vcpkg root.

CMake projects should use: "-DCMAKE_TOOLCHAIN_FILE=/workspaces/vcpkg/scripts/buildsystems/vcpkg.cmake"

Options

All vcpkg commands support a set of common options.