Udostępnij za pośrednictwem

vcpkg_from_github

  • Artykuł

Pobierz i wyodrębnij projekt z usługi GitHub. Włącza obsługę programu install --head.

Działa to również z usługą Gitea, określając serwer Gitea z opcją GITHUB_HOST .

Sposób użycia

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

Określa zmienną out-, która będzie zawierać wyodrębnionej lokalizacji.

Powinno to być ustawione SOURCE_PATH zgodnie z konwencją.

REPO

Organizacja lub użytkownik i repozytorium w usłudze GitHub.

REF

Stabilne zatwierdzenie git (najlepiej tag lub zatwierdzenie), które nie zmieni zawartości. Nie powinno to być gałąź.

W przypadku repozytoriów bez oficjalnych wydań można ustawić ten identyfikator pełnego zatwierdzenia bieżącego najnowszego wzorca.

Jeśli REF jest określony, SHA512 należy również określić.

SHA512

Skrót SHA512, który powinien być zgodny z archiwum (https://github.com/${REPO}/archive/${REF}.tar.gz).

Jest to najbardziej łatwe do określenia przez ustawienie go 0jako , a następnie próba skompilowania portu. Komunikat o błędzie będzie zawierać pełny skrót, który można skopiować z powrotem do pliku portfile.

HEAD_REF

Niestabilne zatwierdzenie git (najlepiej gałąź) do ściągnięcia dla --head kompilacji.

W przypadku większości projektów powinna to być masterwartość . Wybrana gałąź powinna być zawsze dostępna na wszystkich obsługiwanych platformach.

POPRAWKI

Lista poprawek, które mają być stosowane do wyodrębnionych źródeł.

Ścieżki względne są oparte na katalogu portów.

GITHUB_HOST

Host zastępczy dla wystąpień usługi GitHub przedsiębiorstwa.

To pole powinno zawierać schemat, host i port żądanego adresu URL bez końcowego ukośnika.

AUTHORIZATION_TOKEN

Token do przekazania za pośrednictwem nagłówka HTTP autoryzacji jako "token ${AUTHORIZATION_TOKEN}".

FILE_DISAMBIGUATOR

Token umożliwiający unikatową identyfikację wynikowej nazwy pliku, jeśli algorytm SHA512 ulegnie zmianie, mimo że odwołanie git nie zostanie wprowadzone, aby uniknąć przechodzenia na tę samą nazwę pliku.

Uwagi

Należy określić co najmniej jeden z REF elementów i HEAD_REF , jednak zaleca się, aby oba te elementy zostały przedstawione.

Spowoduje to wyeksportowanie zmiennej VCPKG_HEAD_VERSION podczas kompilacji głównych.

Przykłady

Źródło

scripts/cmake/vcpkg_from_github.cmake