vcpkg_from_gitlab
Scaricare ed estrarre un progetto dalle istanze di Gitlab. Abilita il supporto per install --head
.
Utilizzo
vcpkg_from_gitlab(
GITLAB_URL <https://gitlab.com>
OUT_SOURCE_PATH <SOURCE_PATH>
REPO <gitlab-org/gitlab-ce>
[REF <v10.7.3>]
[SHA512 <45d0d7f8cc350...>]
[HEAD_REF <master>]
[PATCHES <patch1.patch> <patch2.patch>...]
[AUTHORIZATION_TOKEN <${SECRET_FROM_FILE}>]
[FILE_DISAMBIGUATOR <N>]
)
Parametri
GITLAB_URL
URL dell'istanza di Gitlab da usare.
OUT_SOURCE_PATH
Specifica la variabile out che conterrà la posizione estratta.
Deve essere impostata su SOURCE_PATH
per convenzione.
REPO
L'organizzazione o l'utente più il nome del repository nell'istanza di Gitlab.
REF
Un commit-ish git stabile (idealmente un tag) che non modificherà il contenuto. Questo non deve essere un ramo.
Per i repository senza versioni ufficiali, è possibile impostare l'ID commit completo del master corrente.
Se REF
è specificato, SHA512
è necessario specificare anche .
SHA512
Hash SHA512 che deve corrispondere all'archivio (${GITLAB_URL}/${REPO}/-/archive/${REF}/${REPO_NAME}-${REF}.tar.gz). La variabile REPO_NAME viene analizzata dal valore di REPO.
Questa operazione è più facilmente determinata impostandola prima su 0
, quindi provando a compilare la porta. Il messaggio di errore conterrà l'hash completo, che può essere copiato di nuovo nel file di porta.
HEAD_REF
Commit-ish git instabile (idealmente un ramo) di cui eseguire il pull per --head
le compilazioni.
Per la maggior parte dei progetti, deve essere master
. Il ramo scelto deve essere sempre compilabile in tutte le piattaforme supportate.
PATCH
Elenco di patch da applicare alle origini estratte.
I percorsi relativi sono basati sulla directory della porta.
AUTHORIZATION_TOKEN
Token da passare tramite l'intestazione HTTP di autorizzazione "PRIVATE-TOKEN".
FILE_DISAMBIGUATOR
Token per identificare in modo univoco il nome file risultante se SHA512 cambia anche se un riferimento Git non viene eseguito, per evitare di eseguire istruzioni sullo stesso nome file.
Note
Almeno uno di REF
e HEAD_REF
deve essere specificato, tuttavia è preferibile che entrambi siano presenti.
In questo modo la variabile viene esportata durante le VCPKG_HEAD_VERSION
compilazioni head.