vcpkg_from_gitlab
Laden Sie ein Projekt aus Gitlab-Instanzen herunter, und extrahieren Sie es. Aktiviert die Unterstützung für install --head
.
Verbrauch
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>]
)
Parameter
GITLAB_URL
Die URL der zu verwendenden Gitlab-Instanz.
OUT_SOURCE_PATH
Gibt die Out-Variable an, die den extrahierten Speicherort enthält.
Dies sollte nach Konvention festgelegt SOURCE_PATH
werden.
REPO
Die Organisation oder der Benutzer sowie den Repositorynamen in der Gitlab-Instanz.
REF
Ein stabiles Git Commit-ish (idealerweise ein Tag), das den Inhalt nicht ändert. Dies sollte keine Verzweigung sein.
Für Repositorys ohne offizielle Versionen kann dies auf die vollständige Commit-ID des aktuellen aktuellen Master festgelegt werden.
Wenn REF
angegeben ist, muss auch SHA512
angegeben werden.
SHA512
Der SHA512-Hash, der mit dem Archiv übereinstimmen soll (${GITLAB_URL}/${REPO}/-/archive/${REF}/$REPO_NAME}-${REF}.tar.gz). Die REPO_NAME Variable wird aus dem Wert von REPO analysiert.
Dies wird am einfachsten bestimmt, indem sie zuerst auf 0
"Port" festgelegt und dann versucht wird, den Port zu erstellen. Die Fehlermeldung enthält den vollständigen Hash, der wieder in die Portdatei kopiert werden kann.
HEAD_REF
Das instabile Git Commit-ish (idealerweise eine Verzweigung), die für --head
Builds abgerufen werden soll.
Für die meisten Projekte sollte dies sein master
. Die gewählte Verzweigung sollte eine sein, die voraussichtlich immer auf allen unterstützten Plattformen erstellt werden kann.
PATCHES
Eine Liste der Patches, die auf die extrahierten Quellen angewendet werden sollen.
Relative Pfade basieren auf dem Portverzeichnis.
AUTHORIZATION_TOKEN
Ein Token, das über den Autorisierungs-HTTP-Header "PRIVATE-TOKEN" übergeben werden soll.
FILE_DISAMBIGUATOR
Ein Token, um den resultierenden Dateinamen eindeutig zu identifizieren, wenn sich die SHA512 ändert, auch wenn ein Git-Verweis nicht erfolgt, um zu vermeiden, denselben Dateinamen zu verwenden.
Hinweise
Mindestens einer von REF
und HEAD_REF
muss angegeben werden, es ist jedoch vorzuziehen, dass beide vorhanden sind.
Dadurch wird die Variable während der VCPKG_HEAD_VERSION
Headbuilds exportiert.