C++ Library Manager for Windows, Linux, and MacOS
Go to file
Thomas Krause ebda0b9fc2 [sfsexp] Add new port (#9420)
* Add sfsexp, S-expressions library

* Use CMakeLists.txt directly instead of patching it

* Use sub-folder for sfsexp header files

* Manually set the header files and make sure the resulting include/ folder is the same as with the autotools installation

* Add runtime parameter for the DLL

* Export all symbols in the DLLAA

* Use PUBLIC_HEADER property install of install(FILES...)

* Remove boilerplate comments from portfile

* Only create static library on windows

* Throw error on UWP

* Disable some windows UWP warnings

* Use VCPKG_TARGET_IS_WINDOWS and put it on top of file

* Deleted extra blank lines

* Missed one blank line

* Use ${PORT} variable instead of the specific "sfsexp" string.

This should make it easier to change the name of the port later on.

* Use vcpkg_from_github to fetch the release.

* Remove extra empty lines
2020-01-27 14:19:26 -08:00
.github [vcpkg] Add pull request template (#9280) 2019-12-11 12:12:08 -08:00
docs Community Triplets 🤝 (#7976) 2020-01-17 14:21:19 -08:00
ports [sfsexp] Add new port (#9420) 2020-01-27 14:19:26 -08:00
scripts [asiosdk] Add new port (#9456) 2020-01-27 14:14:26 -08:00
toolsrc Add support for building with MinGW (#9137) 2020-01-17 15:36:08 -08:00
triplets Add support for building with MinGW (#9137) 2020-01-17 15:36:08 -08:00
.gitattributes [everything] Use -text to ensure consistent files across machines. 2018-02-26 18:18:05 -08:00
.gitignore Add support for building with MinGW (#9137) 2020-01-17 15:36:08 -08:00
.vcpkg-root Add .vcpkg-root file that signifies the root directory 2016-09-19 18:49:38 -07:00
bootstrap-vcpkg.bat bootstrap.bat now forwards args to ps1 2018-06-08 16:26:57 -07:00
bootstrap-vcpkg.sh [vcpkg] Update to CMake 3.14.0 2019-03-20 16:23:02 -07:00
CHANGELOG.md Add December changelog (#9605) 2020-01-09 06:08:21 -08:00
CONTRIBUTING.md Moved CONTRIBUTING.md to root. Fixes #54. 2016-09-21 13:35:51 -07:00
LICENSE.txt [vcpkg] remove text from license (#8082) 2019-09-06 14:24:19 -07:00
NOTICE.txt Add third party notices -- copied from chakracore (#7403) 2019-07-24 11:07:55 -07:00
README_zh_CN.md Add Chinese readme. (#8476) 2019-10-07 10:40:57 -07:00
README.md Update README.md 2019-11-22 15:10:57 -08:00

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.

Windows (x86, x64, arm, uwp) MacOS Linux
Build Status Build Status Build Status

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, 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 example for the specifics. If your library is not present in vcpkg catalog, you can open an issue on the GitHub repo 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.

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 for specific walkthroughs, including installing and using a package, adding a new package from a zipfile, and adding a new package from a GitHub repo.

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.