AABのアップロードと容量:Play提出でよくある問題
AABとAPKの違い、アップロード失敗の切り分け、容量と機能モジュールの注意点。技術と提出で同じ用語を使う。Telegram @hagee66。
この記事 · ガイド一覧 · Apple提出 · Google提出 · 両ストア · Telegram @hagee66
Google Play の新規アプリと更新は Android App Bundle(AAB) が中心です。現場でよくある摩擦は、開発が APK を直接インストールするのに慣れている一方、運用が Console のアップロード入口を見つけられないこと、または AAB のアップロード失敗を「容量オーバー」と思い込み、実際は署名や versionCode の問題であることです。本稿は AAB と APK の違い、失敗時の確認順、容量と機能モジュールの注意点を、技術と提出が同じ言葉で話せるようにまとめ、Play のリリーストラック と 提出材料 につなげます。形式・上限・端末向け APK 生成のルールは変わります—公式の現行ドキュメントに従ってください。アップロード成功は審査通過を保証しません。上架通 goee.cc の協力は Telegram @hagee66 まで。
このガイドで解決すること
- Console が AAB を求めるのに、ローカル検証ではなぜまだ APK を使うのか。
- アップロードエラー(
versionCodeの増加必須、署名無効、Play App Signing 未確認など)を通信障害と誤解して何度も上げ直すこと。 - 容量膨張:非圧縮アセット、重複 ABI、デバッグ記号、未分割リソースによるダウンロード体験と評価の悪化。
- Dynamic Feature / Asset Delivery を有効にしたのに、ストア文言に「一部は後からダウンロード」と書かず、ユーザー期待と食い違うこと。
- iOS のビルド番号感覚と混同し、Android の
versionCodeを上げずにアップロードが止まること。
読む人
| 役割 | 用途 |
|---|---|
| Android エンジニア | リリース用 bundle、署名と versionCode |
| 提出担当 | 正しいトラックへアップロード、英語エラーの読み取り |
| プロダクト | 任意モジュール、「初回ダウンロードサイズ」の正直な説明 |
| QA | 「Play からインストール」と adb install APK の違い |
アップロード前の材料と宣言:プレチェック採点表;鍵:署名と証明書の引き継ぎ。
実務の要点
AAB と APK:どこで使うか
| 観点 | AAB | APK |
|---|---|---|
| Play への提出 | 標準フロー | 新規・更新は原則 AAB(例外は公式ドキュメント) |
| ローカルデバッグ / CI スモーク | 直接インストールは稀 | adb install が使える |
| ユーザーが落とすもの | 端末向けに最適化された APK / 分割 | ユニバーサル APK は大きくなりがち |
| 容量の見え方 | バンドル容量 ≠ ユーザーのダウンロード容量 | 手元の単一 APK サイズが見える |
チームの約束:Play 提出は署名済みリリース AAB;テスターのスモークは APK か内部トラックのリンク。
アップロード前の必須確認
versionCodeは、いずれの Play トラック(内部含む)の最大値より厳密に大きいこと。iOS のバージョン管理 と突き合わせ、同日リリースの混乱を防ぐ。- 署名は正しいアップロード鍵;Console で Play App Signing を確認。署名引き継ぎ。
targetSdk/ 権限変更—バンドルだけでなく Data Safety とストア文言も同期。- トラック選択:internal / closed など。Play リリーストラック。
アップロード失敗:この順で切り分け
1. versionCode 未増加 → 番号を上げて再ビルド
2. 署名 / アップロード鍵不一致 → keystore / Play 側の状態確認
3. パッケージ名 ≠ Console のアプリ → applicationId を確認
4. 必須メタデータ未完了 → レーティング・ポリシーなど Console の案内を先に
5. 転送 / ブラウザ → 回線変更、公式のアップロード手段があればそちら
6. 禁止コンポーネントやポリシー衝突 → 宣言とバンドルの一致、純粋な技術問題だけではない
エラー全文をリリースログに貼る—「Upload failed」のスクショだけで済ませない。
容量:エンジニアリング側のレバー
- アセット:巨大 PNG より WebP / ベクター;密度別、万能巨大画像を避ける。
- ABI:バンドル分割—すべての
.soを1つの APK に詰め込む発想をやめる(Gradle/AGP に従う)。 - 言語:
resConfigsで配布言語を絞り、ストアのローカライズと揃える。 - デバッグ:リリースでデバッグフラグを切り、未使用リソースを削る(R8/Proguard を検証)。
- SDK:広告・解析・地図は容量と権限の両方に効く—SDK 開示チェックリスト と同期。
「200MB ダウンロード」という苦情は、初回インストール+アセットモジュールの合計かも。ストア文言で「一部は初回利用時に追加ダウンロード」と正直に書ける(実挙動と一致必須)。
機能モジュールと Play Asset Delivery
動的機能や大きなアセット配信を使う場合:
- テストトラックで、初回起動 / 最初のレベルが追加ダウンロードを要するか検証する。
- 弱回線・低ストレージ向けに明確な UI。黙って落ちない。
- Console とストアが「完全オフライン」を約束しない(コア資産がオンライン取得なら)。
詳細は現行の Google Play ドキュメント—本稿はモジュール種別を網羅しない。
提出側が欲しい数字
エンジニアから4つ:versionName、versionCode、バンドルファイルサイズ、前回比の一行差分。リリースノートをテンプレ化し、「上げたがどの版か」を防ぐ。
コピペ用テンプレ
AAB アップロードログ
[AABアップロードログ]
アプリ:
パッケージ名:
対象トラック: internal / closed / open / production
versionName:
versionCode(現行いずれより大):
AAB SHA256(任意):
アップロード鍵の所有者:
前回からの変更:
新権限 / SDK: Y / N;Data Safety 再確認: Y / N
アップロード担当:
時刻:
Console結果: 処理中 / トラック反映 / 失敗(全文)
テストインストール担当:
容量レビュー(大きめのリリース)
[容量レビュー]
バージョン:
バンドルサイズ:
前回比: + / - MB
主な差分:
新規 SDK:
ユーザー向け追加DL説明(ストア / アプリ内):
来週の改善1つ:
失敗の記録
[アップロード失敗]
時刻:
versionCode:
英語エラー全文:
除外済み: 回線 / ブラウザ / アカウント権限
次アクション:
担当:
よくあるミス
- デバッグ署名の AAB を上げる。 リリーストラックはリリース署名が必要。
versionNameだけ変えて code を上げない。 Play はあなたの「新版感」ではなく code を見る。- 手元の APK サイズ=ユーザーDLサイズと思う。 Play ビルドの実インストールサイズを見る。
- アップロード成功→内部スモークなしで本番。 リリーストラックガイド参照。
- 言語を削ったのにストアはその国を狙う。 インストール後に壊れた UI。
- Console のプレローンチ指摘を無視。 プレローンチレポート とセット。
- iOS と Android を同日に同じリリースノートで出すが版番号がずれる。 プラットフォームごとに code/build を分ける。
FAQ
テストも必ず AAB か?
内部トラックは通常 AAB;ローカルは APK 可。現行のアップロード UI に従う。
アップロード後いつインストールできるか?
処理に時間がかかる;国・トラックで違う。「処理完了」時刻をログし、即時を前提にしない。
容量上限を超えたら?
上限と拡張配信は公式ドキュメント。まず容量レビューとモジュール分割—検査逃れはしない。
APK と AAB は併用できるか?
方針は現行 Google;新規は AAB 優先。古い「両方上げる」ブログに頼らない。
失敗したアップロードは審査回数に効くか?
失敗は通常ユーザー向け版を消費しない;悪いパッケージの連投はポリシー注意の対象になり得る。直してから再アップロード。
Hermes / 16KB ページサイズなどの新要件は?
公式告知と Console の案内に従う—本稿はコンプライアンス速報ではない。
次の一手
- 次回リリース前に AAB アップロードログ を埋め、Play リリーストラック のチェックリストと合わせる。
- 署名引き継ぎ と
versionCodeルール。 - Google Play 提出材料 のバンドルと権限項目。
- 大きめのリリース:容量レビュー と SDK 一覧。
- 両プラットフォーム:iOS の version と build。