-
Notifications
You must be signed in to change notification settings - Fork 6.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[vcpkg_build_cmake] Refactor _build_ and _install_ into a single cmak…
…e script. Regenerate documentation. Remove MSVC_64_TOOLSET option because it's obsolete.
- Loading branch information
1 parent
06798b6
commit 2c9ee07
Showing
12 changed files
with
141 additions
and
85 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
# vcpkg_build_cmake | ||
|
||
Build a cmake project. | ||
|
||
## Usage: | ||
```cmake | ||
vcpkg_build_cmake([DISABLE_PARALLEL] [TARGET <target>]) | ||
``` | ||
|
||
## Parameters: | ||
### DISABLE_PARALLEL | ||
The underlying buildsystem will be instructed to not parallelize | ||
|
||
### TARGET | ||
The target passed to the cmake build command (`cmake --build . --target <target>`). If not specified, no target will | ||
be passed. | ||
|
||
## Notes: | ||
This command should be preceeded by a call to [`vcpkg_configure_cmake()`](vcpkg_configure_cmake.md). | ||
You can use the alias [`vcpkg_install_cmake()`](vcpkg_configure_cmake.md) function if your CMake script supports the | ||
"install" target | ||
|
||
## Examples: | ||
|
||
* [zlib](https://github.com/Microsoft/vcpkg/blob/master/ports/zlib/portfile.cmake) | ||
* [cpprestsdk](https://github.com/Microsoft/vcpkg/blob/master/ports/cpprestsdk/portfile.cmake) | ||
* [poco](https://github.com/Microsoft/vcpkg/blob/master/ports/poco/portfile.cmake) | ||
* [opencv](https://github.com/Microsoft/vcpkg/blob/master/ports/opencv/portfile.cmake) | ||
|
||
## Source | ||
[scripts/cmake/vcpkg_build_cmake.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_build_cmake.cmake) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
# vcpkg_from_bitbucket | ||
|
||
Download and extract a project from Bitbucket. | ||
Enables support for installing HEAD `vcpkg.exe install --head <port>`. | ||
|
||
## Usage: | ||
```cmake | ||
vcpkg_from_bitbucket( | ||
OUT_SOURCE_PATH <SOURCE_PATH> | ||
REPO <Microsoft/cpprestsdk> | ||
[REF <v2.0.0>] | ||
[SHA512 <45d0d7f8cc350...>] | ||
[HEAD_REF <master>] | ||
) | ||
``` | ||
|
||
## Parameters: | ||
### OUT_SOURCE_PATH | ||
Specifies the out-variable that will contain the extracted location. | ||
|
||
This should be set to `SOURCE_PATH` by convention. | ||
|
||
### REPO | ||
The organization or user and repository on GitHub. | ||
|
||
### REF | ||
A stable git commit-ish (ideally a tag) that will not change contents. **This should not be a branch.** | ||
|
||
For repositories without official releases, this can be set to the full commit id of the current latest master. | ||
|
||
If `REF` is specified, `SHA512` must also be specified. | ||
|
||
### SHA512 | ||
The SHA512 hash that should match the archive (https://bitbucket.com/${REPO}/get/${REF}.tar.gz). | ||
|
||
This is most easily determined by first setting it to `1`, then trying to build the port. The error message will contain the full hash, which can be copied back into the portfile. | ||
|
||
### HEAD_REF | ||
The unstable git commit-ish (ideally a branch) to pull for `--head` builds. | ||
|
||
For most projects, this should be `master`. The chosen branch should be one that is expected to be always buildable on all supported platforms. | ||
|
||
## Notes: | ||
At least one of `REF` and `HEAD_REF` must be specified, however it is preferable for both to be present. | ||
|
||
This exports the `VCPKG_HEAD_VERSION` variable during head builds. | ||
|
||
## Examples: | ||
|
||
* [blaze](https://github.com/Microsoft/vcpkg/blob/master/ports/blaze/portfile.cmake) | ||
|
||
## Source | ||
[scripts/cmake/vcpkg_from_bitbucket.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_from_bitbucket.cmake) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters