ブログ

Play Console「バージョン コードはすでに使用されています」の対処法

Play Console で「バージョン コードはすでに使用されています」と出たときの対処法。「ライブラリから追加」を使う場面と、Gradle・Flutter・Expo・Unity での versionCode の上げ方を解説します。

Google Play Console に 2 回目以降の Android App Bundle(.aab)をアップロードするとき、ほぼ確実に一度はぶつかるのがこのエラーです。ステップ 1:リリースの作成 画面で .aab を App Bundle の枠にドロップした瞬間、すぐ下に赤字でこう表示されます。

バージョン コード <X> はすでに使用されています。別のバージョン コードをお試しください。

(Fastlane や GitHub Actions など Publishing API 経由でアップロードした場合は、APK specifies a version code that has already been used. という英語メッセージが返ります。)

初めての公開でここでつまずきやすい理由は 2 つあります。

  1. versionCode と versionName は別物である。ストア上に表示される文字列を 1.0.0 から 1.0.1 に書き換えても、Play Console がビルドの識別に使うのは正の整数である versionCode(1、2、3…)だけです。
  2. 一度アップロードした .aab の versionCode は永久に消費される。Play Console へのアップロードが完了した時点でその番号は使用済みとして記録され、たとえ「未公開のリリースの破棄」を押して公開しなかった場合でも、あるいは先に 内部テスト に上げただけの場合でも、同じ versionCode のファイルを再アップロードすることは二度とできません。

設定ファイルを書き換えて再ビルドする前に、まず「コード自体を変更したかどうか」を確認してください。状況によって正しい手順が分かれます。

1コードを変えていないなら、再アップロードではなく「ライブラリから追加」を使う

次のどちらかに当てはまる場合は、versionCode を増やしてビルドし直す必要はありません。

  • 内部テスト で動作確認を終えた同じビルドを、そのまま クローズド テスト や 製品版 に展開したい。
  • 先ほど .aab をアップロードしたあと、未公開のリリースの破棄 を押した(またはタブを閉じた)ため、同じファイルでもう一度リリースを作り直したい。

すでに Play Console 内のライブラリに同じ .aab が保管されているため、手元のファイルをもう一度ドロップすると重複エラーになります。ファイルを上げ直す代わりに、次の手順で既存のバンドルを選択してください。

  1. 公開先のトラック(例:テストとリリース > テスト > クローズド テスト)を開き、新しいリリースを作成 をクリックします。
  2. App Bundle セクションの中にある アップロード のすぐ横の ライブラリから追加 をクリックします。
  3. 一覧からアップロード済みのバンドル(versionCode <X>)にチェックを入れて追加します。
  4. リリースノート を入力し、次へ を押して プレビューして確認する へ進めばそのまま公開できます。

2コードを変更したなら、フレームワーク側で整数の versionCode を +1 する

バグ修正、AndroidManifest.xml の変更、SDK 更新などで新しく .aab をビルドし直すときは、毎回必ず整数の versionCode を +1 以上増やしてからビルドします。

Android Studio / Gradle

app/build.gradle.kts(または app/build.gradle)を開き、defaultConfig 内の versionCode を 1 つ増やします。

android {
    defaultConfig {
        applicationId = "com.yourbrand.app"
        minSdk = 24
        targetSdk = 35
        versionCode = 2        // 新しい .aab を上げるたびに +1 以上増やす整数
        versionName = "1.0.1"  // ユーザー向けの表示バージョン(重複判定には使われない)
    }
}

(Groovy 記法の app/build.gradle の場合は = を省き、versionCode 2、versionName "1.0.1" と記述します。)

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 に変えても versionCode 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 を増やしてからビルドします。

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

(Expo を使わない React Native プロジェクトでは、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どこまで番号を使ったか忘れたら「最新のリリースとバンドル」を確認する

下書きの破棄や CI でのテストアップロードを繰り返していると、次に使うべき番号が 3 なのか 6 なのか分からなくなることがあります。

Play Console 左メニューの テストとリリース > 最新のリリースとバンドル(全履歴を見るなら App Bundle エクスプローラ タブ)を開くと、これまでにそのアプリへアップロードしたすべての .aab が一覧表示されます。内部テスト だけのビルドや、一時停止中のトラック、公開前に破棄した下書きのバンドルもすべてここに残っています。一番上にある最大の バージョン コード を確認し、次のビルドには「その番号 + 1」以上を設定してください(3 から 10 のように番号が飛んでも問題ありません)。

4関連エラー:「新たに追加された App Bundle へのアップグレードを許可していない」

versionCode の重複はクリアしたのに、次へ を押した ステップ 2:プレビューして確認する で次のエラーが出て公開できないケースがあります。

このリリースは公開できません。既存のユーザーに対し、新たに追加された App Bundle へのアップグレードを許可していないためです。

これはバージョン シャドウイング(Version Shadowing)と呼ばれる状態で、主に次の 3 パターンで発生します。

  • ライブラリから古い番号のバンドルを選んだ:そのトラックで公開中のリリースがすでに versionCode 5 なのに、ライブラリから追加 で versionCode 3 や 4 を選択したケースです。Google Play では既存ユーザーを古いバージョンへダウングレードできません。
  • 新しいバンドルを追加せずに「次へ」を押した:新しいリリースを作成 を開いたあと、App Bundle に何も追加しないまま確認画面へ進んだ場合に発生します。
  • 対応デバイスの条件を狭めてしまった:versionCode は大きくしたものの、minSdkVersion の引き上げ、arm64-v8a の除外、必須 <uses-feature> の追加などによって、以前のリリースを利用中の端末が 1 台もアップグレード対象にならなくなっています。

リリースの作成画面にある 以前のリリース に表示されている現在の versionCode を確認し、それより大きい versionCode の .aab を追加したうえで、下書き内に古い番号のバンドルが混ざっていれば削除してください。

14 日間のクローズド テストでは複数回のアップデートが審査通過のカギになる

もし プレビューして確認する 画面で 16 KB メモリのページサイズ、AD_ID 権限の申告不一致、あるいは難読化解除ファイル・デバッグ シンボルの黄色い警告が出た場合は、Play Console の AAB アップロードエラー一覧:原因と対処法 もあわせて確認してみてください。

個人用デベロッパー アカウントで 14 日間のクローズド テストを行う際、versionCode を上げて新しいリリースを出す作業は単なるエラー回避にとどまりません。初日に上げた versionCode 1 のまま 14 日間放置するよりも、テスターからのフィードバックをもとに versionCode 2、3、4… と 3 回以上の実質的な改善アップデートを配信しておくことで、トラック上に明確な改善履歴が残り、製品版へのアクセスを申請する 際の質問票でも具体的な修正内容を回答できるようになります。これは審査で 「More testing required」(アプリのテストをさらに行う必要があります)と却下されるリスク を減らすうえで非常に効果的です。

もっとも、せっかく versionCode を上げて改善版を出しても、テスターがアプリをアンインストールしていたり 2~3 日目以降まったく開いていなかったりすると、テスト実績としては弱くなってしまいます。個人で 12 人以上に声をかけて 14 日間毎日起動してもらうのは想像以上に大変です。BetaLobby(完全無料・有料プランなし)なら、16 人の開発者が 1 つの共通 Google グループで チームモード に参加し、スクショ提出不要のインストール確認と毎日の チェックイン を通じて、更新を重ねる 14 日間ずっとお互いのアプリを実機で動かし続けられます。