Repository files navigation

🌐 Read in a different language

vcpkg is a free and open-source C/C++ package manager maintained by Microsoftand the C++ community.

Initially launched in 2016 as a tool for assisting developers in migrating theirprojects to newer versions of Visual Studio, vcpkg has evolved into across-platform tool used by developers on Windows, macOS, and Linux. vcpkg has alarge collection of open-source libraries and enterprise-ready features designed tofacilitate your development process with support for any build and projectsystems. vcpkg is a C++ tool at heart and is written in C++ with scripts inCMake. It is designed from the ground up to address the unique pain points C/C++developers experience.

This tool and ecosystem are constantly evolving, and we always appreciatecontributions! Learn how to start contributing with ourpackagingtutorial andmaintainerguide.

First, follow one of our quick start guides.

Whether you're using CMake, MSBuild, or any other build system, vcpkg has you covered:

• vcpkg with CMake
• vcpkg with MSBuild
• vcpkg with other build systems

You can also use any editor:

• vcpkg with Visual Studio
• vcpkg with Visual Studio Code
• vcpkg withCLion
• vcpkg with Qt Creator

If a library you need is not present in the vcpkg registry,open an issue onthe GitHub repository orcontribute the packageyourself.

After you've gotten vcpkg installed and working, you may wish toaddtab completion to your terminal.

Create amanifest for your project's dependencies:

vcpkg new --applicationvcpkg add port fmt

Orinstall packages through the command line:

vcpkg install fmt

Then use one of our available integrations forCMake,MSBuild orother buildsystems.

For a short description of all available commands, runvcpkg help.Runvcpkg help [topic] for details on a specific topic.

vcpkg offers powerful features for your package management needs:

• easily integrate with your build system
• control the versions of your dependencies
• package and publish your own packages
• reuse your binary artifacts
• enable offline scenarios with asset caching

vcpkg is an open source project, and is thus built with your contributions. Hereare some ways you can contribute:

• Submit issues in vcpkg or existing packages
• Submit fixes and new packages

Please refer to ourmantainer guide andpackaging tutorial for more details.

This project has adopted theMicrosoft Open Source Code ofConduct. For more information see theCode of ConductFAQ or emailopencode@microsoft.com with any additionalquestions or comments.

• Ports:Microsoft/vcpkg
• Source code:Microsoft/vcpkg-tool
• Docs:Microsoft Learn | vcpkg
• Website:vcpkg.io
• Email:vcpkg@microsoft.com
• Discord:#include <C++>'s Discord server, in the #🌏vcpkg channel
• Slack:C++ Alliance's Slack server, in the #vcpkg channel

The code in this repository is licensed under the MIT License. The librariesprovided by ports are licensed under the terms of their original authors. Whereavailable, vcpkg places the associated license(s) in the locationinstalled/<triplet>/share/<port>/copyright.

Most ports in vcpkg build the libraries in question using the original buildsystem preferred by the original developers of those libraries, and downloadsource code and build tools from their official distribution locations. For usebehind a firewall, the specific access needed will depend on which ports arebeing installed. If you must install it in an "air gapped" environment, considerinstaling once in a non-"air gapped" environment, populating anassetcache shared with the otherwise "air gapped"environment.

vcpkg collects usage data in order to help us improve your experience. The datacollected by Microsoft is anonymous. You can opt-out of telemetry by:

• running the bootstrap-vcpkg script with-disableMetrics
• passing--disable-metrics to vcpkg on the command line
• setting theVCPKG_DISABLE_METRICS environment variable

Read more about vcpkg telemetry athttps://learn.microsoft.com/vcpkg/about/privacy.