文档

​
​

Development

User Acquisition

Monetization

工业

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Check build results
    • Troubleshooting Build Automation failures
      • Builds fail immediately
      • Unrecognized project error
      • Clone hangs when you use Git submodules
      • Lightmap baking
      • Android build failures
      • Errors after migration to a new Xcode version
      • macOS notarization failure
      • Problems with iOS Build Automation during XCode export
      • iOS build can't download or install from Unity Build Automation
  • Optimize build speed
  • Manage consumption costs
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  2. Build results
  3. Troubleshoot Build Automation failures

Android 构建在 Unity Build Automation 中失败

Resolve Android build failures in Unity Build Automation and identify common causes.
阅读时间3 分钟
最后更新于 10 个月前

症状

  • 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 版本或 SDK 版本时,构建就会开始失败。
如果项目在本地能够构建,请记录所使用的工具版本,并确保它们与在 Unity Build Automation 服务中使用的版本相匹配。要检查 Gradle 的本地版本,可以在终端中使用命令
gradle --version
。
如果本地在
batchmode
下能够正常构建,但使用相同的工具和版本在 Unity Build Automation 服务中却构建失败,请提交支持工单,以便支持团队可以进一步调查。要从 Unity Dashboard 提交工单,请打开 DevOps,然后选择 Help & Support(帮助与支持)> Ticket(工单)> File a ticket(提交工单)。

其他资源

  • 按编辑器版本显示的默认 Android 工具

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • 症状

    • 原因

    • 解决方案

    • 其他资源


报告此页面的问题