Lorixen.
DE

App-Upload abgelehnt: Build-Nummer bereits verwendet

Kurz gesagt: Wenn die Play Console meldet, dass ein Versionscode bereits verwendet wurde, oder App Store Connect einen Build wegen einer bereits vergebenen Build-Nummer ablehnt, ist Ihre App nicht kaputt. Es fehlt nur eine neue, höhere interne Nummer. Laut Android-Dokumentation können Sie kein Paket mit einem versionCode hochladen, den Sie für eine frühere Version schon verwendet haben. Bei Apple identifiziert die Build-Nummer CFBundleVersion jeden einzelnen Build. Die Lösung ist schnell: Nummer erhöhen, neu bauen, neu hochladen. Dauerhaft vermeiden Sie das Problem, indem die Nummer automatisch bei jedem Build steigt und nicht von Hand gepflegt wird.

Zwei Nummern, zwei Aufgaben

Sowohl Android als auch iOS kennen zwei Versionsangaben, die oft verwechselt werden:

  • Die sichtbare Version: Bei Android heisst sie versionName, bei iOS CFBundleShortVersionString. Das ist die Angabe, die Nutzerinnen und Nutzer im Store sehen, etwa „2.3“.
  • Die interne Build-Nummer: Bei Android ist das der versionCode, eine positive ganze Zahl. Bei iOS ist es CFBundleVersion, laut Apple eine Zeichenfolge aus bis zu drei durch Punkte getrennten Zahlen.

Die Stores entscheiden anhand der internen Nummer, ob ein Paket neu ist. Laut Android-Dokumentation verhindert der versionCode zudem, dass Geräte eine ältere Version über eine neuere installieren. Höhere Zahlen bedeuten neuere Versionen.

Warum die Fehlermeldung kommt

Typische Situationen in kleinen Teams und bei Agenturen:

  • Ein Build wurde hochgeladen, dann fiel ein Fehler auf. Der korrigierte Build wird mit derselben Nummer erneut hochgeladen.
  • Ein Upload wurde abgebrochen oder in einem Entwurf verworfen. Die Nummer gilt beim Store trotzdem als vergeben.
  • Zwei Personen bauen parallel, etwa die Agentur und ein interner Entwickler, und beide verwenden dieselbe nächste Nummer.
  • Die Nummer wird im Projekt von Hand gepflegt und nach einem Zusammenführen von Code-Ständen versehentlich zurückgesetzt.
  • Für iOS wurde nur die sichtbare Version erhöht, nicht aber die Build-Nummer.

Schritt 1: Herausfinden, welche Nummer zuletzt verwendet wurde

Schauen Sie in der Play Console unter den Releases und im App-Bundle-Explorer nach, welche Versionscodes bereits hochgeladen wurden, auch in Test-Spuren. In App Store Connect sehen Sie die Builds je Version im Bereich TestFlight.

Notieren Sie die höchste Nummer, die irgendwo auftaucht. Die nächste Nummer muss darüber liegen.

Schritt 2: Nummer erhöhen und neu bauen

Bei Android steht der versionCode in der Build-Konfiguration des App-Moduls. Laut Dokumentation setzen Sie dort versionCode und versionName. Erhöhen Sie den versionCode, zum Beispiel von 41 auf 42, und bauen Sie das Paket neu.

Bei iOS erhöhen Sie in den Projekteinstellungen die Build-Nummer. Die sichtbare Version kann gleich bleiben, wenn es sich nur um einen korrigierten Build derselben Version handelt.

Achtung bei Android: Laut Dokumentation erlaubt Google Play für den versionCode höchstens den Wert 2100000000. Wer Datums- und Uhrzeitangaben als Nummer verwendet, sollte prüfen, ob das Schema innerhalb dieser Grenze bleibt.

Prüfen Sie vor dem erneuten Hochladen kurz, ob das neue Paket wirklich die geänderte Nummer trägt. Bei Android zeigt der App-Bundle-Explorer nach dem Upload den Versionscode an, bei iOS sehen Sie die Build-Nummer in TestFlight. Ein falsch gewähltes Build-Ziel oder eine nicht gespeicherte Projektdatei führt sonst zum gleichen Fehler wie zuvor.

Schritt 3: Die Nummer automatisch vergeben

Dauerhaft lösen Sie das Problem, indem niemand die Nummer von Hand eintippt. Übliche Wege:

  • Zähler im Build-System: Wenn Ihre Agentur Builds automatisch erstellt, kann der Laufzähler der Build-Pipeline als Nummer dienen. Jeder Build bekommt so automatisch eine höhere Zahl.
  • Gemeinsamer Zähler für beide Plattformen: Viele Teams verwenden für Android und iOS dieselbe laufende Nummer. Das erleichtert die Zuordnung von Fehlermeldungen.
  • Klare Zuständigkeit: Nur eine Stelle baut Versionen für die Stores. Parallele Uploads von verschiedenen Rechnern führen fast immer zu Nummernkonflikten.

Laut Android-Dokumentation ist es üblich, mit 1 zu beginnen und den Wert bei jeder Veröffentlichung zu erhöhen, unabhängig davon, ob es eine grosse oder kleine Änderung ist.

Nummern im Team nachvollziehbar halten

Gerade wenn mehrere Personen an einer App arbeiten, lohnt sich eine kleine Ordnung:

  • Ein Versionsprotokoll: Halten Sie in einer einfachen Liste fest, welche Build-Nummer zu welcher sichtbaren Version gehört, wann sie hochgeladen wurde und in welche Spur. Bei Rückfragen von Kunden oder Testern wissen Sie dann sofort, welcher Stand gemeint ist.
  • Nummer im Code-Stand markieren: Markieren Sie den Code-Stand jedes hochgeladenen Builds in Ihrer Versionsverwaltung. So können Sie später genau diesen Stand erneut bauen und prüfen.
  • Fehlermeldungen zuordnen: Absturzberichte und Rückmeldungen aus den Stores nennen in der Regel Version und Build. Mit dem Protokoll finden Sie schnell heraus, ob ein Fehler in einem alten oder im aktuellen Build steckt.
  • Übergabe an neue Dienstleister: Wechseln Sie die Agentur, geben Sie die höchste verwendete Nummer und das Schema der Vergabe ausdrücklich weiter. Sonst beginnt der neue Dienstleister womöglich wieder bei einer zu niedrigen Zahl.

Was Sie nicht tun sollten

  • Den versionCode senken, um eine ältere Fassung erneut einzureichen. Laut Android-Dokumentation dient die Nummer gerade dazu, Rückstufungen zu verhindern.
  • Für einen Notfall-Fix einen neuen App-Eintrag anlegen. Damit verlieren Sie Bewertungen und bestehende Installationen.
  • Die sichtbare Version ändern und hoffen, dass der Store das als neuen Build erkennt. Massgeblich ist die interne Nummer.

Ein Beispiel zur Veranschaulichung

Frei erfunden: Ein Basler Velokurier lässt seine Fahrer-App von einem Freelancer betreuen. Kurz vor einem Update fällt ein Tippfehler im Startbildschirm auf. Der Freelancer korrigiert ihn und lädt das Paket erneut hoch, die Play Console lehnt ab, weil der Versionscode 57 bereits verwendet wurde. Er erhöht auf 58, baut neu, und der Upload klappt. Danach stellt er die Nummernvergabe auf den Laufzähler seines Build-Dienstes um, damit sich das nicht wiederholt.

Häufige Fragen

Muss ich bei jedem Upload auch die sichtbare Version erhöhen?

Nein. Für einen korrigierten Build derselben Version genügt meist eine neue Build-Nummer. Die sichtbare Version erhöhen Sie, wenn sich für Nutzer etwas ändert, das Sie kommunizieren möchten.

Darf ich Nummern überspringen?

Ja. Wichtig ist nur, dass jede neue Nummer höher ist als alle bisher verwendeten. Lücken sind unproblematisch.

Zählen auch Uploads in Test-Spuren?

Ja. Auch ein Build, der nur im internen oder geschlossenen Test war, hat seine Nummer verbraucht.

Kann ich eine verbrauchte Nummer wieder freigeben?

Nein. Eine einmal hochgeladene Nummer bleibt vergeben. Planen Sie deshalb mit einer laufenden, automatisch steigenden Nummer.

Wenn Uploads Ihrer App immer wieder an Versionsnummern scheitern, richten wir mit Ihnen eine verlässliche Nummernvergabe ein: Release-Ablauf besprechen.

Quellen

WhatsAppTermin buchen