Sdílet prostřednictvím


vcpkg_from_github

Stáhněte a extrahujte projekt z GitHubu. Povolí podporu pro install --head.

To také funguje s Gitea zadáním serveru Gitea s GITHUB_HOST možností.

Využití

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>]
)

Parametry

OUT_SOURCE_PATH

Určuje výstupní proměnnou, která bude obsahovat extrahované umístění.

Tato hodnota by měla být nastavena SOURCE_PATH konvencí.

REPO

Organizace nebo uživatel a úložiště na GitHubu

REF

Stabilní potvrzení gitu (ideálně značka nebo potvrzení), které nezmění obsah. Neměl by to být větev.

U úložišť bez oficiálních verzí je možné nastavit úplné ID potvrzení aktuálního nejnovějšího hlavního serveru.

Je-li REF zadán, SHA512 musí být zadán také.

SHA512

Hodnota hash SHA512, která by měla odpovídat archivu (https://github.com/${REPO}/archive/${REF}.tar.gz).

To je nejsnážnější, když ho nejprve nastavíte na 0a pak se pokusíte vytvořit port. Chybová zpráva bude obsahovat úplnou hodnotu hash, kterou lze zkopírovat zpět do souboru portu.

HEAD_REF

Nestabilní potvrzení gitu (ideálně větev) pro sestavení --head .

U většiny projektů by to mělo být master. Vybraná větev by měla být vždy stavětelná na všech podporovaných platformách.

OPRAVY

Seznam oprav, které se použijí u extrahovaných zdrojů.

Relativní cesty jsou založené na adresáři portů.

GITHUB_HOST

Náhradní hostitel pro podnikové instance GitHubu.

Toto pole by mělo obsahovat schéma, hostitele a port požadované adresy URL bez koncového lomítka.

AUTHORIZATION_TOKEN

Token, který se má předat prostřednictvím hlavičky HTTP autorizace jako token ${AUTHORIZATION_TOKEN}.

FILE_DISAMBIGUATOR

Token pro jedinečnou identifikaci výsledného názvu souboru, pokud se SHA512 změní, i když odkaz gitu ne, aby se zabránilo krokování na stejný název souboru.

Notes

Alespoň jeden z REF nich a HEAD_REF musí být zadán, je však vhodnější, aby byly přítomny obě.

Tím se proměnná VCPKG_HEAD_VERSION exportuje během sestavení hlavy.

Příklady

Source

scripts/cmake/vcpkg_from_github.cmake