文档

支持

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

Build Automation 故障排除

Solve common issues with Build Automation failures.
阅读时间3 分钟最后更新于 19 天前

检查错误日志

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

运行全新构建

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

在本地以批处理模式运行

如果项目在编辑器中能够成功构建，但却无法通过 Unity Build Automation 进行构建，这可能是因为您使用批处理模式来生成构建。为了确定错误是否会重现，可以尝试在本地以批处理模式运行 首先，您需要删除 
Library
文件夹，或者将源代码签出到新的新文件夹，这会强制 UBA 重新下载相关包。这会模拟 UBA 构建服务器在每次构建中签出源代码的行为。 以下是同一命令的 Windows 和 macOS 版本。 所提供的目录是 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);  }}

常见问题

一般问题： 特定于平台的问题：