Vcpkg helps you manage C and C++ libraries on Windows, Linux and MacOS. This tool and ecosystem are constantly evolving; your involvement are vital to its success!
For short description of available commands, run
- Windows 10, 8.1, 7, Linux, or MacOS
- Visual Studio 2017 or Visual Studio 2015 Update 3 (on Windows)
- Optional: CMake 3.10.2
To get started:
> git clone https://github.com/Microsoft/vcpkg.git > cd vcpkg PS> .\bootstrap-vcpkg.bat Ubuntu:~/$ ./bootstrap-vcpkg.sh
Then, to hook up user-wide integration, run (note: requires admin on first use)
PS> .\vcpkg integrate install Ubuntu:~/$ ./vcpkg integrate install
Install any packages with
PS> .\vcpkg install sdl2 curl Ubuntu:~/$ ./vcpkg install sdl2 curl
The best way to use installed libraries with CMake is via the toolchain file
scripts\buildsystems\vcpkg.cmake. To use this file, you simply need to add it onto your CMake command line as
In Visual Studio, you can create a New Project (or open an existing one). All installed libraries are immediately ready to be
#include'd and used in your project without additional configuration.
For more information, see our using a package example for the specifics.
Additional notes on macOS and Linux support can be found in the official announcement.
Tab-Completion / Auto-Completion
vcpkg supports auto-completion of commands, package names, options etc. To enable tab-completion in Powershell, use
.\vcpkg integrate powershell
and restart Powershell.
Our docs are now also available online at ReadTheDocs: https://vcpkg.readthedocs.io/!
See a 4 minute video demo.
Vcpkg is built with your contributions. Here are some ways you can contribute:
Please refer to our Contribution guidelines for more details.
Code licensed under the MIT License.