Compartir a través de


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 0y, 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.

Ejemplos

Source

scripts/cmake/vcpkg_from_github.cmake