Google Play Console に署名済みの Android App Bundle(.aab)をアップロードしたとき、ステップ 1:リリースの作成 ではエラーなく通ったのに、次へ を押して ステップ 2:プレビューして確認する に進んだ瞬間に次の要件で足止めされるケースが急増しています。
アプリは 16 KB メモリのページサイズをサポートしている必要があります
App Bundle エクスプローラでは メモリのページサイズ: 16 KB 非対応 と表示され、英語 UI のリリース確認画面では Recompile your app with 16 KB native library alignment というカードとともに非対応ライブラリのリスト(Libraries that do not support 16 KB:)が表示されます。
多くのデベロッパーが戸惑う理由は、自分で C / C++ のコードを 1 行も書いていなくても発生する ことです。Android 15(API レベル 35)以上を対象とするアプリでは、.aab 内に含まれるすべての 64 ビット ネイティブ ライブラリ(.so ファイル)が検査されます。Flutter や Unity、React Native などのランタイム(libflutter.so、libil2cpp.so、libreactnative.so、libhermes.so)や、カメラ・QR コード読み取り・ローカル DB・機械学習系プラグインが同梱している .so ファイルが従来の 4 KB アライメントのままだと、このチェックに引っかかります。
1どの .so ファイルが 16 KB 非対応なのか特定する
闇雲に環境全体を作り直す前に、まずは原因となっている .so がフレームワーク本体なのか、Gradle のパッケージング設定なのか、特定の外部 SDK なのかを確認します。
- リリース確認画面(プレビューして確認する)で詳細を展開する:エラー・警告カードの下にある対象ライブラリの詳細(英語 UI では
Libraries that do not support 16 KB:)を展開すると、問題のある.soのパスが一覧表示されます。たとえばbase/lib/arm64-v8a/libflutter.soならフレームワーク本体、base/lib/arm64-v8a/libbarhopper_v3.soならバーコード読み取り SDK が原因だとすぐ切り分けられます。 - App Bundle エクスプローラで確認する:左メニューの テストとリリース > 最新のリリースとバンドル から該当の
versionCodeを開くと、詳細タブでメモリのページサイズ欄(非対応の場合はメモリのページサイズ: 16 KB 非対応)を確認できます。 - 再アップロード前にローカルで確認する(任意):Play Console に一度アップロードした
versionCodeは再利用できません。修正ビルドを作ったら、先に Android Studio の Build > Analyze APK… で.aab(または.apk)を開き、base/lib/arm64-v8a/(APK の場合はlib/arm64-v8a/)配下の Alignment 列に4 KBの警告が残っていないか確認してからアップロードすると無駄がありません。
2フレームワーク別の対処法
16 KB ページサイズに対応するには、Android Gradle Plugin(AGP)8.5.1 以上(非圧縮 .so の ZIP アライメントを 16 KB 境界に揃える)と、16 KB の ELF アライメントでビルドされた .so バイナリ の両方が必要です。
Android Studio / ネイティブ Gradle
AGP を 8.5.1 以上、Android NDK を r28 以上(28.0.13004108 以降。デフォルトで 16 KB ELF アライメントが有効)へ引き上げます。
// ルートの build.gradle.kts(または gradle/libs.versions.toml で agp = "8.7.3" を指定)
plugins {
id("com.android.application") version "8.7.3" apply false // 8.5.1 以上を指定
}
// app/build.gradle.kts
android {
ndkVersion = "28.0.13004108" // NDK r28 以降は標準で 16 KB アライメント有効
}
事情により NDK r27 を使い続ける必要がある場合は、リンカフラグ -Wl,-z,max-page-size=16384(CMake なら -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON)を明示的に渡します。
android {
defaultConfig {
externalNativeBuild {
cmake {
arguments += listOf("-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON")
}
}
}
}
あわせて build.gradle(.kts) の packaging { jniLibs { useLegacyPackaging } } は未指定(デフォルトの false)のままにしておくことで、AGP 8.5.1 以上が自動的に 16 KB の ZIP アライメントを行います。
Flutter
flutter upgrade を実行しただけではエンジン側の libflutter.so しか更新されず、既存プロジェクトの android/ 配下にある AGP や NDK のバージョン指定は古いまま残る 点に注意してください。
- Flutter
3.27/3.29以上 へ更新します(flutter upgrade)。 android/settings.gradle(またはsettings.gradle.kts)のcom.android.application(AGP)を8.5.1以上 に引き上げます(gradle-wrapper.propertiesの Gradle 本体も8.7以上、8.9などに合わせます)。android/app/build.gradle(またはbuild.gradle.kts)で NDKr28以上 を指定します。
android {
ndkVersion = "28.0.13004108"
}
flutter pub upgradeを実行してネイティブコードを含むプラグインを 16 KB 対応版へ更新し、pubspec.yamlの+以降のビルド番号を+1増やしたうえで、flutter cleanからflutter build appbundle --releaseを実行します。
Expo / React Native
React Native は 0.77 から libreactnative.so と libhermes.so が 16 KB ページサイズに標準対応しています。
- Expo:Expo SDK を
52/53以上 へアップグレードし(SDK53以降は React Native0.79ベースで標準対応)、npx expo install --fixでネイティブモジュールのバージョンを揃えます。app.jsonのandroid.versionCodeを増やしてからeas build --platform android --profile productionで再ビルドしてください。 - Bare React Native(Expo を使わない場合):React Native を
0.77以上 へ更新し、android/build.gradleの AGP が8.5.1以上、ndkVersionが"28.0.13004108"以降になっていることを確認してリリースバンドルを作成します。
Unity
Unity の libil2cpp.so と libunity.so は Unity エディタ自体が生成するため、Gradle 設定だけを書き換えても古いエディタのままでは解消できません。公式の 16 KB 対応パッチが入ったエディタへ更新してビルドし直します。
- Unity 6:
6000.0.38f1以降 - Unity 2022 LTS:
2022.3.56f1以降 - Unity 2021 LTS:
2021.3.48f1以降(※ Enterprise / Industry 延長サポート版のみ。Personal 利用者は Unity 2022 LTS または Unity 6 への移行が必要)
更新後、Project Settings > Player > Android > Other Settings で Scripting Backend が IL2CPP になっており ARM64 にチェックが入っていることを確認し、Bundle Version Code を増やして Build App Bundle (Google Play) で出力します。
3ツールチェーンを更新しても外部 SDK の .so が残る場合
手元の NDK r28 が再コンパイルしてくれるのは、ビルド時にソースからコンパイルされる C / C++ コードだけです。Maven、pub.dev、npm、Unity の .aar パッケージの多くは、提供元がビルドした コンパイル済み .so バイナリ をそのまま同梱しています。フレームワークと AGP を上げても特定の .so(libbarhopper_v3.so、libmmkv.so、libsqlcipher.so など)が非対応として残る場合は、次の順に対処します。
- どの依存パッケージ由来の
.soか突き止める:build/intermediates/merged_native_libs/release/内で該当の.soファイル名を検索するか、./gradlew :app:dependencies --configuration releaseRuntimeClasspathで依存ツリーを確認します。 - メジャーバージョンを跨いで SDK を更新する:ML Kit Barcode Scanning(
17.3.0以降)、CameraX(1.4.0以降)、MMKV(1.3.9/2.0以降)、Realm、SQLCipher などの主要ライブラリはすでに 16 KB 対応版を公開していますが、メジャーバージョンが上がっていると^指定のままでは自動更新されません。 - 使っていないプラグインを外す:テンプレート作成時に入れたまま使っていない PDF 表示・画像圧縮・スキャナ系パッケージがあれば、削除するだけで問題の
.soごと消えます。 - 提供元がまだ 16 KB 対応バイナリを出していない場合:オープンソースであれば NDK
r28以上でソースからビルドするか、開発が止まっている古いパッケージ(旧android-database-sqlcipherなど)からメンテナンス継続中の後継パッケージ(sqlcipher-androidなど)へ移行します。なお、patchelfやobjcopyで既存の 4 KB.soのヘッダだけを書き換える手法は、内部のページオフセット計算が壊れて 16 KB 実機でクラッシュするため避けてください。
4修正済み .aab を上げたのにエラーが消えないときの原因
Android Studio の Analyze APK… ではすべての .so が 16 KB 対応になっているのに Play Console 上で警告やエラーが残る場合、リリース管理の仕様で引っかかっていることがほとんどです。
- 同じ下書きリリースに古い 4 KB のバンドルが残っている:作成中の下書きに新しい
versionCodeの.aabを追加した際、直前に失敗した古いversionCodeのバンドルが App Bundle 欄に並んだままになっていると、古いバンドル側が原因で判定に引っかかり続けます。下書きから古いバンドルを除外し、修正済みの.aabだけが含まれた状態にしてください。 - 別トラックに古い 4 KB のバンドルがアクティブなまま残っている:ポリシーのステータス(
アプリは 16 KB メモリのページサイズをサポートしている必要があります)は、内部テスト・クローズド テスト・オープンテスト・製品版を含む全トラックで現在アクティブなすべてのバンドル を対象に判定されます。クローズド テスト に 16 KB 対応ビルドを出しても、内部テスト に以前の 4 KB ビルドがアクティブなまま残っていると警告が消えません。ライブラリから追加 を使って該当トラックにも新しいバンドルを配信して置き換えるか、使っていないテストトラックであれば トラックを一時停止 してください。
無事にアップロードできたら:次に待っているクローズド テスト
16 KB 対応をクリアしたあとに AD_ID 権限の申告不一致や versionCode の重複、難読化解除ファイル(R8)・デバッグ シンボルの黄色い警告など別のメッセージが出た場合は、Play Console の AAB アップロードエラー一覧:原因と対処法 から該当するエラーを確認できます。
個人用デベロッパー アカウントでは、最初のクローズド テスト版リリースを公開した直後に最大の関門が待っています。製品版へのアクセスを申請する には、クローズド テストを 12 人以上のテスターで、14 日間以上実施する(過去 14 日間継続してオプトインしていること)必要があります。カウント条件の詳細は クローズド テスト 12 人・14 日間:「連続」の本当の意味 で解説しています。
ツールチェーンやネイティブ .so を更新したビルドは、エミュレータだけでなく複数の Android 実機でも起動を確認しておくと安心です。とはいえ、個人開発で 12 人以上の Android テスターを自力で集め、14 日間アプリを開き続けてもらうのは簡単ではありません。SNS で個別に相互テストを頼んでも、オプトイン リンクを踏んだだけでインストールされなかったり途中で消されたりして、申請後にテスト不足で差し戻されることがよくあります。BetaLobby(完全無料・有料プランなし)では、16 人の開発者が チームモード(共通 Google グループ 1 つ)で互いのアプリを実機にインストールし、スクショ提出不要の自動確認と毎日の チェックイン で 14 日間のクローズド テストを完走できます。