C++ Library Manager for Windows, Linux, and MacOS
Go to file
2017-12-13 11:55:22 -06:00
docs [vcpkg-build-msbuild] Update examples. 2017-11-08 10:41:03 -08:00
ports [brotli] Fix regressions introduced during update 2017-12-13 06:20:07 -08:00
scripts [powershell] Use \ instead of / for paths. Resolves #2358. Resolves #2361 2017-12-12 17:53:29 -08:00
toolsrc Add quotation marks to support user profiles with spaces in them 2017-12-13 11:55:22 -06:00
triplets vcpkg: initial ARM64 support 2017-10-12 12:02:14 +03:00
.gitattributes [vcpkg] Refactored to simplify BuildPolicies into BuildPolicy. 2017-05-24 00:44:00 -07:00
.gitignore [vcpkg] Add --x-xunit internal command to print installation results in a VSTS friendly format. 2017-11-30 08:09:09 -08:00
.vcpkg-root Add .vcpkg-root file that signifies the root directory 2016-09-19 18:49:38 -07:00
bootstrap-vcpkg.bat Fix bootstrap-vcpkg.bat to work with space in path 2017-04-17 12:15:07 -07:00
CHANGELOG.md Update CHANGELOG and bump version to v0.0.100 2017-12-04 16:53:56 -08:00
CONTRIBUTING.md Moved CONTRIBUTING.md to root. Fixes #54. 2016-09-21 13:35:51 -07:00
LICENSE.txt Initial commit 2016-09-18 20:54:03 -07:00
README.md [autocomplete] Add info in README.md 2017-12-04 16:01:16 -08:00

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, or 7
  • Visual Studio 2017 or Visual Studio 2015 Update 3
  • Git
  • Optional: CMake 3.10.0

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.

For CMake projects, simply include our toolchain file. 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:

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.