配置构建
Configure build settings and requirements for your Unity project using Build Automation.
阅读时间8 分钟最后更新于 19 天前
构建配置定义了用于创建项目特定构建版本的设置和要求。构建配置是一种结构化设置，它决定了项目如何编译、打包以及为在不同平台上部署做准备。创建构建配置后，您可以针对其进行多次构建尝试。配置中指定的所有设置（例如平台、Unity 版本和凭据）会自动应用于每次构建尝试，以确保所有构建之间的一致性和可重复性。 要设置构建配置，请执行以下操作：
- 登录 Unity Dashboard。
- 选择 DevOps > Build Automation > Configurations（配置）。
先决条件
在设置第一个构建配置之前，请确保已配置好项目的源代码控制设置。首次配置时必须完成此步骤。 选择 Get started（开始） 以配置源代码控制。
构建目标配置 - 配置源代码控制
选择构建配置流程
有两个选项可以设置新的构建配置：快速目标设置和目标设置。快速目标设置
如果选择 Quick target setup（快速目标设置），控制面板将显示为每个平台配置构建目标所需的基本配置。如果不想为构建目标配置高级设置，请选择 Quick target setup（快速目标设置）。
构建目标配置 - 快速目标设置
目标设置
选择 Target setup（目标设置）时，首先要设置启动构建目标所需的基本设置。然后，可以保存配置或转到高级设置。
构建目标配置 - 高级设置
基本信息
Basic Info（基本信息）部分包含用于定义构建核心设置的字段：设置 | 描述 |
|---|---|
| Target name（目标名称） | 为构建目标配置设置一个唯一名称。 |
| Branch（分支） | 选择 Build Automation 将从中拉取的分支。 |
| Project subfolder path（项目子文件夹路径）（可选） | 指定包含 |
| Unity 版本 | 选择您使用的 Unity 版本。Unity 版本控制一些高级设置的可用性，例如构建器操作系统和版本，以及无界面模式。 |
| Auto detect Unity version（自动检测 Unity 版本） | 启用此选项后，Unity Build Automation 将从项目中的 |
| Builder Operating System and Version（构建器操作系统和版本） | 选择构建机器的操作系统和版本。这受所用平台的影响。如需了解更多信息，请参阅每个构建器 OS 上支持的平台。 |
| Xcode version（Xcode 版本）（仅适用于 macOS 构建器） | 选择 Default（默认） 可使用所选操作系统的默认 Xcode 版本。选择 macOS 构建器操作系统时，会显示此选项。如需了解支持的版本，请参阅可用的 Xcode 版本指南。 |
| Unity Editor architecture（Unity 编辑器架构）（仅适用于 macOS 构建器） | 为在基于 Apple 芯片的操作系统上运行的构建指定 Unity 编辑器架构。 |
| Android SDK version（Android SDK 版本）（仅适用于 Android 版本） | 设置用于构建 Unity 项目的 Android SDK 版本。如需了解更多信息，请参阅 Android SDK 与 Unity 版本兼容性指南。 |
构建目标配置 - 基本信息
构建器配置
选择用于构建的机器规格。合适的设置取决于项目的复杂程度和平台要求。有关构建器配置的更多详细信息，请参阅选择机器规格。凭据
Credentials（凭据）部分使您能够提供 Build Automation 用于对构建进行签名的凭据，以确保构建 Artifact 的安全性和完整性。提供所需的凭据，例如 Android 的密钥库或 macOS 的签名证书。调度
Scheduling（调度）部分使您能够自动触发构建并设置定期构建计划。| 设置 | 描述 | |---|---| | Auto-build（自动构建）| 当在代码仓库中检测到更改时自动启动构建。| | Auto-cancel（自动取消）| 如果触发了新的构建，则自动取消待处理的构建。| | Build schedule（构建计划）| 使用间隔、日期和时间等选项配置重复的构建计划。| 如需了解更多详细信息，请参阅自动运行构建。Android 配置
选择 Android 作为目标平台时，会有其他构建设置可供使用。 在目标配置的 Basic Info（基本设置） 部分中，第一个设置是 Android SDK 版本。使用此设置可选择首选的 Android SDK 版本，具体取决于所选的 Unity 版本。如需了解更多信息，请参阅 Android SDK 与 Unity 版本兼容性指南。 其余特定于 Android 的设置位于 Advanced Settings（高级设置） 中的 Platform specific settings (Android)（针对特定平台的设置 (Android)） 下。设置 | 描述 |
|---|---|
| Build app bundles (.aab) instead of an APK（构建应用程序捆绑包 (.aab) 而不是 APK） | Android 应用程序捆绑包是一种上传格式，其中包含您应用程序的所有已编译代码和资源，但会将 APK 生成和签名推迟到 Google Play 进行。您还必须使用 Gradle 构建系统。如需了解更多信息，请参阅 Android 应用程序捆绑包文档。 |
| Build asset packs（构建资源包） | 仅在构建应用程序捆绑包时，构建资源包才可用。如果启用此选项，Unity Build Automation 将使用来自 Google Play Unity 插件的 Google Play 构建方法来构建带有资源包的应用程序捆绑包。您需要在项目中安装该插件。您还必须在构建前脚本中以编程方式配置资源包，并调用 |
| Make split binary application builds（进行拆分二进制应用程序构建） | 此设置会设定 |
构建目标配置 - Android 设置
通用 Windows 平台配置
当所选目标平台为通用 Windows 平台 (UWP) 时，会有其他构建设置可供使用。通过这些设置可以对如何构建 UWP 应用程序以及如何配置目标设备进行精细控制。 如需全面了解 UWP 设置，请参阅 UWP 构建设置文档。 目标配置的 Basic Info（基本设置） 部分包含以下特定于 UWP 的选项：设置 | 描述 |
|---|---|
| Visual Studio version（Visual Studio 版本） | 定义用于构建 UWP 应用程序的 Visual Studio 版本。如果使用的是 Unity 2022.2 或更高版本，则无论此设置如何，都会自动选择最新的 Visual Studio 版本。 |
| Windows SDK version（Windows SDK 版本） | 设置使用 Visual Studio 进行构建时应用程序所针对的 Windows SDK 版本。这取决于所选的 Visual Studio 版本。 |
| Build type（构建类型） | 确定 Unity 生成的 UWP 构建输出的类型。可用选项包括： |
| 构建配置 | 指定 Visual Studio 项目输出的优化级别。选项包括： |
| Target device family（目标设备系列） | 定义应用程序支持的 UWP 设备系列。默认情况下，此选项设置为 |
构建目标配置 - UWP 基本设置
设置 | 描述 |
|---|---|
| Application Capabilities（应用程序功能） | 指定应用程序期望使用的系统资源和功能的功能。如需了解更多详细信息，请参阅功能属性文档。 |
| Executable-only CPU architecture（仅限可执行文件的 CPU 架构） | 仅当 build type（构建类型） 设置为 |
| Targeted CPU platform（目标 CPU 平台） | 仅当 build type（构建类型） 设置为 |
构建目标配置 - UWP 高级设置