文档

​
​

Development

User Acquisition

Monetization

工业

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
    • Build Addressables using Build Automation
    • Run custom scripts during the build process
    • Specify the scene to build
    • Customize Fastlane configurations for iOS builds
    • Configure dedicated server build target
    • Use environment variables
  • Run builds
  • Check build results
  • Optimize build speed
  • Manage consumption costs
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  3. Advanced build configuration

使用 Build Automation 构建 Addressables

Follow this workflow to build Addressable Assets.
阅读时间6 分钟
最后更新于 7 个月前
可寻址资源是具有唯一地址的资源，您可以利用该地址从本地或远程 AssetBundles 加载这些资源。

先决条件

在 Build Automation 中构建可寻址资源之前，必须：
  • 在本地将项目转换为使用 Addressables：
    • 安装 Addressables 包。
    • 将 Assets（资源）设置为 Addressable（可寻址）。
  • 将更新后的项目提交到所选的版本控制系统 (VCS)。

构建配置

要从新的 Build Automation 项目开始，需要首先创建新的构建配置。
  1. 登录 Unity Dashboard。
  2. 选择 DevOps > Build Automation > Configurations（配置）。
  3. 选择要为其构建 Addressables 的构建配置。
  4. 选择 Edit（编辑）。
  5. 从 Advanced settings（高级设置） 选项卡中，选择 Yes, build Addressables（是，构建 Addressables）。
使用 Addressables 部分来配置相关属性，这些属性将决定可寻址资源构建过程的行为方式。工具提示更详细地描述了每个属性。

运行新的 Addressables 构建

要运行新的 Addressables 构建，请执行以下操作：
  1. 转到 DevOps > Build Automation > Configurations（配置）。
  2. 选择已配置 Addressables 设置的构建配置。
  3. 选择 Build（构建）。
有关更多信息，请参阅手动运行构建。

启用 Cloud Content Delivery 服务

要从 Build Automation 将 Addressables 上传到 Cloud Content Delivery (CCD) 服务，请执行以下操作：
  1. 从构建目标的高级设置中，导航到 Addressables 部分。
  2. 选择 Upload Addressables to the Cloud Content Delivery service（将 Addressables 上传到 Cloud Content Delivery 服务）。
  3. 在 Content Delivery Bucket（Content Delivery 存储桶） 下拉选单中，选择所需的 CCD 存储桶。
  4. 如果 Content Delivery API Key（Content Delivery API 密钥） 字段中未填充 API 密钥，请添加该 API 密钥。
  5. 要从所选存储桶自动创建 CCD 版本，请选择 Automatically create a Cloud Content Delivery release from the bucket（自动从存储桶创建 Cloud Content Delivery 版本）。
  6. 选择 Save and build（保存并构建）。
有关将 Addressables 与 CCD 结合使用的更多信息，请参阅 CCD + Addressables 演练。

运行内容更新构建

内容更新构建使用新的可寻址资源内容更新先前构建的播放器。
要更新现有的播放器，更新构建需要一个内容状态文件。这会将更新构建中的内容与现有播放器关联起来。执行新的 Addressables 构建时，会生成内容状态文件。
要使用新的可寻址资源更新先前构建的播放器，请执行以下操作：
  1. 选择 Edit Addressables Asset Options（编辑 Addressables 资源选项）。
  2. 选择 Yes, build Addressables（是，构建 Addressables） 和 Make a content-update build（进行内容更新构建）。
  3. 选择 Make a content-only build（进行仅内容构建），除非要生成另一个播放器。
  4. 设置内容状态文件位置方法，以定义 Build Automation 如何获取内容状态文件。
    Build Automation 可通过下列方式获取此文件。
    • 要从源代码控制获取该文件，请指定路径。
    • 要从先前已成功构建 Addressables 的现有构建目标获取该文件，请指定目标。
Build Automation 可以自动使用所选构建目标生成的最新内容状态文件。

开始构建

配置构建目标后，要启动新的 Addressables 构建，请执行以下操作：
  1. 导航到 Build Automation 和 Build History（构建历史记录）。
  2. 构建已为其配置 Addressables 的目标。有关如何运行构建的更多信息，请参阅手动运行构建。
当新的构建成功完成后，构建的“更多”菜单 (⋮) 将显示 Download Addressable Assets（下载可寻址资源） 选项。

将 Addressables 内容从 Build Automation 复制到托管提供商

完成 Addressables 构建后，可以将 Addressables 内容从 Build Automation 复制到托管提供商。您可以手动复制内容，也可以使用构建后脚本。

手动复制 Addressables 内容

完成 Addressables 构建后，从“更多”菜单 (⋮) 中选择 Download Addressables Assets（下载 Addressables 资源）。下载内容时，可以在本地构建时将其上传到托管提供商。

使用构建后脚本复制 Addressables 内容

Build Automation 支持在构建之前或之后运行自定义 shell 脚本。您可以创建构建后脚本，以便在构建成功完成时自动上传 Addressables 内容。
要启用构建后脚本，请执行以下操作：
  1. 导航到 Build Automation Configurations（配置） 页面。
  2. 在构建目标上，选择 Edit Advanced Options（编辑高级选项）。
  3. 在 Post-Build Script Path（构建后脚本路径） 字段中，输入脚本的路径。
编写脚本时，请考虑以下信息：
  • 构建的可寻址资源内容位于 
    $OUTPUT_DIRECTORY/extra_data/addrs
    。
  • 您可以在构建目标 Configurations（配置） 页面中为密钥设置环境变量。
Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择（Cookie 设置）

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标（此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见，一些页面是机器翻译的，可能包含不准确的内容。如有信息不一致的情况，以英文版本为准。

  • 在本页上

    • 先决条件

    • 构建配置

      • 运行新的 Addressables 构建

      • 启用 Cloud Content Delivery 服务

      • 运行内容更新构建

    • 开始构建

    • 将 Addressables 内容从 Build Automation 复制到托管提供商

      • 手动复制 Addressables 内容

      • 使用构建后脚本复制 Addressables 内容

报告此页面的问题