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

Wenn du ein APK hochlädst, muss es die Anforderungen von Google Play an das Ziel-API-Level erfüllen.

Ab dem 31. August 2024 gilt Folgendes:

• Neue Apps und App-Updates müssen auf Android 14 (API-Level 34) oder höher ausgerichtet sein, damit sie bei Google Play eingereicht werden können. Eine Ausnahme bilden Wear OS- und Android TV-Apps, die auf Android 13 (API-Level 33) oder höher ausgerichtet sind.
• Vorhandene Apps müssen auf Android 13 (API-Level 33) oder höher ausgerichtet sein, damit sie weiterhin auf Geräten neuer Nutzer ausgeführt werden können, die eine höhere Version des Android-Betriebssystems haben als das Ziel-API-Level Ihrer App. Apps, die auf Android 12 (API-Level 31) oder niedriger (Android 10 (API-Level 29) oder niedriger für Wear OS und Android 11 (API-Level 30) oder niedriger für Android TV) ausgerichtet sind, 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 2024 beantragen. Im Lauf 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.
• Apps, die auf Android Automotive OS ausgerichtet sind oder für die APKs verwendet werden, die auf Android Automotive OS ausgerichtet sind.

Warum sollten Sie 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 die 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. Durch die Ausrichtung auf ein aktuelles API-Level kann deine App auch die neuesten Funktionen der Plattform nutzen und so deine Nutzer begeistern. Außerdem wird Nutzern ab Android 10 (API-Ebene 29) beim ersten Starten einer App, die auf Android 5.1 (API-Ebene 22) oder niedriger ausgerichtet ist, eine Warnung angezeigt.

In diesem Dokument werden wichtige Punkte hervorgehoben, die Sie beim Aktualisieren des Ziel-API-Levels beachten müssen, um die Google Play-Anforderung zu erfüllen. Lesen Sie die 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 auf eine neuere Android-Version aktualisieren möchtest, folge der Liste der relevanten Verhaltensänderungen:

• Verhaltensänderungen unter Android 13
• Änderungen im Verhalten von Android 14

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 angeben, 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.
• Ruhemodus: Apps können in den Ruhemodus versetzt werden, wenn sie über einen bestimmten Zeitraum nicht verwendet werden. Im Ruhezustand werden die Laufzeitberechtigungen und der Cache Ihrer Anwendung zurückgesetzt und Sie können keine Jobs oder Warnungen ausführen. Sie können den Ruhemodusstatus Ihrer App prüfen.
• Veränderlichkeit von PendingIntents: Sie müssen die Veränderlichkeit jedes PendingIntent-Objekts angeben, das von Ihrer App erstellt wird.

Nutzerfreundlichkeit

• Benutzerdefinierte Benachrichtigungen: Für Benachrichtigungen mit benutzerdefinierten Inhaltsansichten wird nicht mehr der gesamte Benachrichtigungsbereich verwendet. Stattdessen wendet das System eine Standardvorlage an. Mit dieser Vorlage haben benutzerdefinierte Benachrichtigungen in allen Status die gleiche Gestaltung wie andere Benachrichtigungen. Dieses Verhalten entspricht nahezu 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 Ihre Intent-Filter die Kategorie „BROWSABLE“ enthalten und das HTTPS-Schema unterstützen.

Leistung

• Einschränkungen beim Starten von Diensten im Vordergrund: Wenn Ihre App auf Android 12 oder höher ausgerichtet ist, kann sie Dienste im Vordergrund nur in wenigen Ausnahmefällen starten, während sie im Hintergrund ausgeführt wird. Wenn eine App versucht, einen Dienst im Vordergrund zu starten, während sie im Hintergrund ausgeführt wird, wird eine Ausnahme ausgelöst (außer in wenigen Sonderfällen).

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

• Einschränkungen für Trampoline für Benachrichtigungen: Wenn Nutzer auf Benachrichtigungen tippen, starten einige Apps eine App-Komponente, 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 Broadcastempfängern starten, die als Trampoline für Benachrichtigungen verwendet werden. Wenn ein Nutzer auf eine Benachrichtigung oder eine Aktionsschaltfläche in der Benachrichtigung tippt, kann Ihre App startActivity() nicht in einem Dienst oder Broadcast-Empfänger aufrufen.

Hier finden Sie eine vollständige Liste der Ä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.

• Sie können CameraX verwenden, das sich derzeit in der Betaphase befindet, 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 für Sie wichtig ist.
• Mit Kotlin können Sie bessere Apps schneller und mit weniger Code schreiben.
• Beachten Sie die Anforderungen und Best Practices zum Datenschutz.
• Unterstützung für das dunkle Design für deine Apps hinzufügen
• Fügen Sie Ihren Apps die Unterstützung für die Gestennavigation hinzu.
• Migrieren Sie Ihre App von Google Cloud Messaging (GCM) zur neuesten Version von Firebase Cloud Messaging.
• Nutze die erweiterte Fensterverwaltung.
  • Unterstützung größerer Seitenverhältnisse (über 16:9), um die Vorteile der neuesten Hardware zu nutzen. Achten Sie darauf, dass Ihre App so skaliert wird, dass sie den gesamten verfügbaren Bildschirm einnimmt. Geben Sie ein maximales Seitenverhältnis nur als letzten Ausweg an. Weitere Informationen zu maximalen Seitenverhältnissen finden Sie unter Unterstützung für eingeschränkte Bildschirme angeben.
  • Fügen Sie Multi-Window-Unterstützung hinzu, um die Produktivität Ihrer App zu steigern und mehrere Displays zu verwalten.
  • Wenn eine minimierte App die Nutzerfreundlichkeit verbessern würde, fügen Sie die Unterstützung für Bild im Bild hinzu.
    • Optimiere deine App für Geräte mit Display-Ausschnitt.
    • Gehen Sie nicht von der Höhe der Statusleiste aus. Verwenden Sie stattdessen WindowInsets und View.OnApplyWindowInsetsListener. Weitere Informationen finden Sie im Video droidcon NYC 2017.
    • Gehen Sie nicht davon aus, dass die App das gesamte Fenster umfasst. Bestätigen Sie stattdessen den Standort mit View.getLocationInWindow(), nicht mit View.getLocationOnScreen(). * Verwende für MotionEvent MotionEvent.getX() und MotionEvent.getY(), nicht MotionEvent.getRawX() oder MotionEvent.getRawY().

SDKs und Bibliotheken überprüfen und aktualisieren

Achten Sie darauf, dass Ihre Drittanbieter-SDK-Abhängigkeiten API 31 unterstützen: Einige SDK-Anbieter veröffentlichen sie in ihrem Manifest, bei anderen ist eine zusätzliche Prüfung erforderlich. Wenn Sie ein SDK verwenden, das API 31 nicht unterstützt, sollten Sie sich umgehend an den SDK-Anbieter wenden, um das Problem zu beheben.

Außerdem kann die targetSdkVersion Ihrer App oder Ihres Spiels den Zugriff auf private Android-Plattformbibliotheken einschränken. Weitere Informationen finden Sie unter Verknüpfung von NDK-Apps mit Plattformbibliotheken.

Außerdem solltest du alle Einschränkungen prüfen, die in der von dir verwendeten Version der Android-Supportbibliothek bestehen. Wie immer musst du für die Kompatibilität zwischen der Hauptversion der Android Support Library und der compileSdkVersion deiner App sorgen.

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 Hauptanwendungsfälle testen. Die folgenden Vorschläge sind nicht vollständig, sollen Ihnen aber beim Testen helfen. Wir schlagen folgende Tests vor:

• ob deine App ohne Fehler oder Warnungen zu API 29 kompiliert wird.

• Ihre App muss eine Strategie für den Fall haben, dass der Nutzer Berechtigungsanfragen ablehnt, und ihn um Berechtigungen bitten. Gehen Sie dazu so 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 grundlegende Anwendungsfalltests durch und prüfen Sie, ob die erforderlichen Berechtigungen wieder 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 Ruhemodus, 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.
  • Versetzen Sie Ihre App in den App-Standby-Modus.
    • 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 verarbeitet, d. h. in JobScheduler-Jobs verschoben wird.
  • Prüfen Sie, ob alle kritischen Anwendungsfälle, die von diesen Ereignissen abhängen, weiterhin funktionieren.

• Verwaltet die Freigabe von Dateien für andere Apps – Testen Sie alle Anwendungsfälle, bei 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 auslösen.

Weitere Informationen

Aktivieren Sie in der Google Play Console die Option „E-Mails erhalten“, damit wir Ihnen wichtige Updates und Ankündigungen von Android und Google Play senden können, einschließlich unseres monatlichen Partnernewsletters.