Vcpkg
Overview
Vcpkg helps you get C and C++ libraries on Windows. This tool and ecosystem are currently in a preview state; your involvement is vital to its success.
For short description of available commands, run vcpkg help
.
Quick Start
Prerequisites:
- Windows 10, 8.1, 7, Linux, or OSX
- Visual Studio 2017 or Visual Studio 2015 Update 3 (on Windows)
- Git
- Optional: CMake 3.10.2
Clone this repository, then run
C:\src\vcpkg> .\bootstrap-vcpkg.bat
Then, to hook up user-wide integration, run (note: requires admin on first use)
C:\src\vcpkg> .\vcpkg integrate install
Install any packages with
C:\src\vcpkg> .\vcpkg install sdl2 curl
Finally, create a New Project (or open an existing one) in Visual Studio 2017 or 2015. All installed libraries are immediately ready to be #include
'd and used in your project.
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 -DCMAKE_TOOLCHAIN_FILE=D:\src\vcpkg\scripts\buildsystems\vcpkg.cmake
.
For more information, see our using a package example for the specifics.
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.
Examples
See the documentation for specific walkthroughs, including using a package and adding a new package.
Our docs are now also available online at ReadTheDocs: https://vcpkg.readthedocs.io/!
See a 4 minute video demo.
Contributing
Vcpkg is built with your contributions. Here are some ways you can contribute:
- Submit Issues in vcpkg or existing packages
- Submit Fixes and New Packages
Please refer to our Contribution guidelines for more details.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
License
Code licensed under the MIT License.