mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-12-13 12:09:01 +08:00
8706cb82cd
* [vcpkg README] Add #include<C++> channel * Fix includecpp -> www.includecpp the SSL is only valid for www.*
91 lines
4.2 KiB
Markdown
91 lines
4.2 KiB
Markdown
# Vcpkg
|
|
|
|
## Overview
|
|
Vcpkg helps you manage C and C++ libraries on Windows, Linux and MacOS. This tool and ecosystem are constantly evolving; your involvement is vital to its success!
|
|
|
|
For short description of available commands, run `vcpkg help`.
|
|
|
|
* Github: [https://github.com/microsoft/vcpkg](https://github.com/microsoft/vcpkg)
|
|
* Slack: [https://cppalliance.org/slack/](https://cppalliance.org/slack/), the #vcpkg channel
|
|
* Discord: [\#include \<C++\>](https://www.includecpp.org), the #🌏vcpkg channel
|
|
* Docs: [Documentation](docs/index.md)
|
|
|
|
[](https://dev.azure.com/vcpkg/public/_build/latest?definitionId=29&branchName=master)
|
|
|
|
## Quick Start
|
|
Prerequisites:
|
|
- Windows 10, 8.1, 7, Linux, or MacOS
|
|
- Visual Studio 2015 Update 3 or newer (on Windows)
|
|
- Git
|
|
- gcc >= 7 or equivalent clang (on Linux)
|
|
- *Optional:* CMake 3.12.4
|
|
|
|
To get started:
|
|
```
|
|
> git clone https://github.com/Microsoft/vcpkg.git
|
|
> cd vcpkg
|
|
|
|
PS> .\bootstrap-vcpkg.bat
|
|
Linux:~/$ ./bootstrap-vcpkg.sh
|
|
```
|
|
|
|
Then, to hook up user-wide [integration](docs/users/integration.md), run (note: requires admin on first use)
|
|
```
|
|
PS> .\vcpkg integrate install
|
|
Linux:~/$ ./vcpkg integrate install
|
|
```
|
|
|
|
Install any packages with
|
|
```
|
|
PS> .\vcpkg install sdl2 curl
|
|
Linux:~/$ ./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 `-DCMAKE_TOOLCHAIN_FILE=[vcpkg root]\scripts\buildsystems\vcpkg.cmake`.
|
|
|
|
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](docs/examples/installing-and-using-packages.md) example for the specifics. If your library is not present in vcpkg catalog, you can open an [issue on the GitHub repo](https://github.com/microsoft/vcpkg/issues) where the dev team and the community can see it and potentially create the port file for this library.
|
|
|
|
Additional notes on macOS and Linux support can be found in the [official announcement](https://blogs.msdn.microsoft.com/vcblog/2018/04/24/announcing-a-single-c-library-manager-for-linux-macos-and-windows-vcpkg/).
|
|
|
|
## Tab-Completion / Auto-Completion
|
|
`vcpkg` supports auto-completion of commands, package names, options etc in Powershell and bash. To enable tab-completion, use one of the following:
|
|
```
|
|
PS> .\vcpkg integrate powershell
|
|
Linux:~/$ ./vcpkg integrate bash
|
|
```
|
|
and restart your console.
|
|
|
|
|
|
## Examples
|
|
See the [documentation](docs/index.md) for specific walkthroughs, including [installing and using a package](docs/examples/installing-and-using-packages.md), [adding a new package from a zipfile](docs/examples/packaging-zipfiles.md), and [adding a new package from a GitHub repo](docs/examples/packaging-github-repos.md).
|
|
|
|
Our docs are now also available online at ReadTheDocs: <https://vcpkg.readthedocs.io/>!
|
|
|
|
See a 4 minute [video demo](https://www.youtube.com/watch?v=y41WFKbQFTw).
|
|
|
|
## Contributing
|
|
Vcpkg is built with your contributions. Here are some ways you can contribute:
|
|
|
|
* [Submit Issues](https://github.com/Microsoft/vcpkg/issues) in vcpkg or existing packages
|
|
* [Submit Fixes and New Packages](https://github.com/Microsoft/vcpkg/pulls)
|
|
|
|
Please refer to our [Contribution guidelines](CONTRIBUTING.md) for more details.
|
|
|
|
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
|
|
|
|
## License
|
|
|
|
Code licensed under the [MIT License](LICENSE.txt).
|
|
|
|
## 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 re-running the bootstrap-vcpkg script with -disableMetrics,
|
|
passing --disable-metrics to vcpkg on the command line,
|
|
or by setting the VCPKG_DISABLE_METRICS environment variable.
|
|
|
|
Read more about vcpkg telemetry at docs/about/privacy.md
|