【UE5】Android スマホでのデバッグ方法（UE5.1）

# 手順
## Android Studio のインストール
### 手順1
[Android Studio のダウンロード アーカイブ](https://developer.android.com/studio/archive)に行き、バージョン **4.0** をダウンロードする。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/669c056a-6f74-9c6d-f253-99fd2df20977.png">

### 手順2
ダウンロードしたインストーラーを実行して Android Studio をインストールする。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/45b6fd08-7754-25fe-4536-8ca64c74216f.png">

## SDK と NDK のインストール
### 手順3
インストールした Android Studio の初期設定を行い、Android Studio のスタート画面に戻り、右下の「**Configure**」から「**SDK Manager**」を開く。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/18aae8b0-7426-16c8-0b6a-40c0e53ee0de.png">

### 手順4
「**Android SDK Location**」の右にある「**Edit**」を押す。 

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/e739e152-ce48-6db0-9f76-a18541628fc0.png">

### 手順5
必要なコンポーネントが選択されている事を確認して右下の「**Next**」を押す。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/bc461822-240e-5870-89b4-3a3b7cbdb1ef.png">

### 手順6
「**Verify Settings**」で「**Next**」を押してコンポーネントをインストールし、「**Finish**」を押した後、「**Settings**」に戻り、「**Android SDK** ＞ **SDK Tools**」に行き、右下の「**Show Package Details**」にチェックを入れる。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/701c70a7-46e9-3747-af20-b8c40e0c87c0.png">

### 手順7
「**Android SDK Command-line Tools (latest)**」のバージョン **8.0** と「**NDK (Side by side)**」のバージョン **25.1.8937393** にチェックを入れて右下の「**Apply**」を押す。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/23565452-2d1c-ccda-a5a1-3bb399128bb5.png">

## 「SetupAndroid.bat」の修正と実行
### 手順10
「C:\Program Files\Epic Games\UE_{バージョン番号}\Engine\Extras\Android」にある「**SetupAndroid.bat**」を**メモ帳**などのテキストエディタで開く。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/6270a4bd-7dd2-8c70-d427-c4671d285b93.png">

### 手順11
コード内の ``set SDKMANAGER=%STUDIO_SDK_PATH%\cmdline-tools\latest\bin\sdkmanager.bat`` となっている箇所を ``set SDKMANAGER=%STUDIO_SDK_PATH%\cmdline-tools\8.0\bin\sdkmanager.bat`` というふうに ``latest`` から ``8.0`` に書き換えて保存する。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/1522646e-5f6d-8d90-172d-58d9049d5b51.png">

### 手順12
編集した「**SetupAndroid.bat**」をダブルクリックして実行する。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/9ca2bfae-274f-73d0-da02-c941e1839ac7.png">

## プロジェクト設定の変更
### 手順13
UE エディタを開き、「**Edit** ＞ **Project Settings...** ＞ **Platforms** ＞ **Android** ＞ **APK Packaging**」が赤くなっている場合は「**Configure Now**」を押す。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/354202e1-0f57-e023-d0cc-e7f1e2019b85.png">

### 手順14
「**Edit** ＞ **Project Settings...** ＞ **Platforms** ＞ **Android SDK** ＞ **SDKConfig**」の各項目に以下の値を設定する。

| 項目名 | パス |
| ---- | ---- |
| Location of Android SDK (the directory usually contains 'android-sdk-') | C:/Users/ {ユーザー名} /AppData/Local/Android/Sdk |
| Location of Android NDK (the directory usually contains 'android-ndk-') | C:/Users/ {ユーザー名} /AppData/Local/Android/Sdk/ndk/25.1.8937393 |
| Location of JAVA (the directory usually contains 'jdk') | C:/Program Files/Android/Android Studio/jre |

## パッケージ化とテストプレイ
### 手順15
以下のドキュメントを参考にして Android スマホの設定を行う。
（必要に応じて [SDK Platform-Tools](https://developer.android.com/tools/releases/platform-tools) をダウンロードして環境変数を設定しておく）

https://dev.epicgames.com/documentation/ja-jp/unreal-engine/setting-up-your-android-device-for-developing-applications-in-unreal-engine?application_version=5.1

### 手順16
「**Platforms** ＞ **Android** ＞ **Package Project** 」を選択してパッケージ化する。

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/3ebfd7b6-9fbe-e017-7ef2-c000d018c1a5.png">

### 手順17
パッケージ化が完了したら Android スマホを PC に USB 接続してパッケージ化先のフォルダ（**Android_ASTC**）内の「**Install_{プロジェクト名}-arm64**」を実行し、それも終わったら Android スマホで対象のアプリを開く。
（Android スマホを USB 接続した際に「USBデバッグを許可しますか？」というポップアップが出たら許可する）

<img width="500" alt="TSUBASAMUSU.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/ecbad4ec-5c8c-8ab7-f49e-856a4f392b06.png">

# その他
## 参考記事
https://dev.epicgames.com/documentation/ja-jp/unreal-engine/how-to-set-up-android-sdk-and-ndk-for-your-unreal-engine-development-environment?application_version=5.1

https://dev.epicgames.com/documentation/ja-jp/unreal-engine/setting-up-unreal-engine-projects-for-android-development?application_version=5.1

https://dev.epicgames.com/documentation/ja-jp/unreal-engine/setting-up-your-android-device-for-developing-applications-in-unreal-engine?application_version=5.1

https://dev.epicgames.com/documentation/ja-jp/unreal-engine/android-development-requirements-for-unreal-engine?application_version=5.1

https://zenn.dev/daichi_gamedev/books/unreal-engine-5/viewer/android-play

# 最後に
## 株式会社ModelingXについて
<img width="200" alt="image.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2670397/4261f1c0-a380-01a9-9c69-08a836c6f02f.jpeg">

富山県を拠点とするスタートアップ企業、ModelingXは、2022年4月に創業し、「テクノロジーで感動体験を提供する」というミッションを掲げています。当社が開発中の暮らし体験メタバース「MELIFE（ミライフ）」は、バーチャル住宅展示場や銀行相談、家具購入、婚活などができる「地域単位の新たな経済圏」を目指しています。

↓サービスサイトはこちらから↓

https://melife.io/

ModelingXはリモートワーク＆フレックスタイム制を完備。
UnityやUEを共に探求する仲間を全国から募集しています。

↓企業詳細はこちら↓

https://modelingx.jp/