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 を実行します。 [Android Studio Setup (Android Studio 設定)] ダイアログ ボックスの [Next (次へ)] をクリックして続けます。

   画像をクリックするとフルサイズで表示されます。

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

   画像をクリックするとフルサイズで表示されます。

4. [Install Locations (インストール場所)] ダイアログで、インストール場所がデフォルトに設定されていることを確認します。 [Next (次へ)] をクリックして継続。

   画像をクリックするとフルサイズで表示されます。

   カスタムでのインストール場所を選択した場合、最初に編集しない限りは SetupAndroid.bat はファイルを検索することはできません。デフォルトのインストール場所を保持することを強くお勧めします。

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 (次へ)] をクリックして継続。アップデートを促されたらバージョン 4.0 を指定してインストールする必要があるので、 [X] ボタンをクリックしてプロンプトを終了します。

   画像をクリックするとフルサイズで表示されます。

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

   画像をクリックするとフルサイズで表示されます。

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

   画像をクリックするとフルサイズで表示されます。

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

   画像をクリックするとフルサイズで表示されます。

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

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

3. Android 向けコマンドライン ツールをセットアップする

Unreal Engine の Android SDK セットアップは、Android バージョン 8.0 のコマンドライン ツールに依存します。インストールを最終確定する前に、このバージョンがインストールされており、UE の SetupAndroid スクリプトがそれを正しくターゲットとしていることを確認する必要があります。

1. [Welcome to Android Studio (Android Studio へようこそ)] ダイアログで、、AndroidStudio を最新バージョンに更新するように求めるプロンプトが右下隅に表示されます。カーソルを合わせて、更新せずに終了します。これにより、 [Configure (構成)] と [Get Help (ヘルプを表示)] のドロップダウンが表示されます。

2. [Configure (構成)] ドロップダウンを開いて SDK Manager をクリックします。

   画像をクリックするとフルサイズで表示されます。

3. Android SDK システム設定で [SDK Tools] タブをクリックします。これによりオプション コンポーネントのリストが表示されます。

   画像をクリックするとフルサイズで表示されます。

4. [Android SDK Command-line Tools] バージョン 8.0 のボックスにチェックを入れます。 Apply をクリックして、このコンポーネントをダウンロードおよびインストールします。

5. [OK] をクリックしてウィンドウを終了し、ウェルカム ダイアログを閉じます。

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

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

8. このディレクトリで、使用しているオペレーション システムに適切な SetupAndroid スクリプトを見つけます。Windows は SetupAndroid.bat 、Mac は SetupAndroid.command 、Linux は SetupAndroid.sh です。

   画像をクリックするとフルサイズで表示されます。

9. テキスト エディタ でオペレーティング システムの SetupAndroid を開きます。以下のように編集します。

   • In SetupAndroid.bat , change any instance of set SDKMANAGER= to read: set SDKMANAGER=%STUDIO_SDK_PATH%\cmdline-tools\8.0\bin\sdkmanager.bat

   • In SetupAndroid.command or SetupAndroid.sh , change any instance of SDKMANAGERPATH= to read: SDKMANAGERPATH="$STUDIO_SDK_PATH/cmdline-tools/8.0/bin

   スクリプトを保存してテキスト エディタを閉じます。

   SDKMANAGER または SDKMANAGERPATH` 変数を定義しているすべての行を編集してください。そうしないと、Android NDK のセットアップに失敗します。

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

ここまでの手順をすべて完了したら、先に進む前に、環境が完全にセットアップされていることを確認するためにインストールを最終確定する必要があります。オペレーティング システムごとにインストールの最終確認のステップは異なります。

5. Setting Up Android NDK

必要な Android SDK コンポーネントがインストールされると、 SetupAndroid スクリプトを使って Android NDK の適切なバージョンのダウンロードおよびインストールが可能になります。

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

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

3. このディレクトリで、使用しているオペレーション システムに適切な SetupAndroid スクリプトを実行します。Windows は SetupAndroid.bat 、Mac は SetupAndroid.command 、Linux は SetupAndroid.sh です。

   画像をクリックするとフルサイズで表示されます。

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 のバージョンを示しています。