目标 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 这种示例前缀,推荐使用你自己持有的域名反写,或者品牌名。

gradle
// 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"
    }
}

包名与开发者账号的归属问题

包名一旦在某个开发者账号下创建,就与该账号绑定。如果账号更换所有者,包名随账号走;如果走应用转移,包名随应用转移,但需要满足签名与账号状态的要求。因此买号时,要清楚名下每个应用的包名、签名方式与是否带有上传密钥。

如果你想用自己已有的包名发布,而这个包名已经在别人的账号里,那就需要对方通过官方应用转移把应用转给你,而不是你重新注册。这个区别在「整号转移与应用转移」中有详细对比。

首发前的定稿清单

  1. 确定包名,并确认没有使用示例域名或他人品牌
  2. 确认 targetSdk 满足当期要求,并完成新系统的回归测试
  3. 输出 AAB,并检查 64 位库是否齐全
  4. 确认签名方式:Play 应用签名 + 自己保管上传密钥
  5. 提前在内部测试轨道上传一次,让告警尽早暴露

这些检查花不了多少时间,却能避免首发被卡。

延伸阅读:

相关指南

相关业务