mirror of https://github.com/microsoft/vcpkg.git synced 2024-12-28 19:25:27 +08:00

* [vcpkg_*_nmake] Add option INSTALL_COMMAND

* [gdal] Update to 3.1.3 and switch to vcpkg_*_nmake on Windows

* [vcpkg_build_make] Add option MAKEFILE

* fix install on windows, fix linux build

* fix options position

* [gdal] Fix linux build

* [gdal] Fix expat library name

* [gdal] Fix geos library name

* [gdal] Fix cmake wrapper

* [pdal] Fix dependency geos

* [pdal] Fix PDALConfig.cmake

* [gdal] Fix dependency cfitsio on *inx

* disable cfitsio temporary

* [gdal] Correct cmake wrapper and usage

* [gdal] Fix tools on windows-static

* Revert a9ac823007975485aacc7e1f3eb4053e295376e1

* Apply suggestions

* [vcpkg_build_nmake] Fix install command

* [vcpkg_build_nmake] Fix install command

* regenerate docs

* [gdal] Update dependency iconv and charset library names

* [gdal] add json-c as a dependency on non-windows

Co-authored-by: Billy Robert O'Neal III <bion@microsoft.com>
Co-authored-by: Nicole Mazzuca <mazzucan@outlook.com>

2020-11-20 10:29:25 -08:00

2.6 KiB

Raw Blame History

vcpkg_from_github

Download and extract a project from GitHub. Enables support for install --head.

Usage:

vcpkg_from_github(
    OUT_SOURCE_PATH <SOURCE_PATH>
    REPO <Microsoft/cpprestsdk>
    [REF <v2.0.0>]
    [SHA512 <45d0d7f8cc350...>]
    [HEAD_REF <master>]
    [PATCHES <patch1.patch> <patch2.patch>...]
    [GITHUB_HOST <https://github.com>]
    [AUTHORIZATION_TOKEN <${SECRET_FROM_FILE}>]
)

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 or commit) 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://github.com/${REPO}/archive/${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.

PATCHES

A list of patches to be applied to the extracted sources.

Relative paths are based on the port directory.

GITHUB_HOST

A replacement host for enterprise GitHub instances.

This field should contain the scheme, host, and port of the desired URL without a trailing slash.

AUTHORIZATION_TOKEN

A token to be passed via the Authorization HTTP header as "token ${AUTHORIZATION_TOKEN}".

FILE_DISAMBIGUATOR

A token to uniquely identify the resulting filename if the SHA512 changes even though a git ref does not, to avoid stepping on the same file name.

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:

Source

scripts/cmake/vcpkg_from_github.cmake

2.6 KiB Raw Blame History