Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

Unreal Engine 4.25 およびそれ以降のバージョンでは、 Android Software Development Kit (SDK) をはじめ、基本となるすべての Android 開発コンポーネント用の Android Studio を備えた Android Native Development Kit (NDK) を使用します。本ページでは、Android Studio を設定し、これらのコンポーネントを Unreal Engine が正確に認識するように、段階的に説明します。また、NDK インストールと初期のエンジン ビルド管理に対するトラブルシューティングも紹介します。

推奨される設定

Unreal Editor と Epic Games Launcher を両方とも終了し、NDK コンポーネントのインストールまたはエンジン用の環境変数設定が問題のないことを確認してください。

4.24 以前のバージョンからアップグレードする場合、CodeWorks for Android および既存するすべての NDK コンポーネントをアンインストールして、CodeWorks をインストールするフォルダを削除することを推奨します。これを行わないと Android Studio は SDK アップデートに前の CodeWorks インストール フォルダを使用し続けます。

以前の Unreal Engine のインストールもサポートしつつ、Unreal 4.25 以降も維持する必要がある場合は、後述の「 SDK パスを手動で指定する 」および「 Android NDK の互換性 」を参照してください。

1. Android Studio をインストールする

必要な SDK コンポーネントと NDK コンポーネントをコンピュータに設定する前に、 Android Studio をインストールする必要があります。

1. ウェブ ブラウザの Android Studio Archive を開きます。 Android Studio 4.0 へスクロールし、クリックしてドロップダウンを展開し、使用するオペレーティング システムに適切なインストーラまたは zip ファイルをダウンロードします。

   クリックしてフルサイズ表示

2. Android Studio installer を実行します。 [Welcome to Android Studio Setup (Android Studio 設定へようこそ)] ダイアログ ボックスの [Next (次へ)] をクリックして続けます。

   クリックしてフルサイズ表示

3. [Choose Components (コンポーネントを選択)] ダイアログで [Next (次へ)] をクリックして続けます。デフォルト コンポーネントは有効のままにします。

   クリックしてフルサイズ表示

4. [Configuration Settings (コンフィギュレーション設定)] ダイアログで、適切なインストール場所を選択して [Next (次へ)] をクリックして続けます。デフォルト場所の使用を推奨します。

   クリックしてフルサイズ表示

5. [Choose Start Menu Folder (スタート メニュー フォルダを選択)] で [Install (インストール)] をクリックしてインストール プロセスを開始します。

   クリックしてフルサイズ表示

6. インストールが完了したら、 [Next (次へ)] をクリックしてコンポーネントの設定を開始します。

   クリックしてフルサイズ表示

7. コンポーネントの設定する時に [Start Android Studio] ボックスにチェックが入っていることを確認し、 [Finish (終了)] をクリックしてインストーラーを終了します。

2. Android Studio を設定する (初回ユーザーの場合)

Android Studio のインストールを始めて行う場合は、以下の手順に従います。

1. [Import Android Studio Settings (Android Studio 設定をインポート)] ダイアログが表示されたら、 [do not import settings (設定はインポートしない)] を選択し [OK] をクリックして続けます。

2. [Data Sharing (データ共有)] ダイアログが表示されたら、使用統計を Google に送信するかどうかを選択します。これはオプションなので自由選択です。いずれを選択しても次のステップに進みます。

   クリックしてフルサイズ表示

3. [Android Studio Setup Wizard] が表示されます。 [Next (次へ)] をクリックして継続。アップデートを促されたらバージョン 3.5.3 を指定してインストールする必要があるので、 [X] ボタンをクリックしてプロンプトを終了します。

   クリックしてフルサイズ表示

4. [Install Type (インストール タイプ)] ダイアログで [Custom] を選択し [Next] をクリックします。

   クリックしてフルサイズ表示

5. [Select UI Theme ] ダイアログで好きなテーマを選択し [Next] をクリックします。

   クリックしてフルサイズ表示

6. [Verify Settings (設定を確認)] ダイアログで、デフォルトの SDK パスを使用していることを確認してください。 [Finish] をクリックして設定を最終確定し、コンポーネントのダウンロードを開始します。

   クリックしてフルサイズ表示

   デフォルトの SDK パスを使用しないと、必要なファイルを見つけることができないため、手順の後半で SetupAndroid.bat が失敗する可能性があります。

7. コンポーネントのダウンロードが完了したら、再度 [Finish] をクリックして設定を終了します。

OS で Android Studio のインストールを最終確定する

3. Android NDK r21b を使用するように Unreal を設定する

1. Unreal Engine 4 インストール ディレクトリを開きます ( C:/Program Files/Epic Games/UE_4.25 など)。

2. Engine/Extras/Android を開きます。

3. このディレクトリ内で、オペレーティング システムに適切な SetupAndroid スクリプトを実行します。SetupAndroid.bat (Windows)、SetupAndroid.command (Mac)、SetupAndroid.sh (Linux)

   クリックしてフルサイズ表示

4. Android SDK ライセンス契約に同意するように促されます。「 Y 」と入力して Enter を押して同意します。

   クリックしてフルサイズ表示

5. インストールが完了したら、キーをどれか押してコマンド プロンプトを終了します。

6. すべての変更を反映させるためにコンピュータを再起動します。

このスクリプトは、Android ホームディレクトリに必要なバージョンの AndroidNDK をダウンロードしてインストールします。NDK のインストール ディレクトリは「 C:/Users/[Username]/AppData/Local/Android/SDK/ndk/ (「Username」の部分はコンピュータへのログイン名)」です。必要な NDK ヴァージョンを含むフォルダを確認できます。

`call "%SDKMANAGER%" "platform-tools" "platforms;android-28" "build-tools;28.0.3" "lldb;3.1" "cmake;3.10.2.4988404" "ndk;21.1.6352462"`

SDK パスを手動で指定する

前述の操作セクションに正しく従えば、Uneal Engine が自動的に Android SDK、Android NDK バージョン、Java Development Kit (JDK) の SDK パスを関連づけます。ただし、Unreal Engine の古いバージョンおよび Android Studio を使用している場合、互換性を持つように SDK パスを手動で指定する必要があります。 Unreal Engine と CodeWorks を使用している古いバージョンをインストールしている場合に当てはまることが多いです。

手動で SDK パスを指定するは、 [Edit] > [Project Settings] を開いて、 [Platforms] > [Android] > [Android SDK] セクションを選択します。

これらのフィールドがブランクのままの場合、前のセクションでのインストール プロセスで使用されたデフォルト パスにフォールバックします。これらのコンポーネントを複数インストールする、または非標準のディレクトリにインストールした場合は、それらのパスをここで手動で指定することができます。または、 DefaultEngine.ini を開いて [/Script/AndroidPlatformEditor.AndroidSDKSettings] セクションにそれらを指定できます。

[/Script/AndroidPlatformEditor.AndroidSDKSettings]
SDKPath = (Path="C:\Filepath")
NDKPath = (Path="C:\Filepath")
JDKPath = (Path="C:\Filepath")

SDKPath 、 NDKPath 、 JDKPath へのエントリが DefaultEngine.ini に存在しない場合、Android ホーム ディレクトリへのデフォルト パスを使用します。

Android SDK と NDK の互換性 以下の表は、必要な NDK と Android Studioバージョン、または Unreal Engine の他のバージョンと互換性を持つために必要な NDK のバージョンを示しています。