チュートリアル: vcpkg アセット キャッシュを設定する
すべての資産キャッシュは、 X_VCPKG_ASSET_SOURCES
環境変数を使用して構成されます。 X_VCPKG_ASSET_SOURCES
の値は、特定の構成構文に従います。
このチュートリアルで学習する内容は次のとおりです。
前提条件
- ターミナル
- vcpkg
1 - 資産キャッシュ ディレクトリを作成する
Azure Blob Storage バックエンド "x-azurl
" を使用して、資産を格納できます。 または、ファイル システム ディレクトリを使用して、ネットワークの場所を含むダウンロード資産を格納することもできます。 そのためには、資産キャッシュ URL で file://
プロトコルを使用する必要があります。
このチュートリアルでは、ダウンロードした成果物を格納するローカル資産キャッシュの場所を作成します。 代わりに使用する Azure DevOps Blob Storage がある場合は、URL を置き換え、構成文字列の 2 番目のパラメーターとして SAS トークンを指定します。
- 資産キャッシュの場所として機能するディレクトリを作成します (任意の場所に置き換えます)。
mkdir D:\vcpkg\asset-cache
mkdir /home/vcpkg/asset-cache
2 - 構成 X_VCPKG_ASSET_SOURCES
次に、 X_VCPKG_ASSET_SOURCES
の値を次のように設定します。
$env:X_VCPKG_ASSET_SOURCES="clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"
Note
この方法で環境変数を設定すると、現在のターミナル セッションにのみ影響します。 これらの変更をすべてのセッションで永続的にするには、[Windows システム環境変数] パネルで設定します。
set "X_VCPKG_ASSET_SOURCES=clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"
Note
この方法で環境変数を設定すると、現在のターミナル セッションにのみ影響します。 これらの変更をすべてのセッションで永続的にするには、[Windows システム環境変数] パネルで設定します。
この X_VCPKG_ASSET_SOURCES
構成では、次のソース文字列が追加されます。
clear
をクリックすると、以前に構成された資産キャッシュが無効になります。x-azurl,file://C:/vcpkg/asset-cache,,readwrite
では、D:\vcpkg\asset-cache
にあるファイル システム資産キャッシュを読み取り/書き込みアクセス許可で設定します。
export X_VCPKG_ASSET_SOURCES="clear;x-azurl,file:///home/vcpkg/asset-cache,,readwrite"
Note
export
コマンドを使用して環境変数を設定すると、現在のシェル セッションにのみ影響します。 この変更をセッション間で永続的にするには、シェルのプロファイル スクリプト (~/.bashrc
や~/.zshrc
など) に export
コマンドを追加します。
この X_VCPKG_ASSET_SOURCES
構成では、次のソース文字列が追加されます。
clear
をクリックすると、以前に構成された資産キャッシュが無効になります。x-azurl,file:///home/vcpkg/asset-cache,,readwrite
では、home/vcpkg/asset-cache
にあるファイル システム資産キャッシュを読み取り/書き込みアクセス許可で設定します。
次のステップ
次に試すその他のタスクを次に示します。
vcpkg