Unreal Engine5.4でAndroid プロジェクトの開発に必要な Android SDK コンポーネントをダウンロードしてインストールする方法です。この手順を踏むことでAndroid用のパッケージ化を行うことが可能です。
Setting Up Android SDK and NDK
Install Android Studio and automatically add SDK components.
(ここでは上記の公式ページの内容をもとに手順を紹介します)
インストールの手順
Android SDK をインストールするには、次の手順に従います。
- ターンキー（Turnkey） を実行して、Android Studio を自動的にダウンロードします。
- Android Studio インストールを構成して、Android SDK コマンドライン ツールをダウンロードします。
- Android Studio を閉じて、Turnkey に必要な Android SDK コンポーネントのインストールを続行させます。
- コンピュータを再起動します。
ターンキー（Turnkey） とは？
Unreal Engine 5 で導入されたシステムです。ソースファイルを検索して SDK のインストールなど、プラットフォーム サポートの設定に必要なほとんどの手順を自動化できます。
必要なバージョン
Unreal Engine で Android プロジェクトを開発するために必要なソフトウェア コンポーネントは次のとおりです。
- 現在の UE バージョン: 5.4.4
- Android Studio バージョン: Flamingo 2022.2.1 パッチ 2 2023 年 5 月 24 日
- Android SDK:
- 推奨: SDK 34
- コンパイルの最小要件: SDK 34
- デバイスに出荷するための最小SDK: 26ストアごとにターゲット SDK の最小要件が異なり、上記の要件とは異なる場合があります。
- NDK バージョン: r25b
- ビルドツール: 34.0.0
- Java ランタイム: OpenJDK 17.0.6 2023-01-17
- AGDE デバッグには AGDE v23.1.82+ が必要です。
Unreal Engine 5.4の事前準備
Android ターンキー（Turnkey） インストール プロセスは、UE 5.3 以前では使用できません。
ここでは、Unreal Engine 5.4 以降がインストールして使用します。
詳細なインストール手順については、Advanced Android Studio セットアップ ガイドを参照してください。
Unreal Engine 5.4のインストール
Epic Games Launcher を起動します。
Unreal Engine バージョン5.4以降を指定しインストールをクリックします。
Androidプラットフォームの指定
フォルダとパスがデフォルトの状態であることを確認した後、オプションをクリックします。
Unreal Engine 5.4.4インストールオプション
▼対応プラットフォーム
Androidにチェックを入れます。
適用をクリックします。
インストールをクリックします。
サンプルVRプロジェクトの新規作成
インストールが終了後、Unreal Engine のプロジェクトブラウザ画面に遷移します。
今回は新規VRサンプルプロジェクトを作成します。
ターンキー（Turnkey）を実行してAndroid Studioのインストールを開始する
Unreal Engine は、ターンキー（Turnkey） と呼ばれるUnreal Automation Toolスクリプトを使用して、チーム全体に SDK を配布することが出来ます。
通常、ターンキー（Turnkey） では、プラットフォームの SDK インストール ファイルをチームの共通の場所に置く必要があります。
ただし、Android Studio は公開されているため、ターンキー（Turnkey） は自動的にダウンロードして、追加の手順なしでセットアップを開始できます。
Unreal Editor からターンキー（Turnkey）を実行する
Unreal Engineの画面から、以下の方法でターンキー（Turnkey）を実行します。
プラットフォーム> Android > SDK のインストールをクリックします。
ターンキー（Turnkey）を実行するとAndroid Studio がダウンロードされ、インストールが自動的に開始されます。ただし、続行する前に、インストール ウィザードを自分で実行して Android SDK コマンドライン ツールをダウンロードし、ターンキーが Unreal Engine に必要なその他のコンポーネントを取得できるようにする必要があります。インストールを完了するには、次の手順に従います。
ターンキー手順
初めてSDK のインストールを実行するとターンキーが作業手順について言及します。
The Android Sdk directory was not found (expected to find it at ‘C:\Users\Username\AppData\Local\Android\Sdk’
Android Studio can install it for you, but you will need to manually perform some steps (if desired, you can get detailed help with option 2):
- Wait for Android Studio to start, you will see an initial dialog asking how to proceed (called “Welcome to Android Studio)
- Click the “Configure” dropdown in the bottom right, and select “SDK Manager”
- Click on the “SDK Tools” tab near the top middle of the right pane
- Check the box next to Android SDK Command-line Tools (latest)
- Click OK in the bottom right
- It will probably ask for you to accept a license – you MUST do this
- Once installation has completed, close/quit Android Studio to continue
Android SDK ディレクトリが見つかりませんでした (‘C:\Users\ユーザーネーム\AppData\Local\Android\Sdk* にあるはずです)。Android Studio でインストールできますが、手動でいくつかの手順を実行する必要があります (必要に応じて、オプション 2 で詳細なヘルプを入手できます):
- Android Studio が起動するまで待ちます。続行方法を尋ねる最初のダイアログ (「Android Studio へようこそ」) が表示されます
- 右下の [構成] ドロップダウンをクリックし、[SDK マネージャー] を選択します
- 右ペインの上部中央近くにある [SDK ツール] タブをクリックします
- [Android SDK コマンド ライン ツール (最新)] の横にあるボックスにチェックを入れます
- 右下の [OK] をクリックします
- ライセンスに同意するように求められる場合があります。必ずこれを行わなければなりません
- インストールが完了したら、Android Studio を閉じて続行します
●Run Android Studio to Install the Command-line Tools
にラジオボタンが付いた状態で
OKをクリックします
Android Studioのインストール
Install Type
StandardのままでOK
Nextをクリック
Verify (検証) Settings
Nextをクリック
License Agreement
左側の赤いマークの付いた箇所をクリックして、すべてのライセンス状況を確認した後にAcceptをクリックします。
Finishをクリックします。
Downloading Components
ダウンロードが開始されます。しばらく待ちます。
ダウンロードが終了したらFinishをクリックしてウィンドウを閉じます
（Intel haxm installation failedは致命的なエラーではないため一旦気にしないでおきます）
Android Studio と Android コマンドライン ツールをセットアップする
Android Studio Setup Wizard 完了後Android Studio が自動で開きます。
Welcome to Android Studio
「More Actions ▽ 」をクリックします
プルダウンメニューから「SDK Manager」をクリックします
Settings
①SDK Toolsタブをクリックします。
②Show Package Detailsにチェックを入れます。
③Android SDK Command-Line Tools (latest) をチェックします
[Apply]をクリックします。
これにより、Android Studio を UE 用に自動的に構成するために必要なコマンドライン ツールがダウンロードされます。
OKをクリックします
Confirm Change
OKをクリックします
License Agreement
ライセンス条項を確認後Agreeにチェックを入れます。
Nextをクリック
SDK Component Installer
Turnkey に必要な Android SDK コンポーネントのインストールを続行させます。
インストール終了後
Finishをクリックします。
右上の×ボタンをクリックしてAndroid Studio を閉じます。
SDK セットアップを完了して再起動
Android Studio を閉じると、Turnkey は他の Android SDK コンポーネントのダウンロードとインストールを再開します。
プロセスが完了すると、成功したかどうかを知らせるプロンプトが表示されます。
UnrealEngineの再起動を促されます。
Android 環境変数を確定するため、お使いのWindowsPCを再起動します。
プロジェクトをパッケージ化
Unreal Editor を開き、
プラットフォーム> Android
をクリックします。
SDK の許可されたバージョンとインストールされているバージョンが一致し、Android SDK をインストールまたは修復するためのボタンが表示されなくなります。
プロジェクトのパッケージ化
を実行します。
.apkファイルを格納するフォルダを選択します。
パッケージ化には時間が掛かるので暫く待ちます。
パッケージ化完了しました。
先ほど指定した格納フォルダを確認します。
以下のファイルが生成されています
.batバッチファイル.apkファイル.obbファイル
トラブルシューティング
新しいシステムからインストールした場合、上記の手順を実行すると SDK セットアップが機能するはずです。しかし、古い環境変数やインストールによって競合が発生する可能性があります。Android SDK のセットアップを妨げる特定の問題を診断して修正する方法については、高度な Android Studio セットアップ ガイドをご覧ください。
まとめ
今回は。Unreal Engine5.4でAndroid プロジェクトの開発に必要な Android SDK コンポーネントをダウンロードしてインストールする方法を説明しました。
次回は今回パッケージ化した.apkファイルをMetaQueastヘッドセット本体にインストールして、単体でアプリを起動させる方法です。
