Build Automation 故障排除

Solve common issues with Build Automation failures.

阅读时间4 分钟

最后更新于 10 个月前

检查错误日志

对任何 Unity Build Automation (UBA) 问题进行故障排除的第一步是检查错误日志。

UBA 日志会以红色突出显示错误消息，以黄色突出显示警告消息，以提高消息的可见性。UBA 还会在精简日志选项卡中收集所有的警告和错误消息，以便于查找，但并非所有故障都会记录在精简日志中，因此检查完整日志可能会有所帮助。如果有多个错误日志，并且您之前有过成功的构建记录，则可以比较这些日志，以过滤掉成功构建过程中可能出现的任何错误。

运行全新构建

如果 UBA 构建缓存库文件夹或工作空间文件夹，可能会导致问题。要强制目标忽略缓存，请在触发构建时使用 Clean Build（全新构建） 选项。

在本地以批处理模式运行

如果项目在编辑器中能够成功构建，但却无法通过 Unity Build Automation 进行构建，这可能是因为您使用批处理模式来生成构建。为了确定错误是否会重现，可以尝试在本地以批处理模式运行

首先，您需要删除

Library

文件夹，或者将源代码签出到新的新文件夹，这会强制 UBA 重新下载相关包。这会模拟 UBA 构建服务器在每次构建中签出源代码的行为。

以下是同一命令的 Windows 和 macOS 版本。

注意

注意：其中几个标志不是必需的。如果不想运行单元测试，可以跳过

-testPlatform

、

-testResults

和

-runTests

等标志。

所提供的目录是 Unity 编辑器的默认安装文件夹；请根据本地计算机上的正确路径进行调整。

Windows CMD 控制台


"C:\Program Files\Unity\Hub\Editor\{UNITY_VERSION}\Editor\unity.exe" -batchMode -skipMissingProjectID -skipMissingUPID -buildTarget {BUILD_TARGET} -logFile C:\{SOME_PATH}\log.txt -projectPath C:\{PROJECT_PATH} -executeMethod {CLASS_AND_STATIC_METHOD_NAME_OF_BUILD_SCRIPT} -quit

macOS 终端


/Applications/Unity/Hub/Editor/{UNITY_VERSION}/Unity.app/Contents/MacOS/Unity -batchMode -skipMissingProjectID -skipMissingUPID -buildTarget {BUILD_TARGET} -logFile /Users/{SOME_PATH}/log.txt -projectPath /Users/{PROJECT_PATH} -executeMethod {CLASS_AND_STATIC_METHOD_NAME_OF_BUILD_SCRIPT} -quit

如果还想运行测试，可以添加以下标签：

```
-runTests
```

-testPlatform {PLATFORM} // playmode or editmode

-testResults {FILE_PATH_AND_FILE_NAME}.xml

模板构建脚本

将包含执行构建的静态方法的构建脚本放在 Editor 文件夹中。如果还没有 Editor 文件夹，请创建一个。

以下是供您参考的模板构建脚本：


using UnityEditor;class MyEditorScript{  static void PerformBuild ()  {    BuildPlayerOptions buildPlayerOptions = new BuildPlayerOptions();    buildPlayerOptions.scenes = new[] {"Assets/Scenes/MyScene.unity", ...};    buildPlayerOptions.target = BuildTarget.iOS; // More details on BuildTarget doc    buildPlayerOptions.options = BuildOptions.None;    buildPlayerOptions.locationPathName = "iOSBuild";    BuildPipeline.BuildPlayer(buildPlayerOptions);  }}

常见问题

一般问题：

特定于平台的问题：

文档

Development

User Acquisition

Monetization

工业

文档

Development

User Acquisition

Monetization

工业