vcpkg_download_distfile

이 포트에 필요한 파일을 다운로드하고 캐시합니다.

이 도우미는 자산 캐싱과 같은 기능을 사용할 수 있으므로 CMake의 기본 제공 file(DOWNLOAD) 명령 대신 항상 사용해야 합니다.

가능하면 다음 중 vcpkg_from_ 하나와 같이 이 함수를 직접 호출하는 대신 함수 중 하나를 사용해야 합니다.

사용

vcpkg_download_distfile(
    <OUT_VARIABLE>
    URLS <http://mainUrl> <http://mirror1>...
    FILENAME <output.zip>
    SHA512 <5981de...>
    [ALWAYS_REDOWNLOAD]
)

매개 변수

OUT_VARIABLE

이 변수는 다운로드한 파일의 전체 경로로 설정됩니다. 그런 다음 소스에 vcpkg_extract_source_archive 대해 즉시 전달할 수 있습니다.

Url

참조할 URL 목록입니다. 다운로드한 파일 중 하나가 지정된 SHA512와 성공적으로 일치할 때까지 순서대로 시도됩니다.

파일

파일의 로컬 이름입니다. 파일은 포트 간에 공유되므로 이 포트의 특성을 명확하게 지정하고 충돌을 방지하기 위해 파일의 이름을 바꿔야 할 수 있습니다.

SHA512

파일에 대한 예상 해시입니다.

다운로드한 버전과 일치하지 않으면 불일치를 설명하는 메시지와 함께 빌드가 종료됩니다.

조용한

캐시 적중 량에 대한 출력 표시 안 함

SKIP_SHA512

파일에 대한 SHA512 해시 검사 건너뜁니다.

이 스위치는 명령줄 플래그를 사용하여 빌드할 --head 때만 유효합니다.

ALWAYS_REDOWNLOAD

캐싱을 방지합니다. REST 호출이거나 불안정합니다.

SKIP_SHA512가 필요합니다.

HEADERS

다운로드 요청에 추가할 헤더 목록입니다. 다운로드하는 동안 인증에 사용할 수 있습니다.

헤더는 .로 "<header-name>: <header-value>"지정해야 합니다.

주의

vcpkg_from_github 도우미는 GitHub 프로젝트에서 다운로드하는 데 사용해야 합니다.

예제

원본

scripts/cmake/vcpkg_download_distfile.cmake