Build Automation 故障排除
Solve common issues with Build Automation failures.
阅读时间3 分钟最后更新于 9 个月前
检查错误日志
对任何 Unity Build Automation (UBA) 问题进行故障排除的第一步是检查错误日志。 UBA 日志会以红色突出显示错误消息，以黄色突出显示警告消息，以提高消息的可见性。UBA 还会在精简日志选项卡中收集所有的警告和错误消息，以便于查找，但并非所有故障都会记录在精简日志中，因此检查完整日志可能会有所帮助。如果有多个错误日志，并且您之前有过成功的构建记录，则可以比较这些日志，以过滤掉成功构建过程中可能出现的任何错误。运行全新构建
如果 UBA 构建缓存库文件夹或工作空间文件夹，可能会导致问题。要强制目标忽略缓存，请在触发构建时使用 Clean Build（全新构建） 选项。在本地以批处理模式运行
如果项目在编辑器中能够成功构建，但却无法通过 Unity Build Automation 进行构建，这可能是因为您使用批处理模式来生成构建。为了确定错误是否会重现，可以尝试在本地以批处理模式运行 首先，您需要删除Library注意
注意：其中几个标志不是必需的。如果不想运行单元测试，可以跳过 、 和 等标志。
-testPlatform-testResults-runTestsWindows 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); }}