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 0
a 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.