教程:设置 vcpkg 资产缓存
所有资产缓存都是通过 X_VCPKG_ASSET_SOURCES
环境变量进行配置的。 X_VCPKG_ASSET_SOURCES
的值遵循特定的配置语法。
在本教程中,将了解如何:
先决条件
- 终端
- vcpkg
1 - 创建资产缓存目录
你可以使用 Azure Blob 存储后端“x-azurl
”来存储资产。 或者,可以使用文件系统目录来存储下载资产,包括网络位置。 为此,你需要在资产缓存 URL 中使用 file://
协议。
在本教程中,你将创建一个本地资产缓存位置来存储已下载的项目。 如果你具有想要改用的 Azure DevOps Blob 存储,请替换 URL 并提供 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"
注意
以这种方式设置环境变量只会影响当前终端会话。 若要使这些更改在所有会话中永久存在,请通过“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
,具有读写权限。
后续步骤
下面是接下来要尝试的其他任务: