具体的には、Unreal Engine 4.25 で Android プロジェクトの開発をサポートするためには、Android Native Development Kit Revision 21 (NDK r21) が必要になりました。このため、CodeWorks for Android 1R7u1 ではなく Android Studio を使用する新しいセットアップ プロセスが必要になります。4.25 のフルリリース時にはこのプロセスを説明する新しいドキュメントを公開しますが、4.25 のプレビュー ビルドを使われている方々に、新しいセットアップ手順を先にお知らせすることにしました。
推奨されるセットアップ
NDK コンポーネントのインストールや、エンジンに合わせた環境変数の設定で問題が起こらないように、Unreal Editor と Epic Games Launcher はいずれも必ず終了しておいてください。Unreal 4.24 以前から Unreal 4.25 に移行する場合は、CodeWorks for Android と既存の NDK コンポーネントをアンインストールし、また CodeWorks がインストールされていたフォルダを削除してから、セットアップに進むことを推奨します。これは、環境変数を正しく設定するためです。そのようにしなかった場合、Android Studio は、SDK のアップデートのために、以前 CodeWorks をインストールしたディレクトリを引き続き使用します。デフォルトでは、CodeWorks がインストールされるディレクトリは C:/NVPACK です。
Unreal Engine の旧バージョンのサポートを継続しながら、Unreal 4.25 以降のバージョンも維持する必要がある場合は、「NDK または Unreal Engine の旧バージョンの使用」のセクションを参照してください。
1. Android Studio のインストール
必要な NDK コンポーネントをコンピューターにセットアップするには、Android Studio バージョン 3.5.3 をインストールする必要があります。- Web ブラウザで Android Studio のアーカイブ ページを開きます。Android Studio 3.5.3 までスクロールし、クリックしてドロップダウンを展開し、オペレーティング システムに合わせて適切なインストーラまたは zip ファイルをダウンロードします。
- Android Studio のインストーラを実行します。[Welcome to Android Studio Setup] ダイアログで [Next] をクリックして続行します。
- [Choose Components] ダイアログで [Next] をクリックして続行します。デフォルトのコンポーネントは有効のままにしておいてかまいません。
- [Configuration Settings] ダイアログでインストール先を選択し、[Next] をクリックして続行します。デフォルトのインストール先を使用することを推奨します。
- [Choose Start Menu Folder] で [Install] をクリックし、インストール プロセスを開始します。
- インストールが完了したら、[Next] をクリックしてコンポーネントのセットアップを開始します。
- セットアップが完了したら、[Start Android Studio] チェックボックスが選択されていることを確認し、[Finish] をクリックしてインストーラを終了します。
2. Android Studio を初めて使用する際のセットアップ
Android Studio を初めて起動するときは、次の手順に従います。- [Import Android Studio Settings From...] ダイアログが表示されたら、[Do not import settings] を選択し、[OK] をクリックして続行します。
- [Data Sharing] ダイアログが表示されたら、使用状況に関する統計情報を Google に送信するかどうかを選択します。このオプションは自由に選択できます。どちらを選択しても次のステップに進みます。
- [Android Studio Setup Wizard] が表示されます。[Next] をクリックして続行します。アップデートを促すプロンプトが表示された場合は、[X] ボタンをクリックしてプロンプトを閉じます。
- [Install Type] ダイアログで [Standard] を選択し、[Next] をクリックします。
- [Select UI Theme] ダイアログで好きなテーマを選択し、[Next] をクリックします。
- [Verify Settings] ダイアログで [Finish] をクリックすると、セットアップが確定し、コンポーネントのダウンロードが始まります。
- コンポーネントのダウンロードが完了したら、もう一度 [Finish] をクリックしてセットアップを終了します。
Windows を使用している場合は、すべての設定を有効にするためにコンピューターを再起動します。Linux を使用している場合は、ターミナル ウィンドウを閉じてからもう一度開きます。Mac を使用している場合は、ターミナル ウィンドウを閉じてからもう一度開くか、ログアウトしてからもう一度ログインします。次のセクションに進む前に必ずこの操作を行ってください。
3. Unreal Editor で NDK r21 を使用するようにセットアップ
Android NDK r21 を使用するように Unreal Editor をセットアップする手順は次のとおりです。- Unreal Engine 4 のインストール先ディレクトリまで移動します。たとえば、C:/Program Files/Epic Games/UE_4.25 です。
- Engine/Extras/Android を開きます。
- このディレクトリ内で、オペレーティング システムに適切な SetupAndroid スクリプトを実行します。SetupAndroid.bat は Windows 用、SetupAndroid.command は Mac 用、SetupAndroid.sh は Linux 用です。
- Android SDK のライセンスへの同意を求められます。「Y」と入力するか、Enter を押して同意します。
- インストールが完了したら、任意のキーを押してコマンド プロンプトを閉じて、プロセスを終了します。
このスクリプトによって NDK r21 がダウンロードされ、Android のホーム ディレクトリにインストールされます。インストール先ディレクトリは C:/Users/Username/AppData/Local/Android/Sdk/ndk/21.0.6113669 です。ここで「Username」はコンピューターのログイン名です。
NDK または Unreal Engine の旧バージョンの使用
Unreal Engine 4.24 以前のバージョンが必要な場合や、このインストール プロセスではサポートされない Android NDK の旧バージョンをプロジェクトで指定する必要がある場合は、環境変数を手動で設定して必要なバージョンを指定できます。Unreal Editor では、Android SDK のパスは [Project Settings (プロジェクト設定)] メニューの下の [Platforms (プラットフォーム)] - [Android SDK] にあります。 また、エンジンの BaseEngine.ini 内で[/Script/AndroidPlatformEditor.AndroidSDKSettings]
を次のように手動で編集することもできます。
NDKPath=(Path="D:/[NDKInstallPath]")
ここで
[NDKInstallPath]
は、使用する NDK のインストール パスです。Unreal Engine の今後のインストールをできる限りスムーズに行うには、前述のインストール手順に従って Android Studio を使用することを推奨します。その後、Android のデベロッパー サイトのサポートされていない NDK のダウンロード ページから NDK r14b をダウンロードし、4.24 以前のバージョンで手動で指定できます。
以前のプロジェクト用に CodeWorks を残しておきたい場合は、CodeWorks を削除せずに前述のとおり Android Studio のインストールを実行できます。4.25 の SetupAndroid スクリプトで NDK r21 は自動的にダウンロードされますが、Unreal Engine 4.25 でその場所を手動で指定する必要があります。