Android Studio のインストール

Setting Up Android SDK and NDK for Unreal の内容を参考に、Android Studio 4.0 をインストールしていく。ちなみに記事の中に「SetupAndroid.bat」を実行するという記述があるが私の環境だと失敗していた。

必要なソフトウェアのインストール

Android Studio を起動後、Configure -> SDK Manager を立ち上げる。左のツリーから「Android SDK」を選択して下記にチェックを入れていく。

• SDK Platform タブから「Android API 31」を導入（それ以上のバージョンのものはチェックを外す）
• SDK Tools タブから「Android SDK Build-Tools 30.0.3」を導入（それ以上のバージョンのものはチェックを外す）
• SDK Tools タブから「Android SDK Command-line Tools 8.0」を導入
• SDK Tools タブから「NDK 21.4.xxxx」を導入

この時、ウインドウの右下の「Show Package Details」にチェックを入れないと、任意のバージョンを指定できないので注意。必ずチェックを入れる。

UE4 の Project Settings

Edit -> Project Settings から Platforms Android SDK 選択。それぞれのパスを設定していく。

Location of Android SDK
C:/Users/Name/AppData/Local/Android/Sdk

Location of Android NDK
C:/Users/Name/AppData/Local/Android/Sdk/ndk/21.4.7075529

Location of JAVA
C:/Program Files/Java/jdk1.8.0_77
or
C:/Program Files/Android/Android Studio/jre/jre

最初は Android Studio の下のパスを設定していたが、エラーが出たので JDK のパスに書き換えた。JDK 1.8.0_77 はこちらのサイトを参考にインストール。オラクルのサイトから jdk-8u77-windows-x64.exe をダウンロード。

apk 作成

apk を作成する場合は「Android (ASTC)」を選択する。

ビルドエラー

UATHelper: Packaging (Android (ASTC)): ERROR: cmd.exe failed with args /c "C:\Users\Name\Desktop\MyProject\Intermediate\Android\armv7\gradle\rungradle.bat" :app:assembleDebug
UATHelper: Packaging (Android (ASTC)):        (see C:\Users\Name\AppData\Roaming\Unreal Engine\AutomationTool\Logs\D+Program+Files+Epic+Games+UE_4.27\Log.txt for full exception trace)
UATHelper: Packaging (Android (ASTC)): AutomationTool exiting with ExitCode=1 (Error_Unknown)
UATHelper: Packaging (Android (ASTC)): BUILD FAILED
PackagingResults: Error: cmd.exe failed with args /c "C:\Users\Name\Desktop\MyProject\Intermediate\Android\armv7\gradle\rungradle.bat" :app:assembleDebug
PackagingResults: Error: Unknown Error

このエラーが出た場合は、上記の Android SDK Manager からインストールの設定を見直す。

Andorid に apk をインストール

package 化が成功したらフォルダの中に Android_ASTC/Install_MyProject-armv7.bat があるのでこれを叩く。PC と端末が USB 接続されていれば、インストールされる。

Stat コマンド

画面上を4本指でタップすると、コマンド入力用のダイアログが出現する。よく使うコマンドに関しては、プルダウンで選択できる。ソフトウェアキーボードで任意の入力も可能。

UE4CommandLine.txt

Android はアプリ起動時に引数は設定できないので、何かオプションを渡したい場合は UE4CommandLine.txt に記述して Android デバイス内に保存する。具体的なパスは下記になるはず。

sdcard/UE4Game/YourProject/UE4CommandLine.txt

例えば Memory 周りを見たいときは、この txt の中に「-llm」と記述して「stat llm」で確認できる。

adb コマンド

adb コマンドを使用して UE4CommandLine.txt を端末とやり取りする。

#YourProject 以下のファイル一覧を表示する
adb ls sdcard/UE4Game/YourProject

#YourProject以下の UE4CommandLine.txt を PC にコピー
adb pull sdcard/UE4Game/YourProject/UE4CommandLine.txt

#PC の UE4CommandLine.txt を端末にコピー
adb push UE4CommandLine.txt sdcard/UE4Game/YourProject/UE4CommandLine.txt

参考

https://docs.unrealengine.com/4.27/en-US/SharingAndReleasing/Mobile/Android/
https://www.slideshare.net/EpicGamesJapan/igf2018-ue4android-indie-games-festival-2018