在 Unity Cloud Build 中使用可寻址资源

Addressable Assets are assets that have a unique address which you can use to load them from local or remote AssetBundles.

先决条件

您必须执行以下操作，然后才能在 Cloud Build 中构建可寻址资源：

• 转换您的项目从而在本地使用可寻址资源，即：
• Install the Addressables package
• 将资源设置为可寻址
• 将更新的项目提交到所选的版本控制系统 (VCS)

Unity 建议您先确保能够在本地使用可寻址资源，然后再使用 Cloud Build 构建这些资源。

配置构建目标

如果要从全新的 Cloud Build 项目开始，需要先创建新的构建目标。

1. 从 Cloud Build Dashboard 中，导航到项目的构建目标 Config 页面。
2. 在需要构建可寻址资源的构建目标上，展开 Addressable Assets Options 菜单。
3. 单击 Edit Addressable Asset Options。

在 Addressables Options 页面上，可以配置一些属性来确定可寻址资源构建过程的行为。每个属性都在工具提示中提供了更详细的描述。

运行新的可寻址资源构建

要运行新的可寻址资源构建，请执行以下操作：

1. 单击 Edit Addressables Asset Options。
2. 启用 Build Addressables。
3. 保存目标配置。
4. 构建该目标。

启用 Cloud Content Delivery 服务

If you want to upload Addressables to the Cloud Content Delivery (CCD) service from Cloud Build:

1. 单击 Edit Addressables Asset Options。
2. 启用 Content Delivery Upload 以将可寻址资源上传到 CCD。
3. 在 Content Delivery Bucket 下拉选单中选择所需 CCD 存储桶。
4. Content Delivery API Key 字段中应已填充了相应内容。如果没有，请添加它。
5. 如果需要从所选存储桶自动创建 CCD 发布版本，则启用 Content Delivery Create Release。
6. 保存目标配置。
7. 构建目标。

See Addressable Asset system with Cloud Content Delivery for more information about using Addressables with CCD.

运行内容更新构建

内容更新构建使用新的可寻址内容来更新以前构建的播放器。

要更新现有播放器，更新构建需要一个内容状态文件。这会将更新构建的内容链接到现有播放器。进行新的可寻址资源构建时，会生成内容状态文件。

要使用新的可寻址资源来更新以前构建的播放器，请执行以下操作：

1. 单击 Edit Addressables Asset Options。
2. 启用 Build Addressables 和 Content Update Build。
3. 启用 Content Only Build（除非您想生成另一个播放器）。
4. 设置 Content State Location Method 以定义 Cloud Build 如何获取内容状态文件。
   Cloud Build 可以通过以下方式获取此文件。
   • 通过源代码控制；在此情况下，您必须指定路径。
   • 通过先前已成功构建可寻址资源的现有构建目标；在此情况下，您必须指定目标。

Cloud Build 可以自动使用所选构建目标生成的最新内容状态文件。

启动构建

配置构建目标后，要启动新的可寻址资源构建，请执行以下操作：

1. 导航到控制面板的 Build History 页面。
2. 构建需要配置可寻址资源的目标。

成功完成新构建后，此构建的 More 菜单 (⋮) 可显示 Download Addressable Assets 选项。

将可寻址资源内容从 Cloud Build 复制到您的托管服务提供商

完成可寻址资源构建后，可以将可寻址资源内容从 Cloud Build 复制到托管服务提供商。可以手动或者使用构建后脚本来执行此操作。

手动复制可寻址资源内容

完成可寻址资源构建后，从 More 菜单 (⋮) 中选择 Download Addressables Assets。下载内容后，您可以像在本地进行构建一样，将内容上传到托管服务提供商。

使用构建后脚本来复制可寻址资源内容

Cloud Build 支持在构建之前或之后运行自定义 shell 脚本。您可以创建构建后脚本，从而在构建成功完成后自动上传您的可寻址资源内容。

要启用构建后脚本，请执行以下操作：

1. 访问 Cloud Build Config 页面。
2. 在您的构建目标上，选择 Edit Advanced Options。
3. 在 Post-Build Script Path 字段中，输入脚本的路径。

在编写脚本时，以下提示可能很有用：

• 构建的可寻址资源内容位于 $WORKSPACE/.build/last/<BUILD_TARGET_ID>/extra_data/addrs/

• 可以在 Build Target Config 页面中，设置密钥的环境变量