「バージョンコードはすでに使用されています」の直し方|FlutterのversionCodeはpubspecの「+」の後ろ

このページには広告が含まれる場合があります。

 

※2026年11月18日に、Android・Google Play・Flutterの公式ドキュメントで確かめた内容です。Play Consoleの画面の名前や、Flutterのファイルの中身は、バージョンや環境によって異なります。

アップデートを作って、Play ConsoleにAAB(App Bundle)を上げた。そうしたら、

「バージョンコードはすでに使用されています」

と出て、先に進めない。

「さっきビルドし直したやん。なんで通らへんねん!?」

アップデートの日に、この1行で足止めされると、地味にこたえます。

先に答えを書くと、原因は、前にGoogle Playへ上げたものと同じ、すでに使ったversionCode(バージョンコード)のAABを上げたことです。

Flutterで作っているなら、直す所は1か所です。

pubspec.yaml の version の行の、+ の後ろの数を、これまで上げた中で一番大きい番号より大きくして、ビルドし直します。

ぼくは自社のアプリを、AndroidとiOSで合わせて12本、Flutterで作って出してきました。アップデートのたびに必ず通る所なので、つまずきやすい所と一緒にまとめておきます。

 

このエラーが言っていること

Androidのアプリには、番号が2つあります。

  • versionName:ユーザーに見える番号(「1.2.0」のような文字列)
  • versionCode:中で使う番号(正の整数)。大きいほど新しい版、という意味を持つ

Android Developersの説明では、versionCodeについて、こう書かれています。

  • 前のバージョンで使ったversionCodeでは、Play ストアにアップロードできない
  • 出すたびに、前より大きい値を使う
  • Google Playで使えるversionCodeの最大は、2100000000

Play Console ヘルプの「アプリを更新または非公開にする」にも、アップデートの準備として「バージョン コードは、現バージョンよりも大きくする必要があります」と書かれています。

つまり、このエラーは「その番号は、もう使った番号です」と言っているだけなんです。アプリの中身が壊れているわけでも、審査で落ちたわけでもありません。

直すのは中身ではなく、番号です。

ここで1つ気をつけたいのは、Android Developersの説明が、本番・内部テストのようなトラックを分けずに「前のバージョンで使ったversionCode」と書いている所です。ですから、内部テストに上げただけの番号も、使った番号として数えておくのが安全です。

参考:Version your app(Android Developers、2026年11月18日確認)/アプリを更新または非公開にする(Play Console ヘルプ、2026年11月18日確認)

 

FlutterのversionCodeは、どこで決まっているか

Flutterでは、versionCodeをAndroidの設定ファイルに直接は書きません。決めているのは、プロジェクトの一番上にある pubspec.yaml です。

version: 1.2.0+15

Flutterの公式ドキュメントでは、こうなっています。

  • + の前(1.2.0)が、Androidの versionName
  • + の後ろ(15)が、Androidの versionCode
  • android/app/build.gradle.kts の versionCode = flutter.versionCode で、この値が自動で入る。Gradleのファイルは、ふつうは触らなくていい
  • ビルドし直すと、pubspec.yaml の番号が local.properties の値にも反映される

だから「バージョンを上げた」つもりで + の前だけを 1.2.0 から 1.2.1 に変えても、+ の後ろが前と同じままなら、このエラーになります。

ユーザーに見える番号を上げても、versionCodeは上がりません。

名前に「バージョン」と付く番号が2つあるので、ここが見落としやすい所なんです。

(pubspec.yaml の番号から、AABを作るまでの流れは、こちらの記事でも書いていますので、よろしければご覧ください)

 

「上げたはずなのに」が起きる、3つのずれ

+ の後ろを上げた覚えがあるのに、このエラーが出る。そんなときは、番号がどこかでずれています。

よくあるのは、次の3つです。

1. 人の手で上げた番号と、Play Consoleの番号がずれている

versionCodeは、人が手で書き換える番号です。だから、記憶と実際がずれます。

  • 別のパソコンや別のブランチで先に番号を上げて、もう上げていた
  • 一緒に作っている人が、先に同じ番号で上げていた
  • 内部テストに上げた分を、数え忘れていた

手元の pubspec.yaml だけを見て「次は16」と決めても、Play Consoleにはもう16が上がっている、ということが起きます。

番号の正解は、手元ではなく、Play Consoleの側にあります。

2. コマンドの --build-number で、番号を上書きしている

Flutterでは、--build-name と --build-number を付けると、pubspec.yaml の番号をその回だけ上書きできます。

flutter build appbundle --build-number=16

前のビルドでこれを使っていた場合、pubspec.yaml には16が残っていません。次に pubspec.yaml の番号でビルドすると、もう使った番号に戻ってしまうことがあります。

付けるなら毎回付ける、付けないなら付けない。どちらかにそろえておくと、ずれません。

3. local.properties に行がなく、番号が「1」になっている

Android Studioのメニュー(Build > Generate Signed Bundle/APK)からAABを作っていて、番号が上がっていないように見えるときは、android/local.properties を開いてみます。

flutter.versionName=1.2.0
flutter.versionCode=15

FlutterのGradleのプラグインのコードを見ると、local.properties に flutter.versionCode の行がないときは、versionCodeが 「1」 になる作りです(versionNameは「1.0」)。最初のバージョンで1を使っていたら、これだけでこのエラーになります。

行がなければ、pubspec.yaml と同じ番号で、この2行を足します。

もっとも、ふだんは flutter build appbundle でビルドし直せば、pubspec.yaml の番号がここにも入ります。行があって、番号も合っているなら、1か2のずれを疑います。

参考:Build and release an Android app(Flutter docs、2026年11月18日確認)/FlutterPlugin.kt(Flutter の GitHub、2026年11月18日確認)

 

直し方:5つの手順

  1. Play Consoleで、これまで上げた番号を確かめる

Play Console ヘルプでは、「テストとリリース」の「最新のリリースと App Bundle」のページで、アプリのバージョンを調べられる、とされています。ここで、これまでに上げた中で一番大きいversionCodeを確かめます(内部テストに上げた分も忘れずに)

  1. pubspec.yaml の + の後ろを、その番号より大きくする

たとえば一番大きいのが16なら、version: 1.2.1+17 のようにします。+ の前(ユーザーに見える番号)は、アップデートの中身に合わせて別に決めます

  1. AABを作り直す
   flutter build appbundle

番号を変えたら、必ずビルドし直します。前に作ったAABのファイルを、そのまま上げ直さないようにします

  1. Android Studioのメニューから作る場合は、local.properties の番号も見る

flutter.versionCode が、2で決めた番号になっているかを確かめます

  1. Play Consoleのリリースに、新しいAABを上げ直す

作り直したAABを、リリースの画面でもう一度アップロードします

上がったら、あとはふだんのアップデートと同じです。審査に出して、結果を待ちます。

(アップデートを審査に出してから公開までの日数は、こちらの記事でも書いていますので、よろしければご覧ください)

 

次から番号でつまずかないために

一度直せば終わり、ではありません。このエラーは、アップデートのたびに、また出る可能性があります。

ぼくの英検®単語のアプリは、2019年夏に出してから、40回を超えるアップデートを重ねてきました。そのたびに、この番号も前より大きくしてきたことになります。

回数が増えるほど、番号を記憶だけで追うのは難しくなります。

(そのアプリは、こちらのサイトで紹介しています)

番号でつまずかないために、決めておくといいのは次の3つです。

  • 番号は、pubspec.yaml の1か所だけで決める:Gradleのファイルに直接書かない。--build-number を使うなら毎回使う
  • 内部テストに上げた分も、使った番号として数える:テストのために上げたAABも、番号を1つ使っています
  • 上げる前に、Play Consoleの一番大きい番号を見る:手元の記憶ではなく、Play Consoleを正解にする

+ の後ろは、ユーザーには見えない番号です。だから、+ の前のバージョンと連動させなくてかまいません。

Android Developersの説明でも、最初を1にして、大きなリリースか小さなリリースかに関係なく、出すたびに増やしていくのがふつう、とされています。

 

iOSのビルド番号も、同じ所で決まっている

Flutterでは、同じ + の後ろが、iOSでは ビルド番号(CFBundleVersion)になります。

Flutterの公式ドキュメントでは、App Store Connectにアップロードするたびに、別のビルド番号が要る、とされています。1つの番号が両方のストアに効くので、両方に出しているなら、AndroidとiOSで一緒に見ておきます。

(iOSのビルド番号と、アップロードまでの流れは、こちらの記事でも書いていますので、よろしければご覧ください)

参考:Build and release an iOS app(Flutter docs、2026年11月18日確認)

 

番号は直したのに、まだ先に進めない方へ

番号を直してAABを上げ直しても、今度は別の所で止まる。リリースの画面で何を押せばいいのか、審査に出したあと何が起きているのかがわからない。そんなときは、Play Consoleの画面を一緒に見るのが早いこともあります。

ぼくは、Google Play Consoleでの申請の作業を、Zoomの画面共有で一緒に進めるお手伝いをしています。審査に出すところから公開の確認まで、リジェクトされたときは原因を一緒に読み解いて、出し直すところまでです。会社の経費でお申し込みいただく場合は、見積書と請求書をご用意します。

よろしければ、お気軽にご相談ください。

 

まとめ

参考:Version your app(Android Developers、2026年11月18日確認)/アプリを更新または非公開にする・[[最新のリリースとバンドル] ページでアプリのバージョンを調べる](https://support.google.com/googleplay/android-developer/answer/9006925?hl=ja)(Play Console ヘルプ、2026年11月18日確認)/Build and release an Android app・Build and release an iOS app(Flutter docs、2026年11月18日確認)

何かのお役に立てれば幸いです。

  • 「バージョンコードはすでに使用されています」は、前に上げたものと同じ、すでに使ったversionCodeのAABを上げたときに出る。アプリの中身の問題ではない
  • versionCodeは、出すたびに前より大きい正の整数にする。Google Playの最大は2100000000
  • versionCodeを決めているのは pubspec.yaml の version: 1.2.0+15 の「15」の所。+ の前だけを上げても、このエラーは消えない
  • 上げたはずなのに出るときは、①人の手や別の場所の作業で番号がずれた ②--build-number の上書き ③local.properties に行がなく「1」になっている、のどれかを疑う
  • 直し方は、Play Consoleで一番大きい番号を確かめ、+ の後ろをそれより大きくして、AABを作り直して上げ直す
  • 内部テストに上げた番号も、使った番号として数える
  • 番号は pubspec.yaml の1か所で決め、正解はPlay Consoleの側に置く
  • iOSでは、同じ + の後ろがビルド番号。アップロードのたびに別の番号が要る

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

TOP