文档

支持

Android 构建在 Unity Build Automation 中失败

Resolve Android build failures in Unity Build Automation and identify common causes.
阅读时间2 分钟最后更新于 19 天前

症状

  • Android 构建因不明原因失败。
  • Android 构建失败,而其他目标构建正常。
  • Android 构建在 UBA 中失败,但在本地构建正常。

原因

Unity Build Automation 通过以
batchmode
运行 Unity 编辑器来执行构建,并使用默认的 Android 工具 (JDK/SDK) 来完成构建。当 Android 构建在该服务中失败,但在本地正常,或者其他目标似乎构建正常时,根本原因通常是 Android 工具不兼容。
由 Android 工具导致的失败通常在日志中会有
Gradle Build failed
消息。Gradle 是 Unity 用于 Android 构建的构建系统。

解决方案

解决此问题的第一步是确保能够使用以下工具版本以批处理模式在本地构建项目:
  • Unity 编辑器。
  • JDK(所选编辑器版本附带的默认版本)。
  • Android SDK(默认版本或高级目标配置中指定的版本)。
另外还需要验证所使用的 Gradle 版本。 如果项目在本地能够构建,请记录所使用的工具版本,并确保它们与在 Unity Build Automation 服务中使用的版本相匹配。要检查 Gradle 的本地版本,可以在终端中使用命令
gradle --version
如果本地在
batchmode
下能够正常构建,但使用相同的工具和版本在 Unity Build Automation 服务中却构建失败,请提交支持工单,以便支持团队可以进一步调查。要从 Unity Dashboard 提交工单,请打开 DevOps,然后选择 Help & Support(帮助与支持)> Ticket(工单)> File a ticket(提交工单)

其他资源