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 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. Davon ausgenommen sind Wear OS- und Android TV-Apps, die auf Android 13 (API-Level 33) oder höher ausgerichtet sein müssen.
• 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. Wenn Sie Ihre App auf ein aktuelles API-Level ausrichten, können Sie auch die neuesten Funktionen der Plattform nutzen, um Ihre Nutzer zufriedenzustellen. 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 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
• Änderungen am Verhalten unter 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 festlegen, dass Apps nur ungefähre Standortdaten 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 Ruhemodus werden die Laufzeitberechtigungen und der Cache Ihrer App zurückgesetzt und Sie können keine Jobs oder Benachrichtigungen 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 vom Nutzer angefordert werden, starten Sie Dienste im Vordergrund innerhalb eines genauen 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 Trampolin für Benachrichtigungen 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.
• Fügen Sie Ihren Apps die Unterstützung für das dunkle Design hinzu.
• 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 Multifenster-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.
    • Die Höhe der Statusleiste darf nicht vorausgesetzt werden. 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 belegt. Bestätigen Sie stattdessen den Standort mit View.getLocationInWindow(), nicht mit View.getLocationOnScreen(). * Verwenden Sie 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 die SDK-Abhängigkeiten von Drittanbietern 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.

Sie sollten auch alle Einschränkungen prüfen, die in der von Ihnen verwendeten Version der Android-Supportbibliothek gelten. Wie immer müssen Sie für die Kompatibilität zwischen der Hauptversion der Android Support Library und der compileSdkVersion Ihrer 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 bei Ihrem Testprozess helfen. Wir schlagen folgende Tests vor:

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

• 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 Tests für die wichtigsten Anwendungsfälle durch und achten Sie darauf, 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 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.
  • 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 eingeschränkte ACTION_NEW_PICTURE und ACTION_NEW_VIDEO-Streams richtig verarbeitet, d. h., ob sie an JobScheduler-Jobs weitergeleitet werden.
  • 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 mit einer anderen App geteilt werden (auch mit einer anderen 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.