Freigeben über


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.

Quelle

scripts/cmake/vcpkg_from_gitlab.cmake