Convert Figma logo to code with AI

microsoft logovcpkg

C++ Library Manager for Windows, Linux, and MacOS

22,750
6,290
22,750
1,198

Top Related Projects

8,117

Conan - The open-source C and C++ package manager

1,871

5,498

The Meson Build System

Quick Overview

Vcpkg is a free, open-source package manager for C and C++ libraries on Windows, Linux, and macOS. It simplifies the process of acquiring and building open-source libraries, making it easier for developers to manage dependencies in their projects.

Pros

  • Cross-platform support (Windows, Linux, macOS)
  • Large collection of pre-configured libraries (1,900+ ports)
  • Integration with Visual Studio and other build systems
  • Versioning support for better reproducibility

Cons

  • Can be slower compared to system package managers
  • Limited to C and C++ libraries
  • Some libraries may not be available or up-to-date
  • Learning curve for users new to package management

Getting Started

  1. Install vcpkg:
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh  # For Linux/macOS
.\bootstrap-vcpkg.bat  # For Windows
  1. Install a library:
./vcpkg install boost
  1. Use vcpkg with CMake:
cmake -B [build directory] -S . -DCMAKE_TOOLCHAIN_FILE=[path to vcpkg]/scripts/buildsystems/vcpkg.cmake
  1. In your C++ code, include and use the installed library:
#include <boost/algorithm/string.hpp>

std::string text = "Hello, World!";
boost::to_upper(text);

Competitor Comparisons

8,117

Conan - The open-source C and C++ package manager

Pros of Conan

  • Language-agnostic package manager, supporting multiple programming languages
  • Decentralized architecture allowing for private repositories and custom servers
  • More flexible dependency resolution with version ranges and conflict resolution

Cons of Conan

  • Steeper learning curve due to more complex configuration options
  • Smaller package ecosystem compared to vcpkg
  • Requires more setup and configuration for simple projects

Code Comparison

Conan:

from conans import ConanFile, CMake

class MyProjectConan(ConanFile):
    requires = "boost/1.74.0", "poco/1.9.4"
    generators = "cmake"

vcpkg:

{
  "name": "my-project",
  "version-string": "1.0.0",
  "dependencies": [
    "boost",
    "poco"
  ]
}

Both Conan and vcpkg are popular C++ package managers, but they differ in their approach and features. Conan offers more flexibility and language support, while vcpkg provides a simpler experience with a larger package ecosystem. The code comparison shows how dependencies are defined in each system, with Conan using a Python-based configuration and vcpkg using a JSON manifest file.

1,871

Pros of Hunter

  • Cross-platform support for multiple operating systems and compilers
  • Caching mechanism for faster builds and CI integration
  • Supports multiple versions of the same package simultaneously

Cons of Hunter

  • Steeper learning curve due to its unique approach
  • Smaller package ecosystem compared to vcpkg
  • Less frequent updates and maintenance

Code Comparison

Hunter:

hunter_add_package(Boost COMPONENTS system filesystem)
find_package(Boost CONFIG REQUIRED system filesystem)
target_link_libraries(main Boost::system Boost::filesystem)

vcpkg:

find_package(Boost REQUIRED COMPONENTS system filesystem)
target_link_libraries(main PRIVATE Boost::system Boost::filesystem)

Both Hunter and vcpkg aim to simplify C++ dependency management, but they take different approaches. Hunter focuses on a CMake-centric workflow with built-in caching, while vcpkg offers a more traditional package management experience with a larger ecosystem. The choice between the two depends on project requirements, team familiarity, and desired workflow integration.

5,498

The Meson Build System

Pros of Meson

  • Cross-platform build system with support for multiple languages
  • Fast build times and efficient dependency management
  • Simple and readable syntax for build configuration

Cons of Meson

  • Steeper learning curve for developers familiar with traditional build systems
  • Limited ecosystem compared to vcpkg's extensive package collection

Code Comparison

Meson build file (meson.build):

project('example', 'cpp')
executable('myapp', 'main.cpp')

vcpkg manifest file (vcpkg.json):

{
  "name": "example",
  "version-string": "1.0.0",
  "dependencies": [
    "boost"
  ]
}

Meson focuses on build configuration, while vcpkg primarily handles package management. Meson's build files are typically more concise and use a Python-like syntax. vcpkg uses JSON for package manifests and integrates with various build systems.

Meson is a full-fledged build system, offering more control over the build process. vcpkg excels at managing dependencies and integrating them into existing projects. While both tools serve different primary purposes, they can be used together in a project to leverage their respective strengths.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

🌐 Read in a different language

vcpkg overview

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

Initially launched in 2016 as a tool for assisting developers in migrating their projects to newer versions of Visual Studio, vcpkg has evolved into a cross-platform tool used by developers on Windows, macOS, and Linux. vcpkg has a large collection of open-source libraries and enterprise-ready features designed to facilitate your development process with support for any build and project systems. vcpkg is a C++ tool at heart and is written in C++ with scripts in CMake. 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 appreciate contributions! Learn how to start contributing with our packaging tutorial and maintainer guide.

Get started

First, follow one of our quick start guides.

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

You can also use any editor:

If a library you need is not present in the vcpkg registry, open an issue on the GitHub repository or contribute the package yourself.

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

Use vcpkg

Create a manifest for your project's dependencies:

vcpkg new --application
vcpkg add port fmt

Or install packages through the command line:

vcpkg install fmt

Then use one of our available integrations for CMake, MSBuild or other build systems.

For a short description of all available commands, run vcpkg help. Run vcpkg help [topic] for details on a specific topic.

Key features

vcpkg offers powerful features for your package management needs:

Contribute

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

Please refer to our mantainer guide and packaging tutorial for more details.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or email opencode@microsoft.com with any additional questions or comments.

Resources

License

The code in this repository is licensed under the MIT License. The libraries provided by ports are licensed under the terms of their original authors. Where available, vcpkg places the associated license(s) in the location installed/<triplet>/share/<port>/copyright.

Security

Most ports in vcpkg build the libraries in question using the original build system preferred by the original developers of those libraries, and download source code and build tools from their official distribution locations. For use behind a firewall, the specific access needed will depend on which ports are being installed. If you must install it in an "air gapped" environment, consider instaling once in a non-"air gapped" environment, populating an asset cache shared with the otherwise "air gapped" environment.

Telemetry

vcpkg collects usage data in order to help us improve your experience. The data collected 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 the VCPKG_DISABLE_METRICS environment variable

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