vcpkg_from_github
Descargue y extraiga un proyecto de GitHub. Habilita la compatibilidad con install --head
.
Esto también funciona con Gitea especificando el servidor de Gitea con la GITHUB_HOST
opción .
Uso
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>]
)
Parámetros
OUT_SOURCE_PATH
Especifica la variable out que contendrá la ubicación extraída.
Esto debe establecerse SOURCE_PATH
en por convención.
REPO
La organización o el usuario y el repositorio en GitHub.
REF
Una confirmación de Git estable (idealmente una etiqueta o confirmación) que no cambiará el contenido. Esto no debe ser una rama.
En el caso de los repositorios sin versiones oficiales, se puede establecer en el identificador de confirmación completo del maestro más reciente actual.
Si se especifica REF
, se debe especificar también SHA512
.
SHA512
Hash SHA512 que debe coincidir con el archivo (https://github.com/${REPO}/archive/${REF}.tar.gz).
Esto se determina con más facilidad estableciendo primero en 0
y, a continuación, intentando compilar el puerto. El mensaje de error contendrá el hash completo, que se puede copiar de nuevo en el archivo port.
HEAD_REF
La confirmación de Git inestable esh (idealmente una rama) que se va a extraer para --head
las compilaciones.
Para la mayoría de los proyectos, debe ser master
. La rama elegida debe ser una que se espera que siempre se pueda compilar en todas las plataformas compatibles.
PARCHES
Lista de revisiones que se aplicarán a los orígenes extraídos.
Las rutas de acceso relativas se basan en el directorio de puertos.
GITHUB_HOST
Host de reemplazo para instancias empresariales de GitHub.
Este campo debe contener el esquema, el host y el puerto de la dirección URL deseada sin una barra diagonal final.
AUTHORIZATION_TOKEN
Token que se va a pasar a través del encabezado HTTP de autorización como "token ${AUTHORIZATION_TOKEN}".
FILE_DISAMBIGUATOR
Un token para identificar de forma única el nombre de archivo resultante si el SHA512 cambia aunque no lo haga una referencia de Git, para evitar pasar por alto el mismo nombre de archivo.
Notas
Al menos uno de REF
y HEAD_REF
debe especificarse, pero es preferible que ambos estén presentes.
Esto exporta la VCPKG_HEAD_VERSION
variable durante las compilaciones principales.