概要

UE 4.27 で Google Play の対象 API レベル要件や、それに付随する様々な要件を満たす Android App Bundle (AAB) を、できるだけ簡単に作る方法について解説する。
なお、署名や Play Asset Delivery (PAD) といった基本的な設定は完了している前提とする。

対象 API レベル 34 で問題ないことは確認済み（2024 年 8 月時点）。

環境

Unreal Engine 4.27

Location of Android SDK	C:/Users/[UserName]/AppData/Local/Android/Sdk
Location of Android NDK	C:/Users/[UserName]/AppData/Local/Android/Sdk/ndk/21.4.7075529
Location of JAVA	C:/Program Files/Android/Android Studio/jre
SDK API Level	latest
NDK API Level	android-21

Android Studio 4.0.2
- Android SDK Platform 29
- Android SDK Build-Tools 29.0.2
- NDK 21.4.7075529 (r21e)
- Android SDK Command-line Tools (latest)
- CMake 3.10.2.4988404
- Android SDK Platform-Tools

各バージョンは厳密に合わせる必要がある。

方法

以下の 3 点を行って AAB をパッケージングするだけ。

上記環境を構築
プロジェクト設定の Target SDK Version に要件以上の値を設定
以下の GooglePlayReady プラグインをインストール

解説

GooglePlayReady プラグインでは、以下の 3 点を行うことで Google Play の要件に対応している。

1. android:exported の追加

普通に AAB をアップロードすると、以下のエラーにひっかかる。

アップロードされた APK または Android App Bundle には、インテントフィルタを使用するアクティビティ、アクティビティエイリアス、サービス、またはブロードキャストレシーバが含まれていますが、'android:exported' プロパティセットは使用されていません。このファイルは Android 12 以降にはインストールできません。詳細

プラグインではこれを解決するため、Unreal Plugin Language (UPL) で Android Manifest のすべての activity, service, receiver タグに対して android:exported を追加している。

GooglePlayReady_UPL.xml

<loopElements tag="activity">
	<setStringFromAttribute  result="ExportTag" tag="$" name="android:exported"/>
	<setBoolIsEqual result="ShouldNotAddExportTag" arg1="$S(ExportTag)" arg2="false"/>
	<if condition="ShouldNotAddExportTag">
		<false>
			<addAttribute tag="$" name="android:exported" value="true"/>
		</false>
	</if>
</loopElements>
...

2. com.android.vending.BILLING の削除

リリース画面に進むと、以下のエラーにひっかかる。

このアプリで現在使用している Play Billing Library のバージョンは AIDL です。Google Play で最新の収益化機能を利用するには、バージョン 5.2.1 以上に更新する必要があります。詳細

アプリに課金要素がある場合はエラー文の通りに PBL を更新する必要があるが、ない場合は Billing の Permission を削除してしまえばよい。
プラグインでは、UPL で com.android.vending.BILLING を削除することで対処している。

GooglePlayReady_UPL.xml

<removePermission android:name="com.android.vending.BILLING" />

なお Permission の削除については、以下の記事で解説している ManifestRequirementsOverride.txt を使う方法もある。

3. Play Core Library の更新

上記のエラーを解決しアプリをリリースできたとしても、PAD を使用している場合は Android 14 以降でアプリが起動しないという問題がある。
これを解決するには、以下のドキュメントに従って GooglePAD プラグインの APL を編集し、Play Core Library を更新する必要がある。

Engine/Plugins/Runtime/GooglePAD/Source/GooglePAD/GooglePAD_APL.xml

- implementation('com.google.android.play:core:1.10.0')
+ implementation('com.google.android.play:asset-delivery:2.2.2')
+ implementation('com.google.android.play:asset-delivery-ktx:2.2.2')

- import com.google.android.play.core.tasks.OnCompleteListener;
- import com.google.android.play.core.tasks.OnSuccessListener;
- import com.google.android.play.core.tasks.RuntimeExecutionException;
- import com.google.android.play.core.tasks.Task;
+ import com.google.android.gms.tasks.OnCompleteListener;
+ import com.google.android.gms.tasks.OnSuccessListener;
+ import com.google.android.gms.tasks.RuntimeExecutionException;
+ import com.google.android.gms.tasks.Task;

またこれに伴い、aar-imports.txt や app/build.gradle も修正する必要がある。
なお、この修正は UE 4.27 Plus では既に適用されている。

Engine/Build/Android/Java/aar-imports.txt

- com.google.android.gms,play-services-games,11.8.0
+ com.google.android.gms,play-services-games,18.0.1

Engine/Build/Android/Java/gradle/app/build.gradle

+ compileOptions {
+     sourceCompatibility JavaVersion.VERSION_1_8
+     targetCompatibility JavaVersion.VERSION_1_8
+ }

sourceSets.main {

これらはエンジンのファイルに変更を加えることになるが、エンジンソースを変更しているわけではないので、ソースからエンジンをビルドする必要はない。
プラグインでは、GooglePlayReady.Build.cs でこれらの変更を自動的に行っている。

おまけ

Google Play にアップロードした Shipping の AAB でのみ発生する問題がある場合は、以下のコードを [ProjectName].Target.cs に追加して Shipping でのログを有効化してみるとよい。
ただし、これはソースからビルドしたエンジンでしか利用できない。

[ProjectDirectory]/Source/[ProjectName].Target.cs

if (Configuration == UnrealTargetConfiguration.Shipping)
{
	bUseLoggingInShipping = true;
}

ログはここに保存される。
Android/data/[PackageName]/files/UE4Game/[ProjectName]/[ProjectName]/Saved/Logs/[ProjectName].log

なお Android 14 以降では Android/data 以下へのアクセス権が厳しくなったらしく、エクスプローラーからログを開けないという問題がある。
これは AndroidPlatformFile.cpp を以下のように編集し、ログ出力先のディレクトリを変更することで解決できる。

Engine/Source/Runtime/Core/Private/Android/AndroidPlatformFile.cpp(1154)

//AndroidLogDir = LogBaseDir + GAndroidProjectName + TEXT("/") + GAndroidProjectName + TEXT("/Saved/Logs/");
AndroidLogDir = GExternalFilePath.Replace(TEXT("/Android/data/"), TEXT("/Documents/")) + TEXT("/Logs/");