# Unity Build Automation Editor 包

> Follow this workflow to integrate the Unity Build Automation Editor package.

从 Unity 6 开始，[Unity Build Automation](/build-automation.md) 包（**2.0.0** 及更高版本）能够与 Unity 6 引入的新[构建配置文件](https://docs.unity3d.com/6000.0/Documentation/Manual/build-profiles.html)无缝配合。该包提供了一系列服务，可用于高效构建和分发应用程序。这种增强的工作流程有助于您管理多个部署目标，并将资源密集型构建任务卸载到云端，从而加快开发周期。

除了标准的本地构建之外，在 Unity 编辑器中创建新的构建配置文件时，您还可以选择开始云构建。

如果您选择 **Cloud Build（云构建）** 选项，Unity Build Automation (UBA) 系统会根据当前激活的构建配置文件和远程构建器配置，自动创建新的构建目标。这种集成简化了构建过程，让您无需使用“暂存并构建”功能手动将更改提交到代码仓库，就能在云端构建本地更改。

## 开始使用##get-started

在 Unity 编辑器中开始操作：

1. 创建新的[构建配置文件](https://docs.unity3d.com/6000.0/Documentation/Manual/create-build-profile.html)。
2. 选择 **Cloud Build（云构建）**。

此操作会提示安装最新版本的 UBA 包。


**UBA 构建配置文件初始视图:**
![UBA 构建配置文件初始视图](/api/media?file=/build-automation/media/images/build-automation/editor-package/init-build-profile-view.png "UBA 构建配置文件初始视图")

### 配置 UBA 包##configure-the-uba-package

安装该包后，配置所需的设置：

1. 选择远程构建器配置，以根据所需的偏好设置来配置包设置。
2. 再次选择 **Cloud Build（云构建）**，使用 UBA 服务在云端启动构建。


**UBA 构建器配置视图:**
![UBA 构建器配置视图](/api/media?file=/build-automation/media/images/build-automation/editor-package/build-automation-settings.png "UBA 构建器配置视图")

## 暂存##shelve-and-build

**暂存并构建**功能允许您在启动云构建时，临时**暂存**待处理的更改。此功能仅适用于使用 [**Unity Version Control (UVCS)**](/unity-version-control/get-started-vcs-hub.md) 的项目。

如果您在启动云构建时项目中有待处理的更改，则 UBA 会提示您暂存并构建。

> **Note:**
>
> **注意**：如果 UBA 未检测到待处理的更改，请尝试以下修复：
>
> * 确保正确配置了 **Unity Version Control (UVCS)**。
> * 刷新 Unity 编辑器中的 **Pending Changes（待处理更改）** 视图，以更新待处理更改的列表。

## 暂存##shelving

暂存是 **Unity Version Control** 中的一个过程，可用于临时存储待处理的更改，而无需将其提交到代码仓库。例如，您可以出于下列原因暂存待处理的更改：

* 避免提交不完整或实验性的工作。
* 使用临时更改运行构建。
* 在构建过程中切换任务或继续在本地工作。

当您触发具有未提交更改的云构建并选择**暂存并构建**功能时，Unity 会自动执行此暂存过程。

### 构建期间缺少文件##missing-files-during-build

使用“暂存并构建”功能时，请注意 UBA 不会在暂存集中包含标记为私有（未纳入版本控制）的文件。为确保构建中包含所有必要的文件：

* 使用命令 [`cm add <file_path>` ](/unity-version-control/uvcs-cli/add.md) 将任何新文件添加到版本控制中。
* 查看 `.ignore.conf` 文件，以验证规则没有排除任何重要文件（例如 `.meta` 文件）。
* 检查 Pending Changes（待处理更改）视图，以确认 UVCS 会跟踪所有所需的文件。