英語で読む

次の方法で共有


チュートリアル: 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 トークンを指定します。

  1. 資産キャッシュの場所として機能するディレクトリを作成します (任意の場所に置き換えます)。
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"

注意

この方法で環境変数を設定すると、現在のターミナル セッションにのみ影響します。 これらの変更をすべてのセッションで永続的にするには、[Windows システム環境変数] パネルで設定します。

set "X_VCPKG_ASSET_SOURCES=clear;x-azurl,file://D:/vcpkg/asset-cache,,readwrite"

注意

この方法で環境変数を設定すると、現在のターミナル セッションにのみ影響します。 これらの変更をすべてのセッションで永続的にするには、[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"

注意

export コマンドを使用して環境変数を設定すると、現在のシェル セッションにのみ影響します。 この変更をセッション間で永続的にするには、シェルのプロファイル スクリプト (~/.bashrc~/.zshrcなど) に export コマンドを追加します。

この X_VCPKG_ASSET_SOURCES 構成では、次のソース文字列が追加されます。

  • clearをクリックすると、以前に構成された資産キャッシュが無効になります。
  • x-azurl,file:///home/vcpkg/asset-cache,,readwriteでは、 home/vcpkg/asset-cacheにあるファイル システム資産キャッシュを読み取り/書き込みアクセス許可で設定します。

次のステップ

次に試すその他のタスクを次に示します。