UE 4.13 で作ったレベルを Android デバイス上で動かそうと思ったときの覚書です。
公式ドキュメントはあるものの……
Android 開発のスタートアップガイドは UE4 の公式ドキュメントに用意されています。
しかし、今回はこの手順は使いませんでした。
というのも……
- Unity を使う上で、Android SDK などのツール群を既に入れていた。
- 過去に公式ドキュメントどおりにやっても「Launch」のデバイス一覧に Android デバイスが列挙されなかったことがあった。
などの理由があったためです。
ですので、今回は公式ドキュメントに頼らずにやってみることにしました。
今回やった手順
今回はこちらのサイトを参考にさせていただきました。
手順はすべてこのサイトに載っているとおりにやっています。
今回インストールしたものの一覧と、バージョンを下記に載せておきます。
| インストールしたもの | バージョン |
|---|---|
| JDK | 8u102(windows x64) |
| Android Studio | 2.2 |
| Android SDK | Android 5.0(Lollipop) |
| Android NDK | 13.0.3315539 |
| Apache Ant | 1.9.7 |
躓いたところとその解決策
この手順に従って「Launch」ボタンを押せば Android デバイス上でアプリが動くはずでしたが、自分の環境ではエラーが発生して動きませんでした……。
アウトプットログを調べてみたところ、以下のようなエラーが大量に発生していました。
LogPlayLevel: Error: Target id 'android-19' is not valid. Use 'android.bat list targets' to get the target ids.
「android-19」というのは、「Project Settings」にある「Platforms - Android SDK」の項目「NDK API Level」で設定している値です。
この項目についてネットで調べてみたところ、AnswerHub で以下のような質問が見つかりました。
これを見たときに「SDK と NDK の API レベルが合ってないのでは？」と思い、「NDK API Level」の値を「Android 5.0」の API レベル「21」に合わせて「android-21」に変更してみました。
その結果、無事に Android デバイス上で動くようになりました！
補足
「android-19」で動かなかった理由
この理由はいたって簡単。
「Android 4.4」の SDK をインストールしていなかった
でした。
「Project Settings」にある「Platforms - Android SDK」の項目「SDK API Level」に「matchndk」を指定すると、「NDK API Level」に設定されている値を元に「SDK API Level」の値を決めていたみたいです。
今回の「android-19」の場合、「SDK API Level」に「Android 4.4」が指定されるような値になっていたらしく、「Android 4.4」の SDK がインストールされてない環境ではエラーになっていた、ということらしいです。
ちなみに、「Android 4.4」の SDK をインストールしたら、「android-19」でも動くようになりました。
「Launch」のデバイス一覧に Android デバイスが表示されなかった理由
この理由もいたって簡単。
「Project Settings」にある「Platforms - Android SDK」の項目「Location of ～」に値が設定されていなかった
でした。
ただし、この表示にも段階があるようで……
- 「Location of Android NDK」を設定すると、「No Devices Found」になる。
- 「Location of Android SDK」を設定すると、デバイスが表示される。
と言った挙動になってました。
環境変数について
UE4 の公式ドキュメントに以下のようなものがあります。
ここを見ると
TADP をインストールしていない場合、環境変数が正しく設定されているか確認する必要があります。
と言った記述がありますが、今回試した際はこれらの環境変数がなくても動いていました。
（ドキュメント自体は 4.9 時代のものなので、仕様が変わったのではないか？と思われます。）