Delen via

vcpkg_from_github

Download en pak een project uit GitHub. Hiermee schakelt u ondersteuning voor install --head.

Dit werkt ook metVaka door op te geven van de Server Van Azure met de GITHUB_HOST optie.

Gebruik

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}>]
    [FILE_DISAMBIGUATOR <N>]
    [USE_TARBALL_API]
)

Parameterwaarden

OUT_SOURCE_PATH

Hiermee geeft u de out-variabele die de geëxtraheerde locatie bevat.

Dit moet volgens de conventie worden ingesteld SOURCE_PATH .

REPO

De organisatie of gebruiker en opslagplaats op GitHub.

REF

Een stabiele git commit-ish (idealiter een tag of doorvoer) die de inhoud niet wijzigt. Dit mag geen vertakking zijn.

Voor opslagplaatsen zonder officiële releases kan dit worden ingesteld op de volledige doorvoer-id van de huidige meest recente master.

Als REF is opgegeven, moet SHA512 ook worden opgegeven.

SHA512

De SHA512-hash die moet overeenkomen met het archief (https://github.com/${REPO}/archive/${REF}.tar.gz).

Dit wordt het eenvoudigst bepaald door deze eerst in te 0stellen op en vervolgens de poort te bouwen. Het foutbericht bevat de volledige hash die kan worden gekopieerd naar het poortbestand.

HEAD_REF

De onstabiele git commit-ish (idealiter een vertakking) die moet worden opgehaald voor --head builds.

Voor de meeste projecten moet dit zijn master. De gekozen vertakking moet een vertakking zijn die naar verwachting altijd kan worden gebouwd op alle ondersteunde platforms.

PATCHES

Een lijst met patches die moeten worden toegepast op de geëxtraheerde bronnen.

Relatieve paden zijn gebaseerd op de poortmap.

GITHUB_HOST

Een vervangende host voor Enterprise GitHub-exemplaren.

Dit veld moet het schema, de host en de poort van de gewenste URL bevatten zonder een afsluitende slash.

AUTHORIZATION_TOKEN

Een token dat moet worden doorgegeven via de autorisatie-HTTP-header als 'token ${AUTHORIZATION_TOKEN}'. Als AUTHORIZATION_TOKEN dit een fijnmazig toegangstoken is, moet u ook gebruiken USE_TARBALL_API.

FILE_DISAMBIGUATOR

Een token om de resulterende bestandsnaam uniek te identificeren als de SHA512 wordt gewijzigd, zelfs als een Git-ref dat niet doet, om te voorkomen dat dezelfde bestandsnaam wordt gebruikt.

USE_TARBALL_API

Wanneer dit is opgegeven, gebruikt vcpkg de tarball-API die wordt beschreven in gitHub REST API in plaats van de archief-API om bronnen te downloaden.

Deze optie bestaat in plaats van een globaal beheerde instelling te zijn, omdat de SHA512 van bronnen die worden geretourneerd door de tarball-API verschilt van de reguliere archieven-API.

Opmerkingen

Ten minste één van REF en HEAD_REF moet worden opgegeven, maar het verdient de voorkeur om beide aanwezig te zijn.

Hiermee exporteert u de VCPKG_HEAD_VERSION variabele tijdens hoofd builds.

Voorbeelden

Bron

scripts/cmake/vcpkg_from_github.cmake

  • Last updated on