Versionscode-Verwaltung und Update-Kompatibilität auf Google Play
1. Zwei Felder, zwei völlig unterschiedliche Aufgaben. Der Versionierungsleitfaden von Google definiert sie getrennt: versionCode ist „eine positive Ganzzahl, die als interne Versionsnummer dient. Diese Nummer hilft festzustellen, ob eine Version neuer ist als eine andere, wobei höhere Nummern neuere Versionen anzeigen. Dies ist nicht die Versionsnummer, die Nutzern angezeigt wird; diese Nummer wird über die Einstellung versionName festgelegt. Das Android-System verwendet den versionCode-Wert, um vor Downgrades zu schützen, indem es verhindert, dass Nutzer eine APK mit einem niedrigeren versionCode installieren als die derzeit auf ihrem Gerät installierte Version." versionName ist „eine Zeichenkette, die als den Nutzern angezeigte Versionsnummer dient … Der versionName ist der einzige Wert, der Nutzern angezeigt wird." Die Play-Console-Hilfe ergänzt das Bedienungsdetail, über das Entwickler zuerst stolpern: versionCode ist „eine 32-Bit-Ganzzahl, die mit jedem neuen Release stetig ansteigt", während versionName „eine Zeichenkette ist, die die nutzerseitige Versionsnummer darstellt, zum Beispiel ‚1.0.0', ‚1.1 Beta', ‚2.0'." Das Marketing kann 4.9 bedenkenlos in 5.0 umbenennen; in dem Moment, in dem die Ganzzahl nicht ansteigt, scheitert der Upload. (§https://developer.android.com/studio/publish/versioning / §https://support.google.com/googleplay/android-developer/answer/17367361)
2. Das Upload-Gate von Play ist ein einziger Vergleich, und zwar strikt größer als. Die offiziellen Update-Anforderungen nennen drei harte Bedingungen in dieser Reihenfolge: „Der Paketname des aktualisierten Android App Bundle muss mit der aktuellen Version übereinstimmen. Der Versionscode muss größer als der der aktuellen Version sein … Das aktualisierte App Bundle muss mit derselben Signatur wie die aktuelle Version signiert sein." Es gibt keinen Weg „gleich ist in Ordnung, wenn sich das Binary unterscheidet", und es gibt kein Argument für die Prüfung: Die Prüfung ist mechanisch und erfolgt, bevor ein Mensch oder ein Richtlinien-Bot das Release überhaupt sieht. (§https://support.google.com/googleplay/android-developer/answer/9859350)
3. Ein versionCode ist nie wiederverwendbar, und der Pool gehört zur App, nicht zum Track. Der Versionierungsleitfaden ist unmissverständlich: „Sie können kein APK mit einem versionCode im Play Store hochladen, den Sie bereits für eine frühere Version verwendet haben." In der Console zeigt sich das als die bekannte Ablehnung „Version code X has already been used." Da der Zähler an die Anwendung (den Paketnamen) gebunden ist, schöpfen Interner Test, Geschlossener Test, Offener Test und Produktion alle aus derselben Sequenz; um denselben Build auf einen zweiten Track zu bringen, fügen Sie ihn „aus der Bibliothek" hinzu, statt ihn erneut hochzuladen. Ein eigener Paketname – eine Staging-App, eine White-Label-Variante mit eigener applicationId – hat seine eigene Sequenz, weshalb eine Staging-App genau der richtige Ort ist, um beim Debuggen Codes zu verbrauchen. (§https://developer.android.com/studio/publish/versioning)
4. Die Obergrenze liegt bei 2.100.000.000, und sie zu erreichen ist kein Support-Ticket, sondern ein Endzustand. Beide Dokumente nennen dieselbe Zahl: „The greatest value Google Play allows for versionCode is 2100000000." Die Konsolenseite benennt die Konsequenz ausdrücklich: „If your app's versionCode reaches or exceeds the maximum limit, you can no longer be able to upload new APKs or app bundles to Google Play for that application. This means no more bug fixes, new features, or compatibility updates for your users." Als einzige Abhilfe nennt Google, dass „Google Play may be able to provide support" – ein Vielleicht, kein Reset-Knopf. Für ein Geschäft, das von Live-Apps lebt, ist die Zahl daher ein Vermögenswert mit Haltbarkeitsdatum, und sie muss auch so eingesetzt werden. (§https://support.google.com/googleplay/android-developer/answer/17367361)
5. Drei Nummerierungsgewohnheiten verbrauchen den Bereich schneller, als Entwickler erwarten. Unix-Zeitstempel in Sekunden liegen bereits jenseits von 1,79 Milliarden und steigen mit jedem Build; ein globaler CI-Laufzähler, der über Branches, Flavours und Schwester-Apps hinweg geteilt wird, rast bei fehlgeschlagenen Pipelines nach vorn; und „Build-Nummer = Commit-Anzahl" explodiert in dem Moment, in dem die Historie eines Monorepos neu geschrieben wird. Plays eigene Liste der Gegenmaßnahmen lautet: „Adopt a sustainable versionCode strategy: implement a versionCode generation strategy that ensures a gradual and consistent increase, and avoids rapid consumption of the available range. Monitor versionCode usage: regularly track your app's versionCode progression to anticipate when it might approach the limit. Implement automated checks: integrate checks within your build and release processes to warn or prevent the use of excessively high versionCode values." (§https://support.google.com/googleplay/android-developer/answer/17367361)
6. Codes werden durch den Upload verbraucht, nicht durch die Veröffentlichung. Ein Upload in den Internen Test, das Ablegen eines Bundles in der Bibliothek oder das Anlegen eines Entwurfs-Release, das später verworfen wird, verbrauchen die Nummer gleichermaßen – „Aus Bibliothek hinzufügen“ existiert genau deshalb, weil dasselbe Binary einem späteren Release erneut zugeordnet, aber nie neu erstellt werden kann. Wer „einen Build in die Konsole schiebt, um zu sehen, ob er durchgeht“, zahlt pro Versuch eine Versionsnummer; bei einer langlebigen App mit schneller Pipeline wird so aus einem komfortablen Puffer Jahre später eine Krise.
7. Anhalten ist kein Rollback, denn Android lehnt Downgrades ab. Die in Punkt 1 zitierte Systemregel (ein Gerät installiert keinen niedrigeren versionCode als den bereits installierten) ist der Grund, warum es keine Console-Schaltfläche gibt, die Nutzer zum Build der letzten Woche zurückbringt. Die Anleitung zur gestaffelten Veröffentlichung von Google sagt operativ dasselbe: „Wenn Sie ein Problem mit Ihrem vorhandenen App-Bundle feststellen, erstellen Sie ein neues Release mit einem korrigierten App-Bundle und rollen Sie es aus." Die einzige echte Wiederherstellung nach einem fehlerhaften Produktions-Build ist also ein neues Bundle mit einem höheren versionCode als dem fehlerhaften, ausgeliefert so schnell es die Prüfung zulässt – genau deshalb muss der Notfall-Slot in Ihrem Nummerierungsschema existieren, bevor Sie ihn brauchen. (§https://support.google.com/googleplay/android-developer/answer/6346149)
8. Die gestaffelte Veröffentlichung ist ein reines Update-Werkzeug und schreitet nie von selbst voran. „Sie können ein App-Update für Produktions- und Test-Tracks per gestaffelter Veröffentlichung ausrollen. Bei einer gestaffelten Veröffentlichung erreicht Ihr Update nur einen Prozentsatz Ihrer Nutzer, den Sie im Laufe der Zeit erhöhen können. Gestaffelte Veröffentlichungen können nur für App-Updates genutzt werden, nicht bei der erstmaligen Veröffentlichung einer App." Und die Falle, die Releases eine Woche lang bei 5 % festhängen lässt: „Der Prozentsatz Ihrer gestaffelten Veröffentlichung wird nicht automatisch erhöht." Wer das Release verantwortet, muss zurückkommen und den Prozentsatz anheben; nichts auf Seiten von Google erledigt das. Nutzer werden außerdem nicht darüber informiert, dass sie ein gestaffeltes Update erhalten haben – „Nutzer werden nicht benachrichtigt, wenn sie im Rahmen einer gestaffelten Veröffentlichung eine Version Ihrer App erhalten" –, daher muss Feedback zu einem gestaffelten Release aus Vitals und dem Support gezogen werden, nicht aus Bewertungen. (§https://support.google.com/googleplay/android-developer/answer/6346149)
9. Was das Anhalten einer gestaffelten Veröffentlichung tatsächlich ändert. „Wenn Sie ein Problem entdecken, können Sie eine gestaffelte Veröffentlichung anhalten, um die Zahl der Nutzer zu minimieren, die das Problem mit Ihrer App erleben. Wenn Sie eine gestaffelte Veröffentlichung anhalten, erhalten keine weiteren Nutzer die App-Version Ihrer bestehenden gestaffelten Veröffentlichung. Nutzer, die die App-Version Ihrer gestaffelten Veröffentlichung bereits erhalten haben, bleiben auf dieser Version.“ Daraus folgen zwei Konsequenzen, die oft übersehen werden: Das Fortsetzen mischt das Publikum nicht neu – „Wenn Sie das Rollout Ihres Releases anhalten und dann fortsetzen, wirken Sie auf dieselbe Nutzergruppe“ – und ein neuer Release, der vor Abschluss des vorherigen gestartet wird, nutzt dieselbe Kohorte: „Wenn Sie eine gestaffelte Veröffentlichung eines neuen Releases durchführen, bevor das Rollout des vorherigen Releases abgeschlossen ist, verwendet der neue Release dieselbe Nutzergruppe wie der vorherige Release (abhängig vom Prozentsatz des Rollouts).“ Ihr Fix wird von denselben unglücklichen 5 % validiert, nicht von einer frischen Stichprobe. (§https://support.google.com/googleplay/android-developer/answer/6346149)
10. Einen vollständig ausgerollten Release anhalten: Was das bewirkt und was nicht. „Wenn Sie ein kritisches Problem mit Ihrer App entdecken, minimiert die Funktion zum Anhalten des Rollouts die Störung für Nutzer, indem sie neue und bestehende Nutzer daran hindert, die betroffene Version Ihrer App zu installieren oder darauf zu aktualisieren. Wenn Sie einen vollständigen Release anhalten, wird die vorherige Version Ihrer App für neue Nutzer verfügbar, und alle, die nicht die angehaltene Version Ihrer App verwenden, erhalten sie.“ Das ist eine Änderung der Auslieferung, keine Deinstallation: „Die angehaltene Version wird Nutzern nicht mehr ausgeliefert“, aber Geräte, die sie bereits bezogen haben, behalten sie – wiederum wegen des Downgrade-Schutzes. Drei Einschränkungen stehen auf derselben Seite: Es funktioniert „auf jedem Track, mit Ausnahme von internen Test-Tracks“; „Sie können Ihren ersten Release auf einem Track nicht anhalten“; und „Wenn Ihr vorheriger Release einen Richtlinienverstoß aufweist, kann er nicht anstelle Ihres angehaltenen Releases verwendet werden.“ Ein späteres Fortsetzen kann auf jeden beliebigen Prozentsatz gehen – das ist der richtige Weg, einen festen Build schrittweise wieder einzuführen. (§https://support.google.com/googleplay/android-developer/answer/16285429)
11. Ein offenes Release pro Track – und genau das blockiert einen Hotfix im ungünstigsten Moment. „Sie können kein neues Release erstellen, solange offene Releases vorhanden sind. Rollen Sie alle gestaffelten Releases auf 100 % aus oder entfernen Sie Änderungen auf der Seite „Veröffentlichungsübersicht“ und verwerfen Sie alle unveröffentlichten Releases.“ Ein abgebrochener 20-%-Rollout, eine halbfertige Prüfeinreichung oder eine verwaltete Veröffentlichung, die auf dem Produktions-Track liegen bleibt, stehen zwischen Ihnen und dem Notfall-Build. Die Gewohnheit, die das verhindert: Schließen Sie nach jedem Release den Kreis – auf 100 % ausrollen oder entfernen und verwerfen – und notieren Sie den Status im Release-Log, damit die nächste Person (oder Ihr zukünftiges Ich) nicht eine Konsole debuggt, die sich weigert, ein neues Release zu öffnen. (§https://support.google.com/googleplay/android-developer/answer/9859348)
12. Ein Nummerierungsschema, das zehn Jahre Releases übersteht. Reservieren Sie Bänder mit fester Breite, damit die Arithmetik lesbar bleibt und die Obergrenze weit entfernt liegt: versionCode = major * 100000 + minor * 1000 + patch * 10 + hotfix, was Majors von 1 bis 20999, eintausend Minors und je zehn Patch-/Hotfix-Slots erlaubt. Halten Sie den Arbeitsbereich in Ihrem Build-Skript sichtbar unter 2,1 Milliarden und lassen Sie den Build (nicht den Upload) fehlschlagen, wenn der berechnete Wert eine weiche Schwelle überschreitet, die Sie etwa auf 1,5 Milliarden setzen. Geben Sie der CI die Befugnis, nur beim Upload zu inkrementieren, niemals bei jedem Commit; führen Sie jeden explorativen Build unter der Staging-applicationId aus, damit seine Codes in einer anderen Sequenz verbraucht werden; und halten Sie den ausgelieferten versionCode in den Versionshinweisen fest, damit die Nummer nachvollziehbar ist statt nur Stammwissen.
13. Checkliste vor dem Upload, die alle oben genannten Punkte in einem Durchgang abfängt: (a) Der versionCode ist strikt größer als jeder Code, der jemals für diese App hochgeladen wurde – auf jedem Track, nicht nur auf dem, den Sie anvisieren; (b) versionName ist reiner Anzeigetext und darf sich beliebig wiederholen oder springen; (c) Der Paketname ist unverändert und das Bundle ist mit dem aktiven Signaturschlüssel signiert – eine Änderung des App-Signaturschlüssels bedeutet: „Nutzer von internen und geschlossenen Tracks, die Ihre App bereits installiert haben, erhalten keine Updates mehr. Diese Nutzer müssen die App deinstallieren und neu installieren, um Updates zu erhalten"; (d) Der Upgrade-Pfad wird auf einem Gerät getestet, auf dem bereits die vorherige Version installiert ist, denn eine Neuinstallation beweist nichts über ein Update; (e) Die Nummer wird gegen die Obergrenze von 2.100.000.000 und gegen Ihren eigenen weichen Schwellenwert geprüft; (f) Auf dem Ziel-Track ist kein weiteres Release offen; und (g) Im aktuellen Band ist noch ein Notfall-Code-Slot frei. Jeder dieser Punkte ist ein Feld oder ein Zustand, keine Ermessensfrage – deshalb kann die gesamte Liste in der CI und in der Release-Checkliste stehen statt im Gedächtnis einer Person. (§https://support.google.com/googleplay/android-developer/answer/9859348)