Erfüllt die Anforderungen an das Ziel-API-Level von Google Play

Wenn Sie ein APK hochladen, muss es die Anforderungen an das Ziel-API-Level von Google Play erfüllen.

Ab dem 31. August 2025 gilt Folgendes:

• Neue Apps und App-Updates müssen auf Android 15 (API‑Level 35) oder höher ausgerichtet sein, damit sie bei Google Play eingereicht werden können. Davon ausgenommen sind Apps für Wear OS, Android Automotive OS und Android TV, die auf Android 14 (API‑Level 34) oder höher ausgerichtet sein müssen.
• Vorhandene Apps müssen auf Android 14 (API‑Level 34) oder höher ausgerichtet sein, damit sie weiterhin für Geräte neuer Nutzer verfügbar sind, die eine höhere Version des Android-Betriebssystems haben als das Ziel‑API‑Level Ihrer App. Apps, die auf Android 13 (API‑Level 33) oder niedriger ausgerichtet sind, einschließlich Android 12 (API‑Level 31) oder niedriger für Wear OS und Android TV, sind nur auf Geräten mit Android-Versionen verfügbar, die mit dem Ziel‑API‑Level Ihrer App übereinstimmen oder niedriger sind.

Wenn Sie mehr Zeit zum Aktualisieren Ihrer App benötigen, können Sie eine Fristverlängerung bis zum 1. November 2025 beantragen. Im Laufe dieses Jahres können Sie in der Play Console auf die Formulare zur Fristverlängerung für Ihre App zugreifen.

Für diese Anforderungen gelten folgende Ausnahmen:

• Dauerhaft interne Apps, die auf Nutzer in einer bestimmten Organisation beschränkt und nur für den internen Vertrieb bestimmt sind.

Warum sollten Sie auf neuere SDKs abzielen?

In jeder neuen Android-Version werden Änderungen eingeführt, die zu Sicherheits- und Leistungsverbesserungen führen und die Nutzerfreundlichkeit von Android insgesamt verbessern. Einige dieser Änderungen gelten nur für Apps, die die Unterstützung über ihr targetSdkVersion-Manifestattribut (auch Ziel-API-Level genannt) explizit deklarieren.

Wenn Sie die App so konfigurieren, dass sie auf ein aktuelles API-Level ausgerichtet ist, können Nutzer von diesen Verbesserungen profitieren und Ihre App kann weiterhin auf älteren Android-Versionen ausgeführt werden. Wenn Sie auf ein aktuelles API-Level ausgerichtet sind, kann Ihre App auch die neuesten Funktionen der Plattform nutzen, um Ihre Nutzer zu begeistern. Außerdem sehen Nutzer ab Android 10 (API‑Level 29) eine Warnung, wenn sie eine App zum ersten Mal starten, die auf Android 5.1 (API‑Level 22) oder niedriger ausgerichtet ist.

In diesem Dokument werden wichtige Punkte hervorgehoben, die Sie bei der Aktualisierung des Ziel-API-Levels beachten müssen, um die Google Play-Anforderungen zu erfüllen. Je nachdem, zu welcher Version Sie migrieren, finden Sie in den folgenden Abschnitten eine Anleitung.

Von Android 12 und höher (API‑Level 31) zu einer neueren Version migrieren

Wenn Sie Ihre App so aktualisieren möchten, dass sie auf eine neuere Android-Version ausgerichtet ist, folgen Sie der Liste der relevanten Verhaltensänderungen:

• Verhaltensänderungen unter Android 13
• Verhaltensänderungen unter Android 14
• Verhaltensänderungen unter Android 15
• Verhaltensänderungen unter Android 16

Von Android 11 (API-Level 30) zu Android 12 (API-Level 31) migrieren

Sicherheit und Berechtigungen

• Bluetooth: Sie müssen Deklarationen für die Berechtigungen BLUETOOTH und BLUETOOTH_ADMIN durch die Berechtigungen BLUETOOTH_SCAN, BLUETOOTH_ADVERTISE oder BLUETOOTH_CONNECT ersetzen. Sie müssen keine LOCATION-Laufzeitberechtigungsanfragen für Bluetooth-Vorgänge mehr stellen.
• Standort: Nutzer können festlegen, dass Apps nur ungefähre Standortinformationen abrufen dürfen. Sie müssen die Berechtigung ACCESS_COARSE_LOCATION jedes Mal anfordern, wenn Sie ACCESS_FINE_LOCATION anfordern.
  • Intent-Filter: Wenn Ihre App Aktivitäten, Dienste oder Übertragungsempfänger enthält, die Intent-Filter verwenden, müssen Sie das Attribut android:exported für diese Komponenten explizit deklarieren.
• Ruhezustand: Apps werden möglicherweise in den Ruhezustand versetzt, wenn sie über einen bestimmten Zeitraum nicht verwendet werden. Im Ruhezustand werden die Laufzeitberechtigungen und der Cache Ihrer App zurückgesetzt. Sie können keine Jobs oder Benachrichtigungen ausführen. Sie können den Ruhezustand Ihrer App prüfen.
• Veränderlichkeit von PendingIntent: Sie müssen die Veränderlichkeit jedes PendingIntent-Objekts angeben, das von Ihrer App erstellt wird.

Nutzerfreundlichkeit

• Benutzerdefinierte Benachrichtigungen: Benachrichtigungen mit benutzerdefinierten Inhaltsansichten verwenden nicht mehr den gesamten Benachrichtigungsbereich. Stattdessen wendet das System eine Standardvorlage an. Diese Vorlage sorgt dafür, dass benutzerdefinierte Benachrichtigungen in allen Status dieselbe Dekoration wie andere Benachrichtigungen haben. Dieses Verhalten ist nahezu identisch mit dem von Notification.DecoratedCustomViewStyle.
• Änderungen bei der Bestätigung von Android-App-Links: Wenn Sie die Bestätigung von Android-App-Links verwenden, müssen Sie darauf achten, dass Ihre Intent-Filter die Kategorie BROWSABLE enthalten und das HTTPS-Schema unterstützen.

Leistung

• Launch-Beschränkungen für Dienste im Vordergrund: Wenn Ihre App auf Android 12 oder höher ausgerichtet ist, kann sie Dienste im Vordergrund nicht starten, während sie im Hintergrund ausgeführt wird. Es gibt jedoch einige Ausnahmen. Wenn eine App versucht, einen Dienst im Vordergrund zu starten, während sie im Hintergrund ausgeführt wird, tritt eine Ausnahme auf (mit Ausnahme der wenigen Sonderfälle).

  Sie können WorkManager verwenden, um beschleunigte Aufgaben zu planen und zu starten, während Ihre App im Hintergrund ausgeführt wird. Um zeitkritische Aktionen auszuführen, die der Nutzer anfordert, starten Sie Dienste im Vordergrund innerhalb eines exakten Alarms.

• Einschränkungen für Benachrichtigungs-Trampolin: Wenn Nutzer auf Benachrichtigungen tippen, reagieren einige Apps, indem sie eine App-Komponente starten, die die Aktivität startet, die der Nutzer sieht und mit der er interagiert. Diese App-Komponente wird als Benachrichtigungs-Trampolin bezeichnet.

  Apps dürfen keine Aktivitäten über Dienste oder Broadcast-Empfänger starten, die als Benachrichtigungs-Trampoline verwendet werden. Nachdem ein Nutzer auf eine Benachrichtigung oder eine Aktionsschaltfläche in der Benachrichtigung getippt hat, kann Ihre App startActivity() nicht in einem Dienst oder Broadcast-Empfänger aufrufen.

Alle Änderungen, die sich auf Apps auswirken, die auf Android 12 (API-Level 31) ausgerichtet sind

Apps modernisieren

Wenn du die Ziel-API-Ebene für deine App aktualisierst, solltest du die neuesten Plattformfunktionen verwenden, um deine App zu modernisieren und so deine Nutzer zu begeistern.

• Mit CameraX, das sich in der Betaphase befindet, können Sie die Kamera optimal nutzen.
• Mit Jetpack-Komponenten können Sie Best Practices einhalten, Boilerplate-Code vermeiden und komplexe Aufgaben vereinfachen, damit Sie sich auf den Code konzentrieren können, der Ihnen wichtig ist.
• Mit Kotlin können Sie schneller bessere Apps mit weniger Code schreiben.
• Achten Sie darauf, dass Sie die Datenschutzanforderungen und Best Practices einhalten.
• Fügen Sie Ihren Apps Unterstützung für das dunkle Design hinzu.
• Fügen Sie Ihren Apps Unterstützung für die Gestensteuerung hinzu.
• Migrieren Sie Ihre App von Google Cloud Messaging (GCM) zur aktuellen Version von Firebase Cloud Messaging.
• Nutze die erweiterte Fensterverwaltung.
  • Unterstützung größerer Seitenverhältnisse (mehr als 16:9), um die Vorteile der neuesten Hardware zu nutzen. Achten Sie darauf, dass die Größe Ihrer App so angepasst wird, dass sie den verfügbaren Bildschirmplatz ausfüllt. Geben Sie ein maximales Seitenverhältnis nur als letzten Ausweg an. Weitere Informationen zu maximalen Seitenverhältnissen finden Sie unter Eingeschränkte Bildschirmunterstützung deklarieren.
  • Fügen Sie Unterstützung für mehrere Fenster hinzu, um die Produktivität Ihrer App zu steigern und mehrere Displays zu verwalten.
  • Wenn eine gute minimierte App die Nutzerfreundlichkeit verbessern würde, fügen Sie Unterstützung für Bild im Bild hinzu.
    • Optimiere deine App für Geräte mit Display-Ausschnitt.
    • Gehen Sie nicht von einer bestimmten Höhe der Statusleiste aus. Verwenden Sie stattdessen WindowInsets und View.OnApplyWindowInsetsListener. Weitere Informationen finden Sie im Video von der droidcon NYC 2017.
    • Gehen Sie nicht davon aus, dass die App das gesamte Fenster einnimmt. Bestätigen Sie stattdessen den Standort mit View.getLocationInWindow() und nicht mit View.getLocationOnScreen(). * Bei der Verarbeitung von MotionEvent verwenden Sie MotionEvent.getX() und MotionEvent.getY(), nicht MotionEvent.getRawX() und MotionEvent.getRawY().

SDKs und Bibliotheken überprüfen und aktualisieren

Prüfen Sie, ob Ihre Drittanbieter-SDK-Abhängigkeiten API 31 unterstützen. Einige SDK-Anbieter geben dies in ihrem Manifest an, bei anderen ist eine zusätzliche Prüfung erforderlich. Wenn Sie ein SDK verwenden, das API 31 nicht unterstützt, sollten Sie das Problem in Zusammenarbeit mit dem SDK-Anbieter so schnell wie möglich beheben.

Beachten Sie außerdem, dass die targetSdkVersion Ihrer App oder Ihres Spiels den Zugriff auf private Android-Plattformbibliotheken einschränken kann. Weitere Informationen finden Sie unter NDK Apps Linking to Platform Libraries.

Prüfen Sie auch, ob es Einschränkungen in der Version der Android-Supportbibliothek gibt, die Sie verwenden. Wie immer müssen Sie für Kompatibilität zwischen der Hauptversion der Android Support Library und dem compileSdkVersion Ihrer App sorgen.

Wir empfehlen, eine targetSdkVersion auszuwählen, die kleiner oder gleich der Hauptversion der Support Library ist. Außerdem solltest du ein Update auf eine aktuelle kompatible Supportbibliothek durchführen, um von den neuesten Kompatibilitätsfunktionen und Fehlerkorrekturen zu profitieren.

App testen

Nachdem Sie das API-Level und die Funktionen Ihrer App entsprechend aktualisiert haben, sollten Sie einige wichtige Anwendungsfälle testen. Die folgenden Vorschläge sind nicht vollständig, sollen Ihnen aber als Orientierung für Ihre Tests dienen. Wir schlagen folgende Tests vor:

• Ihre App wird ohne Fehler oder Warnungen für API 29 kompiliert.

• Ihre App muss eine Strategie für Fälle haben, in denen der Nutzer Berechtigungsanfragen ablehnt, und den Nutzer zur Erteilung von Berechtigungen auffordern. Gehen Sie dazu folgendermaßen vor:

  • Rufe den Bildschirm "App-Info" deiner App auf und deaktiviere alle Berechtigungen.
  • Öffne die App und überzeuge dich davon, dass keine Abstürze auftreten.
    • Führen Sie Tests für die wichtigsten Anwendungsfälle durch und sorgen Sie dafür, dass die erforderlichen Berechtigungen noch einmal angefordert werden.

• Teste, ob deine App den Stromsparmodus mit den erwarteten Ergebnissen und ohne Fehler verarbeitet.

  • Versetzen Sie Ihr Testgerät mit adb in den Doze-Modus, während Ihre App ausgeführt wird.
    • Teste alle Anwendungsfälle, durch die Firebase Cloud Messaging-Nachrichten ausgelöst werden.
    • Teste alle Anwendungsfälle, bei denen Alarme oder Jobs verwendet werden.
    • Beseitige Abhängigkeiten von Hintergrunddiensten.
  • App in den App-Standby versetzen
    • Teste alle Anwendungsfälle, durch die Firebase Cloud Messaging-Nachrichten ausgelöst werden.
    • Teste alle Anwendungsfälle, bei denen Alarme verwendet werden.

• Teste, ob deine App neue Fotos bzw. Videos verarbeitet, die aufgenommen werden.

  • Prüfen Sie, ob Ihre App die Broadcasts ACTION_NEW_PICTURE und ACTION_NEW_VIDEO mit Einschränkungen korrekt verarbeitet (d. h. zu JobScheduler-Jobs verschoben).
  • Prüfen Sie, ob alle wichtigen Anwendungsfälle, die von diesen Ereignissen abhängen, weiterhin funktionieren.

• Dateien für andere Apps freigeben – Testen Sie alle Anwendungsfälle, in denen Dateidaten für eine andere App freigegeben werden (auch für eine andere App desselben Entwicklers).

  • Prüfen Sie, ob die Inhalte in der anderen App sichtbar sind und keine Abstürze verursachen.

Weitere Informationen

Abonnieren Sie E-Mails in der Google Play Console, damit wir Ihnen wichtige Updates und Ankündigungen zu Android und Google Play senden können, einschließlich unseres monatlichen Partner-Newsletters.