博客

Play 管理中心「已有版本使用了版本代码」原因与解决办法

上传 AAB 提示「已有版本使用了版本代码」?分清何时点「从内容库添加」,以及 Gradle、Flutter、Expo、Unity 递增 versionCode 的改法。

几乎每个 Android 开发者在往 Google Play 管理中心(Play Console)传第二个包时,都会撞上这条报错。在步骤 1 — 创建发布版本页面,刚把新打好的 .aab 拖进 app bundle 上传框,下方立刻跳出红字:

已有版本使用了版本代码“<X>”。请尝试改用其他版本代码。

(部分旧版界面显示为 版本代码<X>已被使用。尝试另一个版本代码。;如果通过 Fastlane、GitHub Actions 等发布 API 上传,返回的英文报错则是 APK specifies a version code that has already been used.。)

之所以连踩坑,是因为 Play 管理中心有两条和直觉相反的规则:

  1. versionCode 不等于 versionName。只把展示给用户的版本号从 1.0.0 改成 1.0.1 没有任何作用——Play 管理中心只认正整数 versionCode(1、2、3……)来区分每一次构建。
  2. 任何上传过的 .aab 都会永久占用该 versionCode。只要软件包上传成功,这个整数在当前应用下就永远不能再次上传——哪怕你当时点了「舍弃草稿版本」根本没有发布,或者之前只是传到了内部测试轨道。

先别急着改配置重新打包——先看你有没有改过代码,两种情况的处理方式完全不同。

1没改代码?直接点「从内容库添加」,不要重复上传文件

如果你属于下面这两种情况,完全不需要改 versionCode 重新打包:

  • 同一个包已经在内部测试测完了,现在想原封不动发到封闭式测试或正式版。
  • 刚才上传过 .aab,中途点了舍弃草稿版本(或不小心关掉了网页),现在想用同一个包重新创建发布版本。

这时候把本地电脑里的同一个 .aab 再拖进上传框,后台一定会报版本代码已被使用——因为这个包已经躺在后台的内容库里了。正确做法是:

  1. 进入目标轨道(例如 测试和发布 > 测试 > 封闭式测试),点击创建新的发布版本。
  2. 在 app bundle 区域里,不要点上传,直接点击旁边的从内容库添加(Add from library)。
  3. 在弹出的列表里勾选刚才已经传上去的那个包(versionCode <X>)并添加到当前发布版本。
  4. 填好版本说明,点下一步进入预览并确认即可正常发布。

2改了代码?在对应框架里把整数 versionCode 加 1

只要你修了 Bug、改了 AndroidManifest.xml 权限或更新了依赖重新打包,就必须在打包前把整数 versionCode 至少 +1。

Android Studio / 原生 Gradle

打开 app/build.gradle.kts(或 app/build.gradle),调高 defaultConfig 里的 versionCode:

android {
    defaultConfig {
        applicationId = "com.yourbrand.app"
        minSdk = 24
        targetSdk = 35
        versionCode = 2        // 每次新打包上传都必须递增的正整数
        versionName = "1.0.1"  // 商店展示版本号,改不改都不影响后台判重
    }
}

(如果是 Groovy 语法的 app/build.gradle,去掉等号写成 versionCode 2 和 versionName "1.0.1" 即可。)

Flutter

Flutter 在 pubspec.yaml 的 version 字段里用 + 号把两个版本号连在一起——+ 号前面是 versionName,+ 号后面的整数才是 Android 的 versionCode:

# pubspec.yaml
version: 1.0.1+2

保存后运行 flutter build appbundle --release 重新打包;如果在 CI 里自动构建,也可以不改文件直接传参覆盖:

flutter build appbundle --release --build-name=1.0.1 --build-number=2

如果改完 +2 上传还是提示版本代码 1 已被使用,打开 android/app/build.gradle(.kts) 检查一下是不是把默认的 versionCode = flutter.versionCode 手写死成了 1。

Expo / React Native

使用 EAS Build 云端打包时,最省心的做法是在 eas.json 里配置远程自增,让 EAS 服务器每次打包自动把 versionCode 加 1,避免本地漏改:

{
  "cli": {
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    }
  }
}

如果习惯在本地代码里手动管理版本号,打包前把 app.json 里的 expo.android.versionCode 加 1 即可:

{
  "expo": {
    "version": "1.0.1",
    "android": {
      "versionCode": 2
    }
  }
}

(纯 React Native 裸工程没有 app.json,直接按上面 Android Studio 的方式修改 android/app/build.gradle 中的 versionCode。)

Unity

依次打开菜单 Edit > Project Settings > Player,切到 Android 标签页并展开 Other Settings。在 Identification 下方,Version(如 1.0.1)对应展示版本号 versionName,而 Bundle Version Code(如 2)才是整数 versionCode。把 Bundle Version Code 加 1,确认勾选 Build App Bundle (Google Play) 后重新导出即可。

3忘了已经用到几号?去「最新版本和 app bundle」一眼查清

如果之前舍弃过几次草稿,或者在内部测试、CI 里传过好几轮构建,很容易记不清下一个可用整数到底该填几。

打开 Play 管理中心左侧菜单的 测试和发布 > 最新版本和 app bundle(或切到 App bundle 资源管理器标签页),这里会完整列出该应用历史上传过的每一个 .aab——不管是挂在内部测试、已暂停的轨道,还是早就被舍弃的草稿版本都在里面。看一眼列表最上方最大的版本代码,把下一次打包设成「最大数字 + 1」就稳过了(跳号也完全合法,比如直接从 3 跳到 10)。

4关联报错:「不允许任何现有用户升级到新添加的应用程序包」

有时候 versionCode 没有重复,但在点下一步进入预览并确认时,会被另一条和版本号顺序直接相关的报错拦下:

您无法推出此版本,因为它不允许任何现有用户升级到新添加的应用程序包

(在新版界面中也常显示为:此版本未允许任何现有用户升级至新添加的 app bundle,因此无法发布。)

这叫版本覆盖异常(Version Shadowing),通常由以下三种操作引起:

  • 从内容库选了旧包:当前轨道在架版本已经是 versionCode 5,你却点从内容库添加选了 versionCode 3 或 4。Google Play 不允许测试或正式轨道上的用户降级。
  • 没加新包就直接点下一步:点了创建新的发布版本,但 app bundle 框里什么新包都没加就直接去预览。
  • 新包缩窄了设备兼容范围:虽然 versionCode 更大,但新包调高了 minSdkVersion、删掉了 arm64-v8a 架构,或新增了严苛的 <uses-feature> 硬件要求,导致原本在架版本的老设备全都无法升级。

解决办法很简单:核对页面上上一版本(Previous release)显示的在架 versionCode,确保新添加的 .aab 拥有严格大于它的 versionCode 且兼容原有设备,同时把当前草稿里低版本的旧包移除。

14 天封闭式测试里,为什么要多发几个 versionCode?

如果你在预览并确认页面还碰到了 16 KB 内存页面大小对齐、AD_ID 广告 ID 权限冲突,或是去混淆文件与调试符号两条黄色警告,可以对照总目录 Play 管理中心上传 AAB 报错汇总:常见原因与解决办法 逐项排查。

对于个人开发者账号来说,学会递增 versionCode 发新包不只是为了解报错。在 14 天封闭式测试期间,如果从头到尾只挂着最初的 versionCode 1 一动不动,最后申请正式版发布权限时很难证明你真的根据反馈做过迭代;反过来,在 14 天里针对测试人员提的细节问题实打实推上 3 个以上的新版本(versionCode 2、3、4……),既能在封闭式测试轨道留下清晰的更新记录,也能在问卷第 8 题写出具体的修复内容,大幅降低收到「需要进行更多测试」被拒邮件的概率。

当然,多发几个版本的前提是真有人装在手机上持续打开。在 BetaLobby(完全免费,无付费套餐)里,你可以加入 16 人组队模式并共用同一个 Google 群组,免截图核验真机安装,通过 14 天每日打卡保证每次推上去的新版本都有人真正在手机上打开。