教程：设置 vcpkg 资产缓存

所有资产缓存都是通过 X_VCPKG_ASSET_SOURCES 环境变量进行配置的。 X_VCPKG_ASSET_SOURCES 的值遵循特定的配置语法。

在本教程中，将了解如何：

先决条件

你可以使用 Azure Blob 存储后端“x-azurl”来存储资产。或者，可以使用文件系统目录来存储下载资产，包括网络位置。为此，你需要在资产缓存 URL 中使用 file:// 协议。

在本教程中，你将创建一个本地资产缓存位置来存储已下载的项目。如果你具有想要改用的 Azure DevOps Blob 存储，请替换 URL 并提供 SAS 令牌作为配置字符串中的第二个参数。

mkdir D:\vcpkg\asset-cache

mkdir /home/vcpkg/asset-cache

接下来，设置 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 命令设置环境变量只会影响当前 shell 会话。要使此更改在整个会话中永久存在，需要将 export 命令添加到 shell 的配置文件脚本（例如，~/.bashrc 或 ~/.zshrc）。

此 X_VCPKG_ASSET_SOURCES 配置将添加以下源字符串：

clear，禁用以前配置的任何资产缓存
x-azurl,file:///home/vcpkg/asset-cache,,readwrite，设置一个文件系统资产缓存，该缓存位于 home/vcpkg/asset-cache，具有读写权限。

下面是接下来要尝试的其他任务：