AAB 上传与体积:Play 上架包体常见问题
AAB 与 APK 差异、上传失败常见原因、体积与功能模块注意点。给技术与上架同学对齐术语。Telegram @hagee66。
官网传送门(可直接点击跳转)
打开本文 · 指南库 · 苹果上架 · 谷歌上架 · 双端上架
Telegram 询价 @hagee66 · 官网 goee.cc
Google Play 面向新应用与更新的分发格式以 Android App Bundle(AAB) 为主。团队里常见摩擦是:研发习惯打 APK 直接装,运营在 Console 里找不到上传入口;或 AAB 上传失败,报错信息被当成「包太大」其实却是签名或 versionCode 问题。本文把 AAB 与 APK 的差异、上传失败排查顺序、体积与功能模块注意点写给技术与上架同一套话,并衔 Play 发布轨道 与 材料清单。Play 对格式、大小上限、设备生成 APK 的规则会调整,以官方当前文档为准。不承诺上传成功即过审。上架通 goee.cc 协作可联系 Telegram @hagee66。
这篇要解决的问题
- 不清楚为什么 Console 要 AAB,本地测试为什么还要 APK。
- 上传报错:版本号必须升高、签名无效、缺少 Play App Signing 确认等,被误判为网络问题反复传。
- 包体积暴涨:资源未压缩、重复 ABI、调试符号、未拆分的资源导致下载体验差,进而引发差评。
- Dynamic Feature / Asset Delivery 开了模块,但商店描述没写清「部分内容需下载」,与用户预期冲突。
- 与 iOS 构建号思维混用,Android
versionCode未递增导致无法上传。
谁应该读
| 角色 | 用途 |
|---|---|
| Android 研发 | 打 release bundle、对齐签名与 versionCode |
| 上架执行 | 在正确轨道上传、读懂常见英文报错 |
| 产品 | 评估是否做可选模块、对用户说明「首次下载大小」 |
| 测试 | 区分「从 Play 安装」与「adb 装 APK」行为差异 |
上传前材料与声明见 上架预检评分表;密钥问题见 证书与签名交接。
核心做法
AAB 与 APK:各自用在哪
| 维度 | AAB | APK |
|---|---|---|
| 提交 Play | 标准提交流程 | 新应用与更新通常要求 AAB(例外以官方为准) |
| 本地调试 / CI 冒烟 | 一般不直接装 AAB | 可直接 adb install |
| 用户设备实际下载 | Play 按设备生成优化 APK / split | 你本地打的 universal APK 往往更大 |
| 体积感知 | 开发者看 bundle 大小 ≠ 用户下载大小 | 单 APK 即所见 |
团队口头约定:给 Play 的是 signed release AAB;给测试员冒烟的可以仍是 APK 或内部轨道安装链接。
上传前硬性检查
- versionCode 严格大于该应用在 Play 上已有任意轨道的最高值(含内部测试)。与 iOS 版本号规范 对照管理,避免跨端发版日混乱。
- 签名 使用正确的 upload key;Play App Signing 状态在 Console 核对。见 证书与签名交接。
- targetSdk / 权限变更 若本版有变,同步 Data Safety 与商店说明,不要只传包。
- 轨道选择:上传到计划轨道(内部 / 封闭等),见 Play 发布轨道。
上传失败:按顺序排查
1. versionCode 未递增 → 升 code 重打
2. 签名与 upload key 不匹配 → 核对 keystore / Play 重置状态
3. 包名与 Console 应用不一致 → 检查 applicationId
4. 必要元数据未完成 → Console 提示项(分级、政策等)先填
5. 传输中断 / 浏览器 → 换网络、用官方推荐上传方式(若提供)
6. 含禁止组件或政策冲突 → 对照包内容与声明,非单纯技术错误
报错原文应贴进版本日志,方便协作方判断,不要只截「Upload failed」。
体积:研发侧可做的减法
- 资源:WebP/矢量替代过大 PNG;按密度提供,避免 universal 巨图。
- ABI:配合 bundle 拆分,避免所有 .so 打进单包思想(具体以 Gradle / AGP 配置为准)。
- 语言资源:
resConfigs只保留需要的语言,与商店本地化计划一致。 - 调试与日志:release 关闭调试开关、剥离未使用资源(R8/Proguard 规则需测试)。
- 第三方 SDK:广告、统计、地图 SDK 往往是体积与权限双重复合问题,与 SDK 披露清单 同步盘点。
用户侧「我的 App 要下载 200MB」投诉,有时是首装 + 资源模块;商店描述里可诚实写「部分内容首次使用后下载」(表述勿夸大,与真实行为一致)。
功能模块与 Play Asset Delivery
若使用动态功能模块或大型资源交付:
- 测试轨道必须验证「首次打开 / 首次关卡」是否需要额外下载。
- 弱网与存储不足场景要有清晰提示,避免闪退。
- Console 与商店列表不要承诺「完全离线」若核心资源在线拉取。
细节以 Google Play 当前文档为准,本文不逐条枚举模块类型。
与上架协作对齐术语
上架同学需要的四个数字:versionName、versionCode、bundle 文件大小、相对上版变更一句话。研发发版说明模板化,减少「传了但不知道传的是哪版」。
可复制模板
AAB 上传登记
【AAB 上传登记】
应用:
Package name:
目标轨道:内部 / 封闭 / 开放 / 生产
versionName:
versionCode(> 线上一律值):
AAB 文件 SHA256(可选):
签名 upload key 保管人:
相对上版变更:
新增权限 / SDK:有 / 无;Data Safety 已复核:是 / 否
上传人:
上传时间:
Console 处理结果:处理中 / 已发布到该轨道 / 失败(附原文)
测试安装人:
体积复盘(大版本)
【体积复盘】
版本:
bundle 大小:
较上版:+ / - MB
主要增减来源:
是否引入新 SDK:
用户可见的额外下载说明(商店 / 应用内):
下周改进项(一条):
失败报错收集
【上传失败记录】
时间:
versionCode:
完整英文报错:
已排除:网络 / 浏览器 / 账号权限
下一步动作:
负责人:
常见误区
- 用 debug 签名的 AAB 上传。 Release 通道必须 release 签名。
- versionName 改了 code 没改。 Play 认 code,不认「我觉得算新版本」。
- 把 APK 体积当用户下载体积。 要对 Play 生成的安装大小做真机抽样。
- 上传成功就点生产,未走内部冒烟。 见发布轨道指南。
- 体积优化删掉必要语言资源,商店却开了该国。 下载后界面回退异常。
- 未读 Console 预启动检查提示。 与 发布前报告 配合看。
- iOS 与 Android 同一天发版,共用一份「版本说明」却版本号不对齐。 各写各的 code / build。
问与答
测试必须传 AAB 吗?
内部测试轨道一般也上传 AAB;本地测可用 APK。以 Console 当前上传界面要求为准。
AAB 上传后多久能装?
处理需时间,国家与轨道不同。不要假设秒级可用,在登记里写「处理完成」时间。
超过大小限制怎么办?
上限与是否可用扩展交付以官方文档为准。先体积复盘,再评估模块拆分,不要试图用不合规手段绕过检测。
和 APK 并存发布可以吗?
Play 政策以当前为准;新应用通常以 AAB 为主。不要依赖过时的「双轨上传」博客。
上传失败是否影响审核计数?
失败上传一般不消耗「用户可见版本」;但 repeated 低质包可能触发政策关注。修好再传。
Hermes / 16KB page size 等新要求怎么看?
Google 会发 target 与 deadline,以官方通知和 Play Console 提示为准,本文不替代合规公告。
下一步
- 下一次 release 前填 AAB 上传登记,与 Play 发布轨道 发版单合并。
- 核对 证书与签名交接 与 versionCode 递增规则。
- 完成 Google Play 上架材料清单 中与包体、权限相关的项。
- 大版本做 体积复盘,与 SDK 盘点联动。
- 双端版本管理对照 iOS 版本号与构建号规范。