Version: 2020.2
包含特定场景
编译清单

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

可寻址资源是具有唯一地址并可以从任何位置调用的资源。

先决条件

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

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

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

配置构建目标

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

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

Addressables Options 页面包含一些属性可用于配置可寻址资源的构建过程行为。每个属性都在工具提示中提供了更详细的描述。

运行新的可寻址资源构建

要构建新的可寻址资源构建,请执行以下操作:

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

运行内容更新构建

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

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

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

  1. 单击 Edit Addressables Asset Options
  2. 启用 Build AddressablesContent 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 页面中,设置密钥的环境变量

  • 2018.3 中添加了 [FeatureName] NewIn20183
包含特定场景
编译清单