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

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

Ab dem 31. August 2026 gilt Folgendes:

• Neue Apps und App-Updates müssen auf Android 16 (API-Level 36) oder höher ausgerichtet sein, damit sie bei Google Play eingereicht werden können. Davon ausgenommen sind Apps für Wear OS und Android Automotive OS, die auf Android 15 (API-Level 35) oder höher ausgerichtet sein müssen, sowie Apps für Android TV und Android XR, die auf Android 14 (API-Level 34) oder höher ausgerichtet sein müssen.
• Bestehende Apps müssen auf Android 15 (API-Level 35) oder höher ausgerichtet sein, damit sie weiterhin für Geräte neuer Nutzerinnen und Nutzer verfügbar sind, die eine höhere Version des Android-Betriebssystems haben als das Ziel-API-Level Ihrer App. Apps, die auf Android 14 (API‑Level 34) oder niedriger ausgerichtet sind, einschließlich Android 13 (API‑Level 33) oder niedriger für Wear OS, Android TV und Android XR sowie Android 12 (API‑Level 31) oder niedriger für Android Automotive OS, sind nur auf Geräten mit Android-Betriebssystem 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 2026 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 neuere SDKs verwenden?

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 explizit über das Manifestattribut targetSdkVersion (auch als Ziel-API-Level bezeichnet) deklarieren.

Wenn Sie Ihre App so konfigurieren, dass sie auf ein aktuelles API-Level ausgerichtet ist, können Nutzer von diesen Verbesserungen profitieren, während Ihre App weiterhin auf älteren Android-Versionen ausgeführt werden kann. Wenn du ein aktuelles API-Level verwendest, kann deine App auch die neuesten Funktionen der Plattform nutzen, um deine Nutzer zu begeistern. Außerdem wird Nutzern ab Android 10 (API-Level 29) eine Warnung angezeigt, 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 erläutert, die Sie beachten müssen, wenn Sie Ihr Ziel-API-Level aktualisieren, um die Google Play-Anforderung zu erfüllen. Folgen Sie der Anleitung in den folgenden Abschnitten, je nachdem, zu welcher Version Sie migrieren.

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

Wenn du deine App so aktualisieren möchtest, dass sie auf eine neuere Android-Version ausgerichtet ist, folge der entsprechenden Liste mit Verhaltensänderungen:

• Verhaltensänderungen in Android 13
• Verhaltensänderungen unter Android 14
• Verhaltensänderungen in Android 15
• Verhaltensänderungen in 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 mehr für Bluetooth-Vorgänge stellen.
• Standort: Nutzer können festlegen, dass Apps nur ungefähre Standortdaten abrufen dürfen. Sie müssen die Berechtigung ACCESS_COARSE_LOCATION immer anfordern, wenn Sie ACCESS_FINE_LOCATION anfordern.
  • Intent-Filter: Wenn deine App Aktivitäten, Dienste oder Übertragungsempfänger enthält, die Intent-Filter verwenden, musst du das Attribut android:exported für diese Komponenten explizit deklarieren.
• Ruhezustand: Apps können in den Ruhezustand versetzt werden, wenn sie über einen bestimmten Zeitraum nicht verwendet werden. Im Ruhezustand werden die Laufzeitberechtigungen und der Cache Ihrer App zurückgesetzt und Sie können keine Jobs oder Benachrichtigungen ausführen. Sie können den Ruhezustand Ihrer App prüfen.
• Veränderlichkeit von Pending Intents: Sie müssen die Veränderlichkeit jedes PendingIntent-Objekts angeben, das Ihre App erstellt.

Nutzererfahrung

• Benutzerdefinierte Benachrichtigungen: Benachrichtigungen mit benutzerdefinierten Inhaltsansichten verwenden nicht mehr den gesamten Benachrichtigungsbereich. Stattdessen wird eine Standardvorlage angewendet. Diese Vorlage sorgt dafür, dass benutzerdefinierte Benachrichtigungen in allen Status dieselbe Dekoration wie andere Benachrichtigungen haben. Dieses Verhalten ist fast identisch mit dem Verhalten von Notification.DecoratedCustomViewStyle.
• Änderungen bei der Überprüfung von Android-App-Links: Wenn Sie die Überprüfung von Android-App-Links verwenden, müssen 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 keine Dienste im Vordergrund 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 (außer in einigen Sonderfällen).

  Sie können WorkManager verwenden, um Express-Jobs zu planen und zu starten, während Ihre App im Hintergrund ausgeführt wird. Wenn Sie zeitkritische Aktionen ausführen möchten, die vom Nutzer angefordert werden, starten Sie Dienste im Vordergrund innerhalb eines exakten Alarms.

• Einschränkungen für Benachrichtigungs-Trampoline: 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 von Diensten oder Übertragungsempfängern starten, die als Benachrichtigungs-Trampoline verwendet werden. Nachdem ein Nutzer auf eine Benachrichtigung oder einen Aktionsbutton in der Benachrichtigung getippt hat, kann Ihre App startActivity() nicht innerhalb eines Dienstes oder Übertragungsempfängers aufrufen.

Hier finden Sie eine vollständige Liste der Änderungen, die sich auf Apps auswirken, die auf Android 12 (API-Level 31) ausgerichtet sind.

Anwendungen 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.

• Wir empfehlen, CameraX (Betaversion) zu verwenden, um die Kamera optimal zu 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 bessere Apps schneller und mit weniger Code schreiben.
• Beachten Sie die Datenschutzanforderungen und Best Practices.
• Fügen Sie Ihren Apps Unterstützung für das dunkle Design hinzu.
• Fügen Sie Ihren Apps Unterstützung für die Bedienung über Gesten hinzu.
• Migrieren Sie Ihre App von Google Cloud Messaging (GCM) zur neuesten Version von Firebase Cloud Messaging.
• Nutze die erweiterte Fensterverwaltung.
  • Unterstütze größere Seitenverhältnisse (mehr als 16:9), um die Vorteile der neuesten Hardwareentwicklungen zu nutzen. Achte darauf, dass die Größe deiner App so angepasst wird, dass der verfügbare Bildschirmbereich ausgefüllt wird. Gib ein maximales Seitenverhältnis nur als letzte Möglichkeit an. Weitere Informationen zu maximalen Seitenverhältnissen finden Sie unter Unterstützung für eingeschränkte Bildschirme deklarieren.
  • Füge Mehrfenstermodus hinzu, um die Produktivität deiner App zu steigern und mehrere Displays zu verwalten.
  • Wenn eine gute minimierte App-Darstellung 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 findest du im Video droidcon NYC 2017.
    • Gehen Sie nicht davon aus, dass die App das gesamte Fenster einnimmt. Bestätigen Sie stattdessen den Speicherort mit View.getLocationInWindow(), nicht mit View.getLocationOnScreen(). * Verwenden Sie bei der Verarbeitung von MotionEvent MotionEvent.getX() und MotionEvent.getY(), nicht MotionEvent.getRawX(), MotionEvent.getRawY().

SDKs und Bibliotheken überprüfen und aktualisieren

Achte darauf, dass deine 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 sich vorrangig an den SDK-Anbieter wenden, um das Problem zu beheben.

Beachte außerdem, dass die targetSdkVersion deiner App oder deines Spiels den Zugriff auf private Android-Plattformbibliotheken einschränken kann. Weitere Informationen findest du unter NDK-Apps, die mit Plattformbibliotheken verknüpft sind.

Sie sollten auch alle Einschränkungen prüfen, die in der von Ihnen verwendeten Version der Android Support Library gelten. Wie immer müssen Sie die Kompatibilität zwischen der Hauptversion der Android Support Library und der compileSdkVersion Ihrer App sicherstellen.

Wir empfehlen, eine targetSdkVersion auszuwählen, die kleiner oder gleich der Hauptversion der Supportbibliothek 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 aber als Orientierungshilfe für den Testprozess 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 um Berechtigungen bitten. Anleitung:

  • 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 prüfen Sie, ob die erforderlichen Berechtigungen noch einmal abgefragt werden.

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

  • Versetzen Sie Ihr Testgerät mit adb in den Stromsparmodus, 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-Modus 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üfe, ob deine App die eingeschränkten ACTION_NEW_PICTURE- und ACTION_NEW_VIDEO-Broadcasts korrekt verarbeitet (d. h. in JobScheduler-Jobs verschoben).
  • Achten Sie darauf, dass alle kritischen Anwendungsfälle, die von diesen Ereignissen abhängen, weiterhin funktionieren.

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

  • Prüfe, ob der Inhalt in der anderen App sichtbar ist und keine Abstürze verursacht.

Weitere Informationen

Aktiviere den E‑Mail-Empfang in der Google Play Console, damit wir dir wichtige Neuigkeiten und Ankündigungen von Android und Google Play senden können, einschließlich unseres monatlichen Partner-Newsletters.