運用している壁紙アプリの一本を対象 API レベル36 に引き上げ、内部テストへ上げたところで、Play Console に見慣れない警告が並びました。「アプリは 16 KB のメモリページサイズをサポートする必要があります」という一文です。
8月31日の期限に追われている最中でしたので、一瞬「これも今週中に直さないといけないのか」と身構えました。結論から書きますと、この2つは別の条件で、期日も違います。
混ぜて考えると、本来なら来年まで時間のある作業を、残り数日の作業リストに引き込んでしまいます。逆に「同じ話だろう」と片方だけ直して安心してしまう危険もあります。この記事は8月に書いたものを、11月に入って期日の状況が変わったところで見直しました。対象 API レベルの延長期限(11月1日)も過ぎ、いま残っているのは 16 KB 側の期日だけです。
Play Console に並ぶ2つの条件は、対象も期日も違います
対象 API レベルの要件と、16 KB ページサイズの要件は、発動する条件がそもそも異なります。以下は 2026年11月時点で、Android Developers と Play Console ヘルプの記載を確認した内容です。
| 項目 | 対象 API レベル36 | 16 KB ページサイズ |
|---|---|---|
| 期日 | 2026年8月31日(延長申請をした場合は11月1日まで) | 2027年2月1日 |
| 対象になる条件 | すべてのアプリ更新と新規アプリ | API レベル35 以上を対象にし、かつネイティブコードを含むアプリ |
| 満たさないと起きること | 更新が提出できない | 更新が提出できない(期日以降) |
| 直す場所 | ビルド設定(targetSdkVersion)と挙動の追随 | .so のリンク時アライメントと zip の格納位置 |
| Kotlin / Java だけのアプリ | 対象 | 対象外(すでに満たしている) |
| 11月20日時点の状況 | 期限経過。未対応なら更新が通らない | 残り約2か月半 |
つまり、targetSdk を 35 未満から 36 へ引き上げた瞬間に、16 KB の要件が「新たに自分に適用された」状態になります。警告がこのタイミングで出てきたのは、期限が重なったからではなく、自分が条件の内側に入ったからでした。
対象 API レベル36 側の作業内容については、実効 targetSdkVersion を洗い出した記録と、更新を出す人と出さない人で8月31日の意味が変わる話にまとめてあります。本記事は 16 KB 側だけを扱います。
期日の一次情報は Android Developers の「16 KB ページサイズをサポートする」にあります。過去に「2025年11月1日」「延長すると2026年5月31日」という日付が広く共有されましたが、現在の公式表記は「2027年2月1日以降、16 KB をサポートしない更新はリリースできない」です。古い記事を読んで焦る必要はありませんが、猶予が無限にあるわけでもありません。
症状から逆にたどる切り分け表
警告の出方は人によって違います。まず手元の症状がどの行に当たるかを見ていただくと、以降の節のどこを読めばよいかが決まります。
| 症状 | 原因の候補 | 確かめ方 | 直し方 |
|---|---|---|---|
| Play Console に「16 KB のメモリページサイズをサポートする必要があります」 | API 35 以上を対象にし、.so のどれかが 16 KB 境界に揃っていない | App Bundle Explorer の該当バージョン、または下の検査スクリプト | LOAD=4096 か zip 境界ずれ かで分岐(後述) |
検査で zip 境界ずれ だけが出る | パッケージング時の格納位置。古い Android Gradle Plugin | 配信 APK 相当のファイルで再検査 | AGP 8.5.1 以上(Expo SDK 53 以降の構成なら既定で満たします) |
検査で LOAD=4096 が出る | その .so 自体が 4 KB 前提でリンクされている | .so のパスからパッケージ名を特定し、更新履歴を確認 | 依存の更新・置き換え。自分のビルド設定では直りません |
| 16 KB の端末やエミュレータでだけ起動直後に落ちる | LOAD=4096 の .so が読み込めない、または RELRO 周りの不整合 | 16 KB システムイメージのエミュレータで adb logcat を見る | 上と同じ。互換モードは一時しのぎ |
| 起動時に「互換モードで動作しています」と表示される | 16 KB 端末が 4 KB 前提のアプリを互換モードで動かしている | 表示そのものが証拠です | 根本は .so の再リンク。表示だけ消すのは android:pageSizeCompat |
.so が 0 件なのに警告が出ているように見える | 表示されているのが別トラック・別バージョンのバンドル | App Bundle Explorer でバージョンコードを照合 | 最新の提出物で判断し直す |
最後の行は見落としやすいものです。内部テストやクローズドテストに古いバンドルが残っていると、そちらの警告を新しいビルドの問題だと思い込んでしまうかもしれません。警告を見たら、まずバージョンコードを照合します。地味ですが、ここで方向を間違えると後の手順がすべてずれます。
NDK を入れずに、手元の APK / AAB がどちら側か調べる
公式の検査手順は llvm-objdump(公式スクリプト check_elf_alignment.sh)と zipalign を使います。どちらも Android SDK と NDK が要りますので、CI コンテナや、普段 EAS Build に任せていて手元にツールチェーンがない環境では、この確認のためだけに数 GB を入れることになります。
実際には、判定に必要な情報は .so の ELF プログラムヘッダと、zip の格納位置の2つだけです。Python の標準ライブラリだけで両方読めます。以下は Python 3.10 で動作を確かめたものです。
#!/usr/bin/env python3
"""APK / AAB の .so を 16 KB アライメント観点で検査する(外部依存なし)"""
import sys, zipfile, struct
PT_LOAD, PT_GNU_RELRO = 1, 0x6474e552
def read_program_headers(data):
if data[:4] != b"\x7fELF":
return None
is64, little = data[4] == 2, data[5] == 1
end = "<" if little else ">"
if not is64:
return {"arch": "32bit", "loads": [], "relro": False}
e_machine, = struct.unpack_from(end + "H", data, 18)
e_phoff, = struct.unpack_from(end + "Q", data, 32)
e_phentsize, e_phnum = struct.unpack_from(end + "HH", data, 54)
loads, relro = [], False
for i in range(e_phnum):
off = e_phoff + i * e_phentsize
p_type, = struct.unpack_from(end + "I", data, off)
p_align, = struct.unpack_from(end + "Q", data, off + 48)
if p_type == PT_LOAD:
loads.append(p_align)
elif p_type == PT_GNU_RELRO:
relro = True
return {"arch": {0xB7: "arm64-v8a", 0x3E: "x86_64"}.get(e_machine, hex(e_machine)),
"loads": loads, "relro": relro}
def data_offset(z, info):
"""ローカルヘッダを読み、実データの開始位置を返す(zipalign が揃えるのはここ)"""
f = z.fp
f.seek(info.header_offset + 26)
n, m = struct.unpack("<HH", f.read(4))
return info.header_offset + 30 + n + m
def main(path):
ng = 0
is_aab = path.lower().endswith(".aab")
with zipfile.ZipFile(path) as z:
infos = [i for i in z.infolist() if i.filename.endswith(".so")]
if not infos:
print("lib/ に .so がありません。ネイティブコードなしと判断できます")
return 0
for info in sorted(infos, key=lambda i: i.filename):
hdr = read_program_headers(z.read(info))
if hdr is None:
continue
worst = min(hdr["loads"]) if hdr["loads"] else 0
aligned = worst >= 16384
stored = info.compress_type == zipfile.ZIP_STORED
# AAB の格納位置は配信 APK の位置と一致しないため、zip 境界は APK でだけ判定する
zip_ok = (data_offset(z, info) % 16384 == 0) if (stored and not is_aab) else None
flags = []
if not aligned: flags.append("LOAD=%d" % worst); ng += 1
if not hdr["relro"]: flags.append("RELRO なし")
if zip_ok is False: flags.append("zip 境界ずれ"); ng += 1
state = "UNALIGNED" if flags else "ALIGNED"
print("%-10s %-12s %-9s %s" % (state, hdr["arch"],
"stored" if stored else "deflated", info.filename),
("[" + " / ".join(flags) + "]") if flags else "")
if is_aab:
print("\n(AAB のため zip 境界は判定していません。APK で再確認してください)")
print("\n要対応: %d 件" % ng)
return 1 if ng else 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1]))p_align はプログラムヘッダの先頭から 48 バイト目にある 64 ビット値です。16 KB は 16384 ですので、PT_LOAD セグメントの p_align がすべて 16384 以上であれば ELF 側は満たしています。llvm-objdump が align 2**14 と表示するのと同じ値を、桁の表現だけ変えて読んでいます。
data_offset() のほうは、zip のローカルヘッダを読んで実データの開始位置を求めています。zipfile が返す header_offset はヘッダの位置であって、zipalign が揃えるのはその先のデータ開始位置です。ここを取り違えると、揃っている APK を「ずれている」と誤判定します。私は最初この違いに気づかず、正しいはずのビルドを不合格にしてしまいました。
8月版からの変更点は、拡張子が .aab のときに zip 境界の判定を外したことです。AAB は Play がそこから端末ごとの APK を組み立て直すための材料で、AAB の中での格納位置は、端末に届く APK の格納位置と同じではありません。AAB で zip 境界ずれ を数えると、実際には問題のない構成まで「要対応」に入ってしまいます。ELF は AAB で、zip 境界は APK で。 見るファイルを取り違えないことが、この検査でいちばん効く線引きでした。
APK は EAS Build の buildType: "apk" のプロファイルで出すか、bundletool で AAB から作ったものを使います。どちらも、Play が実際に配る APK と完全に同じとまでは言い切れませんので、最終確認は次に書く Play Console 側の表示と合わせて行っています。
出力の読み分け: LOAD=4096 と zip 境界ずれは、直し方が違う
検証のため、4 KB リンクの .so と 16 KB リンクの .so を用意し、APK と同じ構造の zip に詰めて実行しました。以下は実際の出力です。
$ python3 check_16kb.py sample-app.apk
UNALIGNED x86_64 stored lib/arm64-v8a/libapp.so [zip 境界ずれ]
ALIGNED x86_64 deflated lib/arm64-v8a/libhermes.so
UNALIGNED x86_64 stored lib/arm64-v8a/libthirdparty.so [LOAD=4096 / zip 境界ずれ]
要対応: 3 件
検証環境の都合で arch 列が x86_64 になっていますが、実際の APK では arm64-v8a が表示されます。この列は ELF ヘッダの機種フィールドを読んでいますので、lib/arm64-v8a/ の下にあっても中身が別アーキテクチャなら、それはそれで気づける作りにしてあります。
次に、.so の実データが 16384 の倍数に載るよう詰め物を入れた zip を作り直して、同じ検査を通しました。
$ python3 check_16kb.py aligned-app.apk
ALIGNED x86_64 stored lib/arm64-v8a/libapp.so
ALIGNED x86_64 deflated lib/arm64-v8a/libhermes.so
UNALIGNED x86_64 stored lib/arm64-v8a/libthirdparty.so [LOAD=4096]
要対応: 1 件
libapp.so の zip 境界ずれ は消えましたが、libthirdparty.so の LOAD=4096 は残りました。この差が、実務でいちばん効いてくる区別です。
| 出力 | 原因 | 直す人 |
|---|---|---|
zip 境界ずれ のみ | パッケージング側。APK に詰めるときの位置 | 自分(ビルド設定の更新で解消) |
LOAD=4096 | .so そのものがリンク時に 4 KB 前提で作られている | そのライブラリの提供者(または自分で再ビルド) |
RELRO なし | 再配置セクションが読み取り専用化されていない | 提供者。16 KB 環境ではクラッシュ要因になり得ます |
zip 境界ずれ だけであれば、Android Gradle Plugin 8.5.1 以上へ上げるだけで解消します。一方 LOAD=4096 は、自分のビルド設定をいくらいじっても直りません。配布されているバイナリの中身の問題ですので、依存の更新を待つか、置き換えるかの判断になります。
この2つを分けずに「16 KB 対応」とひとくくりにしてしまうと、直せない相手にビルド設定を延々と試すことになります。個人開発では、その数時間がそのまま期限との差になります。
検査の手段はどれを選ぶか
16 KB の確認手段は、いまでは自作スクリプト以外にもいくつかあります。それぞれ得意な場面が違いますので、私の使い分けを表にしておきます。
| 手段 | 必要なもの | 分かること | 向いている場面 |
|---|---|---|---|
| Play Console の App Bundle Explorer | アップロード済みのバンドル | Play が判定した 16 KB 対応の可否 | 最終判断。提出物そのものの結果 |
| Android Studio の APK Analyzer | Android Studio 本体 | .so ごとのアライメント警告 | 手元で原因の .so を特定するとき |
公式スクリプト check_elf_alignment.sh + zipalign -c -P 16 | SDK build-tools と NDK | ELF と zip の両方を公式の道具で | ツールチェーンが揃った CI |
| 本記事の Python スクリプト | Python 3 だけ | ELF の LOAD と RELRO、APK の zip 境界 | EAS 任せで手元に NDK がない環境・軽い CI |
判断基準を一文にすると、**「直せるかどうかを知りたいときは手元の道具、出せるかどうかを知りたいときは Play Console」**です。自作スクリプトは早く原因に近づくための道具で、提出の可否を最終的に決めるのは Play 側の判定です。スクリプトが 0 件でも Play Console が警告を出しているなら、Play Console のほうを信じて原因を探し直します。
よくある誤解を三つ
この話題で、私自身が一度は信じかけたものを挙げます。
一つ目は「16 KB 対応は targetSdk を上げれば済む」という誤解です。targetSdk は要件の対象になるかどうかを決めるだけで、.so のアライメントは何も変わりません。むしろ 35 以上に上げたことで、要件の内側に入ります。
二つ目は「警告が出たら、まずビルド設定を見直す」という順番です。LOAD=4096 が出ている場合、ビルド設定はほとんど関係しません。公式ドキュメントも、ネイティブライブラリは 16 KB 境界でリンクし直す必要があると書いています。先に検査で原因の種類を分けてから、手を動かす場所を決めるほうが早いのです。
三つ目は「android:pageSizeCompat を入れれば対応済み」という理解です。これは互換モードの警告表示を抑える設定で、アプリが 16 KB に対応したことにはなりません。この点は後の節で詳しく書きます。
Expo / Rork のプロジェクトで実際に効く手当て
React Native 本体は 0.77 で 16 KB ページサイズに対応しました(React Native 0.77 のリリースノート)。Expo SDK でいえば 53 以降が該当し、Expo 側の案内も expo/fyi の 16 KB ページサイズのメモにまとまっています。Rork が生成する現行構成(2026年11月時点で SDK 58 系)をそのまま使っている限り、コア側で LOAD=4096 が出ることはまずありません。
問題になるのは、あとから足したサードパーティのネイティブモジュールです。地図、動画、決済、機械学習まわりのライブラリは更新が滞りやすく、リポジトリでは新しいバージョンが出ていても、npm 上の最新版に古い .so が残っていることがあります。
手順としては、次の順で確認するのが早いです。
- EAS Build から
.aabをダウンロードし、上の検査を通します。ここで.soが 0 件なら、そもそもこの要件の対象外です LOAD=4096が出た.soのファイル名から、どの npm パッケージが持ち込んだものかを特定します。node_modulesの中で同じファイル名を検索すると早いです- そのパッケージの更新履歴を確認します。多くは「16 KB support」の一行が入ったバージョンが出ています
- 更新で消えない場合は、
expo-build-propertiesでndkVersionなどのビルド条件を揃え、自前でプリビルドし直せるか検討します - それでも残るなら、そのライブラリを置き換えるか、期日までに解決するかを判断します
2番目の特定には、次の1行が役に立ちました。.so の名前が分かれば、どのパッケージ由来かはたいていすぐに分かります。
# libthirdparty.so をどのパッケージが持ち込んだかを調べる
find node_modules -name 'libthirdparty.so' -not -path '*/intermediates/*' | headなお、ネイティブ側に手を入れる前に、expo prebuild の既定変更で自分の変更が消えないかを確かめておくことをおすすめします。この点はプリビルドで消えるネイティブ変更を洗い出す記事に手順を書いています。依存ライブラリ側で targetSdk 36 に合わせて確認すべき箇所は、依存ライブラリのどこを見るかをまとめた記事に分けてあります。
16 KB backcompat モードという逃げ道と、その代償
公式ドキュメントには、16 KB カーネルの端末が 4 KB 前提のアプリを動かすための互換モードが記載されています。.so の LOAD が 4 KB で、かつ非圧縮の .so が 4 KB 境界に載っている場合、パッケージマネージャがこのモードを有効にします。
ただし、初回起動時に「互換モードで動作しています」という警告ダイアログが表示されます。ユーザーから見れば、アプリを開いた最初の体験がその警告です。マニフェストの android:pageSizeCompat を設定すればダイアログは出なくなりますが、互換モードで動いている事実は変わりません。
私はこれを「期日までの一時しのぎ」として位置づけています。動くことと、意図した状態であることは別です。互換モードに寄りかかったまま忘れると、次にこの話題が浮上するのは、ユーザーからの「起動時に変な表示が出る」という問い合わせになります。
期日までの作業の線引き(11月時点)
ここまでを、いまの作業リストという観点でまとめ直します。
対象 API レベル36 は、延長を含めて期限を過ぎました。まだ 36 に上がっていないアプリは、16 KB より先にそちらを片付けないと、そもそも更新が出せません。16 KB の警告は Play Console に赤く出ていても、2027年2月1日までに片付ければよい作業です。
ただし、検査自体は今日のうちに一度通しておくことをおすすめします。理由は単純で、LOAD=4096 が出た場合は自分では直せず、依存の更新を待つ時間が要るからです。年末年始をはさむと、ライブラリの更新はさらに遅れがちになります。「直せない項目がいくつあるか」を早く知っておくほど、選べる手が増えます。逆に zip 境界ずれ だけなら、ビルド設定の更新で片付く話ですので、急ぐ必要はありません。
次に詰まりやすい一歩: 16 KB の端末で実際に起動させる
検査が 0 件になったあと、多くの方が次に当たるのは「本当に 16 KB の端末で動くのか」という確認です。検査はファイルの形を見ているだけで、起動時の挙動までは保証しません。
Android Studio の Device Manager で、システムイメージ一覧から「16 KB Page Size」と付いたものを選んでエミュレータを作ると、16 KB カーネルで動かせます。起動したら、ページサイズを確かめてからアプリを入れます。
adb shell getconf PAGE_SIZE
# 16384 と表示されれば 16 KB カーネルで動いています
adb install app-release.apk
adb logcat | grep -iE 'dlopen|page size|linker'起動直後に落ちる場合は、logcat に dlopen の失敗としてどの .so で止まったかが出ます。そこで名前が分かれば、切り分け表の3行目に戻ってパッケージを特定する流れになります。
対象 API レベル36 に上げた際に一緒に浮上しやすい挙動の変化については、Android 16 の予測型「戻る」をいつ直すかの判断でも扱っています。期限に必要な作業と、切り離せる作業の線引きという意味では、本記事と同じ考え方に立っています。
期限が重なる時期は、どうしても目の前の赤い表示から順に手をつけたくなります。条件と期日を並べて書き出すだけで、その日にやるべきことが半分になることもあるのだと、この夏に気づかされました。まずは直近の APK か AAB を1本だけ、上の検査に通していただければと思います。結果が「要対応: 0 件」なら、この話は2月まで頭から外して構いません。