目标 API 级别:为什么每年都要升
Android 应用的 targetSdkVersion 声明了应用适配到哪个系统版本。Google Play 为了让用户获得更新的安全与隐私保护,会定期提高新应用与更新所需的最低目标 API。大致节奏是:每年新一代 Android 发布后,在当年约 8 月 31 日之前后,要求新应用和更新必须面向前一年或当年发布的 API 级别。
具体数字请以 Google 当期的「目标 API 级别要求」帮助页为准,这里不写死版本号,因为它每年变化。你可以在管理中心上传包时的提示里,直接看到不达标的告警。
不满足要求会怎样
- 新应用:上传阶段就被拒绝,无法进入测试或正式轨道
- 已有应用:到期后无法发布更新,已安装用户仍可使用,但新设备上的可见性可能下降
- 长期未更新且目标 API 过低的应用,可能在较新系统上对新用户不可见
- 可以申请延期,但需要提供理由,且不保证获批
因此,购买带应用账号的买方要特别留意:账号名下旧应用若长期没有更新,目标 API 多半已不达标,接手后第一次发布就会被卡。
同主题还可对照:
与发布相关的其他构建要求
| 要求 | 说明 | 自查方式 |
|---|---|---|
| AAB 格式 | 新应用必须以 Android App Bundle 上传 | Gradle 使用 bundleRelease |
| Play 应用签名 | 新应用通过 Play 应用签名发布 | 首次上传时在管理中心登记 |
| 64 位支持 | 含原生代码的应用需提供 64 位版本 | 检查 abiFilters 与 so 库 |
| 目标 API | 满足当期最低要求 | 查看 build.gradle 的 targetSdk |
| 权限声明 | 敏感权限需要说明用途 | 对照权限与功能清单 |
升级 targetSdk 不只是改一个数字,还要测试新系统的行为变更,比如后台限制、通知权限、媒体访问、前台服务类型声明等。建议预留几天回归时间,别拖到最后一周。
包名(Application ID)规则
包名是应用在 Google Play 里的唯一标识,例如 com.example.app。格式要求:至少包含两段,以字母开头,只含字母、数字与下划线,用点分隔。最关键的规则是:一旦应用发布,包名就无法更改,要换包名只能发布一个全新的应用,现有用户、评分与统计都不会迁移。
同一个包名在全球 Play 范围内是唯一的,已经被他人占用的无法使用;即使你删除了应用,包名也不会被释放给别人。所以,不要用 com.example 这种示例前缀,推荐使用你自己持有的域名反写,或者品牌名。
// app/build.gradle(示例,数值以当期 Google Play 要求为准)
android {
namespace "com.example.notes"
defaultConfig {
applicationId "com.example.notes" // 发布后永久不可改
minSdk 24
targetSdk 35 // 按当年目标 API 要求更新
versionCode 1
versionName "1.0.0"
}
}包名与开发者账号的归属问题
包名一旦在某个开发者账号下创建,就与该账号绑定。如果账号更换所有者,包名随账号走;如果走应用转移,包名随应用转移,但需要满足签名与账号状态的要求。因此买号时,要清楚名下每个应用的包名、签名方式与是否带有上传密钥。
如果你想用自己已有的包名发布,而这个包名已经在别人的账号里,那就需要对方通过官方应用转移把应用转给你,而不是你重新注册。这个区别在「整号转移与应用转移」中有详细对比。
首发前的定稿清单
- 确定包名,并确认没有使用示例域名或他人品牌
- 确认 targetSdk 满足当期要求,并完成新系统的回归测试
- 输出 AAB,并检查 64 位库是否齐全
- 确认签名方式:Play 应用签名 + 自己保管上传密钥
- 提前在内部测试轨道上传一次,让告警尽早暴露
这些检查花不了多少时间,却能避免首发被卡。
延伸阅读:
相关指南
相关业务