Unreal Engine 4.26.2 Androidへビルドする際に発生したエラーと解決方法

目次

1. はじめに
2. 開発環境
3. SetupAndroidが正しく実行できない
4. ビルド時にエラーが発生する
5. アプリ起動時にエラーメッセージが表示される
6. おわりに

はじめに

以下のサイトを参考に進めました。

Unreal Engine 4.25.4であれば特にエラーが発生することなくAndroidへビルドできたのですが、Unreal Engine 4.26.2ではエラーでつまづくことが多かったので、他の方が参考にしていただくために記事を書きました。

私はUnreal Engineをはじめて1ヶ月程度の初心者なので、もし記事に間違いなどありましたら、ご指摘していただけると助かります。

開発環境

パソコン： Mac OS Catalina 10.15.7
Unreal Engineのバージョン：4.26.2

SetupAndroidが正しく実行できない

上記のサイトの「3. Android NDK r21b を使用するように Unreal を設定する」で「SetupAndroid.command (Mac)」を実行する際に、途中でエラーが発生してしまう現象です。

この原因は、Android Studioを「最新の安定版」にしていたことでした。
「Android Studio 4.0」にインストールし直すことで解決しました。

ビルド時にエラーが発生する

Windowsでも同様のエラーが発生することがあるようです。
Unreal Engine 4.26.2でAndroidへビルドする際に、おそらく発生する可能性が高いと思うのですが、私は解決方法が見つけられずに10時間ほど途方に暮れていました…。

以下のサイトの「5 - Android デバイスを起動する」のビルド時に、エラーが発生する現象です。

原因は様々なものがあるため、この方法で必ず解決するとは限りません。
一例としてエラーの内容と解決方法を掲載しています。

発生したエラー

エラーメッセージでGoogle検索をする方のために文章でも掲載しておきます。

LogPlayLevel: Build-tool 31.0.0 is missing DX at /Users/aguroshou/Library/Android/sdk/build-tools/31.0.0/dx
LogPlayLevel: File /Users/aguroshou/.android/repositories.cfg could not be loaded.
LogPlayLevel: Build-tool 31.0.0 is missing DX at /Users/aguroshou/Library/Android/sdk/build-tools/31.0.0/dx
LogPlayLevel: FAILURE: Build failed with an exception.
LogPlayLevel: * What went wrong:
LogPlayLevel: Could not determine the dependencies of task ':app:compileDebugJavaWithJavac'.
LogPlayLevel: > Installed Build Tools revision 31.0.0 is corrupted. Remove and install again using the SDK Manager.
LogPlayLevel: * Try:
LogPlayLevel: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.
LogPlayLevel: * Get more help at https://help.gradle.org
LogPlayLevel: BUILD FAILED in 37s
LogPlayLevel: Error: ERROR: /bin/sh failed with args -c '"/Users/aguroshou/Desktop/UE4_426_AndroidBuild/Intermediate/Android/armv7/gradle/gradlew" :app:assembleDebug'
LogPlayLevel: (see /Users/aguroshou/Library/Logs/Unreal Engine/LocalBuildLogs/Log.txt for full exception trace)
LogPlayLevel: AutomationTool exiting with ExitCode=1 (Error_Unknown)
LogPlayLevel: Completed Launch On Stage: Build Task, Time: 44.677315
LogPlayLevel: Error: RunUAT ERROR: AutomationTool was unable to run successfully.
PackagingResults: Error: Launch failed! Unknown Error

このエラーの中で、「LogPlayLevel: Build-tool 31.0.0 is missing DX at /Users/aguroshou/Library/Android/sdk/build-tools/31.0.0/dx」が原因でした。
パスの中身を確認すると、たしかに「dx」というファイルがありませんでした。

解決のために、以下のサイトを参考にしました。

AndroidStudioを開き、Configure→SDK Managerを開きます。

左の欄のSystemSettings→Android SDK→右下のShow Package Detailsをチェック→中央のAndroid SDK Build-Tools 31の中の「31.0.0」のチェックを外し、「30.0.3」をチェックして「Apply」ボタンを押します。

※ 31.0.0から30.0.3へ変更したことによる影響は把握できていません。

この状態でAndroidへビルドを行うと、エラーが解決しました。

ちなみにですが、以下のサイトの「SDK パスを手動で指定する」の手順は行わず、Android　SDKのパスが空欄の状態でビルドを行うことができました。

アプリ起動時にエラーメッセージが表示される

Androidでアプリを開くと、以下の画像のエラーメッセージがはじめに表示されました。

解決のために、以下のサイトを参考にしました。

UnrealEngineのEdit→Plugins→左の欄のBuilt-In→Virtual Realityをクリック→Oculus VRとSteam VRの「Enabled」チェックを外す→右下の「Restart Now」でUnrealEngineを再起動します。

この状態でもう一度ビルドを行うと、先ほどのエラーメッセージが表示されなくなると思います。

おわりに

もしよろしければ、今回の手順でエラーが解決したか、解決しなかったか、それとも他の方法を参考にしたかなど、コメントなどを書いてくださると他の方が参考になるのでぜひお願いします！

Unreal Engine 4.26でのAndroidのビルドは不具合が多い印象があるので、どうしてもエラーが解決できないのであればUnreal Engine 4.25をインストールしてみてビルドテストを行うことも良いかもしれません。
（ただ、Unreal Engineはプロジェクトのダウングレードができないようなので、既に開発を4.26で進めているのであれば使えない方法です。）