vcpkg_download_distfile

このポートに必要なファイルをダウンロードしてキャッシュします。

このヘルパーは、CMake の組み込みの file(DOWNLOAD) コマンドの代わりに常に使用する必要があります。これは、 Asset Caching などの機能を有効にしているためです。

可能であれば、次のような、この関数を直接呼び出すのではなく、 vcpkg_from_ 関数のいずれかを使用する必要があります。

• vcpkg_from_bitbucket
• vcpkg_from_git
• vcpkg_from_github
• vcpkg_from_gitlab
• vcpkg_from_sourceforge

使用法

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

パラメーター

OUT_VARIABLE

この変数は、ダウンロードしたファイルへの完全なパスに設定されます。 これにより、ソースの vcpkg_extract_source_archive にすぐに渡すことができます。

URLS

参照する URL の一覧。 ダウンロードされたファイルの 1 つが指定された SHA512 と正常に一致するまで、順番に試されます。

FILENAME

ファイルのローカル名。 ファイルはポート間で共有されるため、ファイルの名前を変更して、このポートに明確に属性を付け、競合を回避する必要がある場合があります。

SHA512

ファイルの予想されるハッシュ。

これがダウンロードしたバージョンと一致しない場合、ビルドは、不一致を説明するメッセージで終了します。

静か

キャッシュ ヒット時の出力を抑制する

SKIP_SHA512

ファイルの SHA512 ハッシュ チェックをスキップします。

このスイッチは、 --head コマンド ライン フラグを使用してビルドする場合にのみ有効です。

ALWAYS_REDOWNLOAD

キャッシュを回避する。これは REST 呼び出しであるか、それ以外の場合は不安定です。

SKIP_SHA512 が必要です。

ヘッダー

ダウンロード要求に追加するヘッダーの一覧。 これは、ダウンロード中の認証に使用できます。

ヘッダーは "<header-name>: <header-value>"として指定する必要があります。

例

• apr

ソース

scripts/cmake/vcpkg_download_distfile.cmake