Google Play: Target API Level aktualisieren – Ablauf und Stolperfallen

Die Regel in Kürze

Das Target API Level – im Gradle-Build die targetSdk – legt fest, für welches Android-Verhalten Ihre App ausgelegt ist. Google nutzt es, um den Store aktuell zu halten:

• Neue Apps und Updates müssen ein API-Level ansteuern, das höchstens ein Jahr hinter dem neuesten großen Android-Release liegt. Andernfalls blockiert die Play Console den Upload.
• Bestehende Apps ohne Update müssen innerhalb von zwei Jahren liegen. Sonst bleiben sie zwar bei bisherigen Nutzern installiert, werden aber neuen Nutzern mit aktuellen Android-Versionen nicht mehr angeboten.

Google kündigt die jeweils neue Anforderung vorab an und setzt sie üblicherweise in der zweiten Jahreshälfte durch. Eine befristete Verlängerung lässt sich in vielen Fällen in der Play Console beantragen. Für Wear OS, Android TV und Android Automotive gelten eigene Vorgaben.

Warum Apps beim Update brechen

Mit einer höheren targetSdk übernimmt die App die Verhaltensänderungen der jeweiligen Android-Version. Wer mehrere Jahre übersprungen hat, bekommt alle auf einmal. Typische Beispiele:

• Android 12 (API 31): Komponenten mit Intent-Filtern brauchen eine explizite android:exported-Angabe, PendingIntents ein Mutability-Flag.
• Android 13 (API 33): Die App fragt die Benachrichtigungsberechtigung selbst ab; feinere Medienberechtigungen ersetzen den pauschalen Speicherzugriff.
• Android 14 (API 34): Foreground Services müssen ihren Typ deklarieren, zur Laufzeit registrierte Broadcast Receiver ihre Exportierung angeben.
• Android 15 (API 35): Edge-to-Edge ist Pflicht – Inhalte können unter Status- und Navigationsleiste rutschen.
• Android 16 (API 36): Auf großen Bildschirmen werden Einschränkungen für Ausrichtung und Größenänderung ignoriert.

Unabhängig davon verlangt Google Play für Apps mit nativen Bibliotheken, die aktuelle Android-Versionen ansteuern, die Unterstützung von 16-KB-Speicherseiten. Auch alte Versionen der Play Billing Library werden schrittweise abgekündigt. Beides kann ein Update blockieren – prüfen Sie es im selben Durchgang.

Update-Ablauf in sieben Schritten

1. Hinweise und Fristen im Posteingang bzw. in der Richtlinienübersicht der Play Console prüfen.
2. Toolchain aktualisieren: Android Gradle Plugin, Gradle, Kotlin, SDK – dann compileSdk und targetSdk anheben.
3. Bei Flutter, React Native, Capacitor oder Cordova zuerst das Framework aktualisieren; ältere Versionen unterstützen neue Zielversionen oft nicht.
4. Abhängigkeiten wie Firebase, Google Play Services, Push- und Analyse-SDKs aktualisieren.
5. Die offiziellen Listen der Verhaltensänderungen für jede übersprungene Version durchgehen.
6. Auf dem neuesten Emulator-Image und auf der ältesten unterstützten Version testen – besonders Push, Datei-Uploads, Hintergrundprozesse, Deep Links und Layout.
7. Über den internen Testtrack veröffentlichen, Pre-Launch-Bericht und Android Vitals prüfen, dann gestaffelt ausrollen.

Ältere Apps im Store halten

Viele Apps verlieren den Anschluss nicht wegen technischer Komplexität, sondern weil niemand mehr zuständig ist: Die Agentur existiert nicht mehr, die Build-Umgebung ist veraltet, der Upload-Schlüssel nicht auffindbar. Gerade bei Apps von Kommunen, Stadtwerken oder mittelständischen Unternehmen lohnt es sich, das jährliche Update fest einzuplanen – mit Budget, Verantwortlichen und, bei Ausschreibungen, als ausdrücklicher Bestandteil des Wartungsvertrags. Lohnt sich eine App nicht mehr, ist ein bewusstes Depublizieren besser als ein schleichender Verfall.

Ein Sonderfall ist der verlorene Schlüssel: Nutzt die App die Play App-Signatur, kann der Upload-Schlüssel über die Play Console zurückgesetzt werden. Ohne Play App-Signatur und ohne Originalschlüssel lässt sich die App dagegen nicht mehr aktualisieren – dann bleibt nur eine Neuveröffentlichung unter neuem Paketnamen.

So unterstützt jocapps

appsubmitter.io hebt das Target API Level an, richtet CI/CD und Signierung ein und reicht das Update in Ihrer eigenen Play Console ein – mit KI-gestützten Prüfungen und App-Spezialisten, die Richtlinienwarnungen und Ablehnungen bearbeiten. Für Apps, die dauerhaft gepflegt werden müssen, verbindet apprat.io KI-gestützte Entwicklung mit einem monatlichen Budget an Entwicklerstunden, sodass das jährliche Update zur Routine wird. Weitere Hilfe finden Sie unter App-Store-Veröffentlichung oder im kostenlosen 30-minütigen Erstgespräch über den Terminplaner.