KappSナレッジベース · FAQ

Google Playにおけるバージョンコード管理とアップデート互換性

FAQ アプリ審査・公開

1. 2つのフィールド、まったく異なる2つの役割。Googleのバージョン管理ガイドでは、両者は別々に定義されています。versionCodeは「内部バージョン番号として使用される正の整数。この数値は、あるバージョンが別のバージョンより新しいかどうかの判断に役立ち、数値が大きいほど新しいバージョンであることを示します。これはユーザーに表示されるバージョン番号ではなく、その番号はversionName設定で指定します。AndroidシステムはversionCodeの値を使用して、デバイスに現在インストールされているバージョンより低いversionCodeのAPKをインストールできないようにすることで、ダウングレードを防ぎます。」versionNameは「ユーザーに表示されるバージョン番号として使用される文字列…versionNameはユーザーに表示される唯一の値です。」Play Consoleのヘルプには、開発者が最初につまずく運用上の詳細が補足されています。versionCodeは「新しいリリースごとに一貫して増加する32ビット整数」であり、versionNameは「ユーザー向けのバージョン番号を表す文字列で、例えば『1.0.0』『1.1 Beta』『2.0』など」です。マーケティング側は4.9を5.0に自由に改名できますが、整数が増加しなければその瞬間にアップロードは失敗します。(§https://developer.android.com/studio/publish/versioning / §https://support.google.com/googleplay/android-developer/answer/17367361)

2. Playのアップロード審査は1つの比較であり、厳密な「より大きい」です。公式の更新要件には3つの厳格な条件がこの順で示されています。「更新されたAndroid App Bundleのパッケージ名は現在のバージョンと同じでなければならない。バージョンコードは現在のバージョンより大きくなければならない……更新されたアプリバンドルは現在のバージョンと同じ署名で署名されていなければならない」。バイナリが異なれば「同一でも可」という経路はなく、審査で主張できる余地もありません。このチェックは機械的に行われ、人やポリシーボットがリリースを目にする前に実行されます。(§https://support.google.com/googleplay/android-developer/answer/9859350)

3. versionCodeは再利用できず、その番号のプールはトラックではなくアプリに属します。バージョン管理ガイドの表現は明快です。「過去のバージョンで使用したversionCodeを持つAPKをPlayストアにアップロードすることはできません」。コンソール上では、おなじみの「バージョンコードXはすでに使用されています」というリジェクトとして現れます。カウンターはアプリケーション(パッケージ名)に紐づくため、内部テスト、クローズドテスト、オープンテスト、製品版のすべてが同じ連番から採番します。同じビルドを別のトラックに載せるには、再アップロードではなく「ライブラリから」追加します。別のパッケージ名(ステージングアプリや、独自のapplicationIdを持つホワイトラベルのフレーバー)には独自の連番があり、デバッグ中に番号を消費する場所としてステージングアプリが適しているのはまさにこの理由です。(§https://developer.android.com/studio/publish/versioning)

4. 上限は2,100,000,000であり、到達することはサポートチケットではなく終着点です。両方のドキュメントが同じ数字を示しています。「Google PlayがversionCodeに許容する最大値は2100000000です」。コンソールのページはその結果を明記しています。「アプリのversionCodeが上限に達するか超えると、そのアプリケーションについてGoogle Playへ新しいAPKやAABをアップロードできなくなります。つまり、ユーザー向けのバグ修正、新機能、互換性アップデートは一切行えなくなります」。Googleが示す唯一の対処法は「Google Playがサポートを提供できる場合があります」というもので、リセットボタンではなく「可能性」にすぎません。稼働中のアプリで収益を上げる事業にとって、この数字は寿命のある資産であり、それに見合う使い方をする必要があります。(§https://support.google.com/googleplay/android-developer/answer/17367361)

5. 番号付けの習慣のうち3つは、開発者が想定するよりずっと早く範囲を消費します。秒単位のUnixタイムスタンプはすでに17.9億を超え、ビルドのたびに増え続けます。ブランチ、フレーバー、兄弟アプリで共有されるグローバルなCI実行カウンターは、失敗したパイプラインでもどんどん進みます。そして「ビルド番号=コミット数」は、モノレポの履歴が書き換えられた瞬間に破綻します。Play自身が挙げる緩和策は次のとおりです。「持続可能なバージョンコード戦略を採用する:利用可能な範囲を急速に消費することを避け、段階的かつ一貫した増加を保証するバージョンコード生成戦略を実装します。バージョンコードの使用状況を監視する:アプリのバージョンコードの進捗を定期的に追跡し、上限に近づく時期を予測します。自動チェックを実装する:ビルドおよびリリースプロセスにチェックを組み込み、過度に高いバージョンコード値の使用を警告または防止します。」(§https://support.google.com/googleplay/android-developer/answer/17367361)

6. コードは公開時ではなくアップロード時に消費されます。内部テストへのアップロード、ライブラリへのバンドルの保管、あるいは後で破棄されるドラフトリリースの作成も、すべて番号を消費します。「ライブラリから追加」が存在するのは、同じバイナリを後続のリリースに再添付することはできても、再作成はできないからです。「通るかどうか確認するためにビルドをコンソールにプッシュする」人は、試行のたびにバージョン番号を1つ消費します。パイプラインの速い長寿アプリでは、こうして余裕のある間隔が数年後に危機へと変わります。

7. 停止はロールバックではありません。Androidはダウングレードを拒否するからです。ポイント1で引用したシステムレベルのルール(端末はすでにインストールされているversionCodeより低いバージョンをインストールしない)により、ユーザーを先週のビルドに戻すコンソールボタンは存在しません。Googleの段階的リリースのガイダンスも運用面で同じことを述べています。「既存のアプリバンドルに問題が見つかった場合は、修正したアプリバンドルで新しいリリースを作成してロールアウトしてください」。したがって、不良な製品版ビルドからの真の復旧は、不良ビルドより高いversionCodeを持つ新しいバンドルを、審査が許す限り迅速にリリースすることだけです。だからこそ、番号付けの仕組みに緊急用の枠を、必要になる前に用意しておくべきなのです。(§https://support.google.com/googleplay/android-developer/answer/6346149)

8. 段階的リリースはアップデート専用の機能であり、自動で進むことはありません。「段階的リリースを使えば、アプリのアップデートを製品版トラックとテストトラックにリリースできます。段階的リリースでは、アップデートは一部のユーザーにのみ配信され、その割合は時間の経過とともに増やせます。段階的リリースはアプリのアップデートにのみ使用でき、アプリの初回公開時には使えません。」そしてリリースが1週間5%のまま止まってしまう罠:「アプリの段階的リリースの割合は自動的には増えません。」リリースの責任者が戻って割合を引き上げる必要があり、Google側でやってくれることは何もありません。また、ユーザーは段階的アップデートを受け取ったことを通知されません——「段階的リリースでアプリのバージョンを受け取っても、ユーザーに通知されることはありません」——そのため、段階的リリースに対するフィードバックはレビューではなく、バイタルとサポートから引き出す必要があります。(§https://support.google.com/googleplay/android-developer/answer/6346149)

9. 段階的リリースを停止すると実際に何が変わるか。「問題を発見した場合、段階的リリースを停止することで、アプリの問題を経験するユーザー数を最小限に抑えられます。段階的リリースを停止すると、既存の段階的リリースでアプリバージョンを受け取る追加のユーザーはいなくなります。すでに段階的リリースでアプリバージョンを受け取ったユーザーは、そのバージョンのままになります。」ここから見落とされがちな2つの帰結が生じます。再開しても対象ユーザーは入れ替わりません。「リリースのロールアウトを停止してから再開すると、影響を受けるのは同じユーザー群です」。そして、前回のリリースが完了する前に新しいリリースを開始すると、同じコホートが再利用されます。「前回のリリースのロールアウトを完了する前に新しいリリースを段階的にロールアウトすると、新しいリリースは前回のリリースと同じユーザー群を使用します(ロールアウトの割合に応じて)。」修正内容を検証するのは、新たなサンプルではなく、同じ不運な5%なのです。(§https://support.google.com/googleplay/android-developer/answer/6346149)

10. 完全に展開済みのリリースを停止すると何が起き、何が起きないか。「アプリに重大な問題を発見した場合、ロールアウト停止機能は、新規ユーザーと既存ユーザーの両方が問題のあるバージョンのアプリをインストールまたはアップデートすることを防ぎ、ユーザーへの影響を最小限に抑えます。完全リリースを停止すると、アプリの以前のバージョンが新規ユーザーに提供され、停止されたバージョンを使用していないユーザーにも提供されます。」これは配信の変更であり、アンインストールではありません。「停止されたバージョンはユーザーに配信されなくなります」が、すでに受け取った端末はダウングレード保護によりそのバージョンを保持し続けます。同じページには3つの制約が明記されています。「内部テストトラックを除くすべてのトラックで」機能すること、「トラックの初回リリースは停止できない」こと、「以前のリリースにポリシー違反がある場合、停止したリリースの代替として使用できない」ことです。後から再開する際は任意の割合を指定でき、これが修正済みビルドを段階的に再導入する正しい方法です。(§https://support.google.com/googleplay/android-developer/answer/16285429)

11. 各トラックにつき未完了のリリースは1つまで — そしてこれが最悪のタイミングでホットフィックスを妨げる原因です。「未完了のリリースがある場合、新しいリリースを作成できません。段階的リリースを100%まで展開するか、公開の概要ページで変更を削除し、未公開のリリースを破棄してください。」放置された20%の段階的リリース、中途半端な審査申請、製品版トラックに残ったままのマネージドパブリッシングの保留は、緊急ビルドとあなたの間に立ちはだかります。これを防ぐ習慣は、すべてのリリース後にループを閉じることです — 100%まで展開するか、削除して破棄する。そしてその状態をリリースログに記録し、次の担当者(あるいは未来のあなた)が新しいリリースを開くことを拒否するコンソールをデバッグしなくて済むようにしましょう。(§https://support.google.com/googleplay/android-developer/answer/9859348)

12. 10年にわたるリリースに耐える採番スキーム。固定幅の帯を確保して、計算が読みやすく、上限がはるか遠くに保たれるようにします: versionCode = major * 100000 + minor * 1000 + patch * 10 + hotfix。これによりメジャーは1〜20999、マイナーは1000、パッチ/ホットフィックスはそれぞれ10枠が可能になります。ビルドスクリプトで実用範囲が21億を明確に下回るように保ち、計算値が設定したソフトしきい値(たとえば15億)を超えたら、アップロードではなくビルドを失敗させます。CIにインクリメントの権限を与えるのはアップロード時のみとし、コミットごとには決して行いません。試験的なビルドはすべてステージングのapplicationIdで実行し、そのコードが別のシーケンスで消費されるようにします。そして出荷したversionCodeをリリースノートに記録し、番号が属人的な知識ではなく監査可能なものになるようにします。

13. 上記すべてを一度に洗い出せるアップロード前チェックリスト:(a)versionCodeが、対象トラックだけでなく全トラックを通じてこのアプリにこれまでアップロードされたどのコードよりも厳密に大きいこと。(b)versionNameは表示用テキストにすぎず、重複や飛び番も自由。(c)パッケージ名が変わっておらず、バンドルが本番の署名キーで署名されていること。アプリ署名キーの変更は「すでにアプリをインストールしている内部テストおよびクローズドトラックのユーザーは更新を受け取れなくなります。これらのユーザーは更新を受け取るためにアプリをアンインストールして再インストールする必要があります」を意味します。(d)アップグレード経路は、前バージョンがすでにインストールされた端末でテストすること。クリーンインストールでは更新について何も証明できません。(e)番号が2,100,000,000の上限と自社のソフトしきい値に対して確認されていること。(f)対象トラックに未処理のリリースが他に残っていないこと。(g)現在の帯に緊急用のコード枠がまだ空いていること。これらはすべて判断ではなくフィールドか状態であり、だからこそリスト全体を誰かの記憶ではなくCIとリリースチェックリストに置けるのです。(§https://support.google.com/googleplay/android-developer/answer/9859348)