ドキュメント

サポート

Unity Build Automation での Android ビルドの失敗

Resolve Android build failures in Unity Build Automation and identify common causes.
読み終わるまでの所要時間 1 分最終更新 1ヶ月前

事象

  • 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 (チケットを提出) を選択します。

追加リソース