Wie in früheren Releases enthält Android 13 Verhaltensänderungen, die sich auf deine App auswirken können. Die folgenden Verhaltensänderungen gelten ausschließlich für Apps, die auf Android 13 oder höher ausgerichtet sind. Wenn Ihre App auf Android 13 oder höher ausgerichtet ist, sollten Sie sie gegebenenfalls so ändern, dass sie diese Verhaltensweisen korrekt unterstützt.
Sieh dir auch die Liste der Verhaltensänderungen an, die alle Apps unter Android 13 betreffen.
Datenschutz
Die Berechtigung zum Senden von Benachrichtigungen wirkt sich auf die Darstellung des Dienstes im Vordergrund aus
Wenn der Nutzer die Berechtigung zum Senden von Benachrichtigungen ablehnt, werden in der Benachrichtigungsleiste keine Hinweise zu Diensten im Vordergrund angezeigt. Nutzer sehen jedoch weiterhin Benachrichtigungen zu Diensten im Vordergrund im Task-Manager, unabhängig davon, ob die Berechtigung für Benachrichtigungen erteilt wurde.
Neue Laufzeitberechtigung für WLAN-Geräte in der Nähe
Bei früheren Android-Versionen muss der Nutzer Ihrer App die Berechtigung ACCESS_FINE_LOCATION gewähren, um mehrere gängige WLAN-Anwendungsfälle auszuführen.
Da es für Nutzer schwierig ist, Standortberechtigungen mit WLAN-Funktionen zu verknüpfen, führt Android 13 (API-Level 33) eine Laufzeitberechtigung in der Berechtigungsgruppe NEARBY_DEVICES für Apps ein, die die Verbindungen eines Geräts zu Zugangspunkten in der Nähe über WLAN verwalten. Diese Berechtigung, NEARBY_WIFI_DEVICES, erfüllt WLAN-Nutzungsfälle wie die folgenden:
- Geräte in der Nähe suchen oder eine Verbindung zu ihnen herstellen, z. B. Drucker oder Geräte zum Streamen von Medien
Mit diesem Workflow kann Ihre App folgende Aufgaben ausführen:
- Out-of-Band-Zugriff auf ZP-Informationen, z. B. über BLE
- Du kannst Geräte über Wi-Fi Aware erkennen und verbinden und sie über einen nur lokalen Hotspot verbinden.
- Geräte über Wi‑Fi Direct finden und eine Verbindung herstellen
- Stellen Sie eine Verbindung zu einer bekannten SSID her, z. B. zu einem Auto oder Smart-Home-Gerät.
- Starten Sie einen lokalen Hotspot.
- Reichweite zu WLAN-Aware-Geräten in der Nähe
Solange Ihre App keine physischen Standortinformationen aus den WLAN-APIs ableitet, fordern Sie NEARBY_WIFI_DEVICES anstelle von ACCESS_FINE_LOCATION an, wenn Sie Ihre App auf Android 13 oder höher ausrichten und WLAN-APIs verwenden. Wenn du die Berechtigung NEARBY_WIFI_DEVICES festlegst, solltest du unbedingt darauf hinweisen, dass deine App niemals Informationen zum physischen Standort von Wi-Fi APIs ableitet. Setzen Sie dazu das Attribut android:usesPermissionFlags auf neverForLocation. Dieser Vorgang ähnelt dem, den Sie unter Android 12 (API-Level 31) und höher ausführen, wenn Sie angeben, dass Bluetooth-Geräteinformationen niemals für die Standortermittlung verwendet werden.
Weitere Informationen zum Anfordern einer Berechtigung für den Zugriff auf WLAN-Geräte in der Nähe
Detaillierte Medienberechtigungen
READ_MEDIA_AUDIO anfordern.Wenn deine App auf Android 13 oder höher ausgerichtet ist und auf Mediendateien zugreifen muss, die von anderen Apps erstellt wurden, musst du anstelle der Berechtigung READ_EXTERNAL_STORAGE eine oder mehrere der folgenden detaillierten Medienberechtigungen anfordern:
| Medientyp | Berechtigung zum Anfordern |
|---|---|
| Bilder und Fotos | READ_MEDIA_IMAGES |
| Videos | READ_MEDIA_VIDEO |
| Audiodateien | READ_MEDIA_AUDIO |
Bevor Sie auf die Mediendateien einer anderen App zugreifen, prüfen Sie, ob der Nutzer Ihrer App die entsprechenden detaillierten Medienberechtigungen erteilt hat.
Abbildung 1 zeigt eine App, die die Berechtigung READ_MEDIA_AUDIO anfordert.
Wenn Sie sowohl die Berechtigung READ_MEDIA_IMAGES als auch die Berechtigung READ_MEDIA_VIDEO gleichzeitig anfordern, wird nur ein Systemberechtigungsdialogfeld angezeigt.
Wenn Ihrer App zuvor die Berechtigung READ_EXTERNAL_STORAGE gewährt wurde, werden alle angeforderten READ_MEDIA_*-Berechtigungen beim Upgrade automatisch gewährt. Mit dem folgenden ADB-Befehl können Sie aktualisierte Berechtigungen prüfen:
adb shell cmd appops get --uid PACKAGE_NAME
Für die Verwendung von Körpersensoren im Hintergrund ist eine neue Berechtigung erforderlich
In Android 13 wird das Konzept des Zugriffs „bei Nutzung“ für Körpersensoren wie Herzfrequenz, Temperatur und Sauerstoffsättigung eingeführt. Dieses Zugriffsmodell ähnelt sehr dem, das das System für den Standort in Android 10 (API-Ebene 29) eingeführt hat.
Wenn Ihre App auf Android 13 ausgerichtet ist und Zugriff auf Informationen von Körpersensoren benötigt, während sie im Hintergrund ausgeführt wird, müssen Sie zusätzlich zur vorhandenen Berechtigung BODY_SENSORS die neue Berechtigung BODY_SENSORS_BACKGROUND deklarieren.
Leistung und Akku
Akkuressourcennutzung
Wenn der Nutzer Ihre App für die Akkunutzung im Hintergrund in den Status eingeschränkt versetzt, während Ihre App auf Android 13 ausgerichtet ist, sendet das System die BOOT_COMPLETED- oder LOCKED_BOOT_COMPLETED-Broadcasts erst, wenn die App aus anderen Gründen gestartet wird.
Nutzererfahrung
Mediensteuerelemente, die aus PlaybackState abgeleitet wurden
Für Apps, die auf Android 13 (API-Level 33) und höher ausgerichtet sind, leitet das System Mediensteuerelemente aus PlaybackState-Aktionen ab. So kann das System mehr Steuerelemente anzeigen, die technisch zwischen Smartphones und Tablets konsistent sind und auch mit der Darstellung von Mediensteuerelementen auf anderen Android-Plattformen wie Android Auto und Android TV übereinstimmen.
Abbildung 2 zeigt, wie das auf einem Smartphone und einem Tablet jeweils aussieht.
Vor Android 13 zeigte das System bis zu fünf Aktionen aus der MediaStyle-Benachrichtigung in der Reihenfolge an, in der sie hinzugefügt wurden.
Im kompakten Modus, z. B. in den minimierten Schnelleinstellungen, wurden bis zu drei mit setShowActionsInCompactView() angegebene Aktionen angezeigt.
Ab Android 13 werden im System bis zu fünf Aktionsschaltflächen basierend auf PlaybackState angezeigt, wie in der folgenden Tabelle beschrieben. Im kompakten Modus werden nur die ersten drei Aktionsslots angezeigt. Bei Apps, die nicht auf Android 13 ausgerichtet sind oder keine PlaybackState enthalten, zeigt das System Steuerelemente an, die auf der Action-Liste basieren, die der MediaStyle-Benachrichtigung wie im vorherigen Abschnitt beschrieben hinzugefügt wurde.
| Stellen | Aktion | Kriterien |
|---|---|---|
| 1 | Wiedergeben |
Der aktuelle Status des PlaybackState ist einer der folgenden:
|
| Rotierendes Ladesymbol |
Der aktuelle Status der PlaybackState ist einer der folgenden:
|
|
| Pausieren | Der aktuelle Status der PlaybackState ist keiner der oben genannten. |
|
| 2 | Zurück | PlaybackState Aktionen umfassen ACTION_SKIP_TO_PREVIOUS. |
| Benutzerdefiniert | PlaybackState-Aktionen enthalten keine ACTION_SKIP_TO_PREVIOUS und PlaybackState-benutzerdefinierten Aktionen enthalten eine benutzerdefinierte Aktion, die noch nicht platziert wurde. |
|
| Leer | PlaybackState-Extras enthalten einen booleschen Wert für true für den Schlüssel SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_PREV. |
|
| 3 | Weiter | PlaybackState actions enthält ACTION_SKIP_TO_NEXT. |
| Benutzerdefiniert | PlaybackState Aktionen enthalten ACTION_SKIP_TO_NEXT nicht und PlaybackState benutzerdefinierte Aktionen enthalten eine noch nicht platzierte benutzerdefinierte Aktion. |
|
| Leer | PlaybackState-Extras enthalten einen booleschen Wert für true für den Schlüssel SESSION_EXTRAS_KEY_SLOT_RESERVATION_SKIP_TO_NEXT. |
|
| 4 | Benutzerdefiniert | PlaybackState benutzerdefinierte Aktionen enthalten eine benutzerdefinierte Aktion, die noch nicht platziert wurde. |
| 5 | Benutzerdefiniert | PlaybackState benutzerdefinierte Aktionen enthalten eine benutzerdefinierte Aktion, die noch nicht platziert wurde. |
Benutzerdefinierte Aktionen werden in der Reihenfolge platziert, in der sie dem PlaybackState hinzugefügt wurden.
Das Farbschema der App wird automatisch auf WebView-Inhalte angewendet
Bei Apps, die auf Android 13 (API-Level 33) oder höher ausgerichtet sind, wird die Methode setForceDark() nicht mehr unterstützt. Wenn sie aufgerufen wird, geschieht nichts.
Stattdessen legt WebView die Medienabfrage prefers-color-scheme jetzt immer gemäß dem Themenattribut isLightTheme der App fest. Mit anderen Worten: Wenn isLightTheme true ist oder nicht angegeben ist, ist prefers-color-scheme light. Andernfalls ist es dark. Das bedeutet, dass der helle oder dunkle Stil der Webinhalte automatisch an das Design der App angepasst wird, sofern der Inhalt dies unterstützt.
Bei den meisten Apps sollten die entsprechenden App-Styles durch das neue Verhalten automatisch angewendet werden. Sie sollten Ihre App jedoch testen, um zu prüfen, ob Sie die Einstellungen für den dunklen Modus möglicherweise manuell gesteuert haben.
Wenn Sie das Verhalten des Farbschemas Ihrer App trotzdem anpassen möchten, verwenden Sie stattdessen die Methode setAlgorithmicDarkeningAllowed(). Für die Abwärtskompatibilität mit früheren Android-Versionen empfehlen wir die Verwendung der entsprechenden Methode setAlgorithmicDarkeningAllowed() in AndroidX.
In der Dokumentation zu dieser Methode erfährst du mehr darüber, welches Verhalten du je nach targetSdkVersion- und Designeinstellungen deiner App in deiner App erwarten kannst.
Konnektivität
BluetoothAdapter#enable() und BluetoothAdapter#disable() werden eingestellt
Für Apps, die auf Android 13 (API-Level 33) oder höher ausgerichtet sind, werden die Methoden BluetoothAdapter#enable() und BluetoothAdapter#disable() eingestellt. Sie geben immer false zurück.
Die folgenden Arten von Apps sind von diesen Änderungen ausgenommen:
- Apps vom Geräteinhaber
- Apps von Profilinhabern
- System-Apps
Google Play-Dienste
Berechtigung für Werbe-ID erforderlich
Für Apps, die die Werbe-ID der Google Play-Dienste verwenden und auf Android 13 (API-Level 33) und höher ausgerichtet sind, muss in der Manifestdatei der App die normale Berechtigung AD_ID so deklariert werden:
<manifest ...>
<!-- Required only if your app targets Android 13 or higher. -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
<application ...>
...
</application>
</manifest>
Wenn diese Berechtigung für Ihre App bei der Ausrichtung auf Android 13 oder höher nicht deklariert ist, wird die Werbe-ID automatisch entfernt und durch eine Reihe von Nullen ersetzt.
Wenn Ihre App SDKs verwendet, die die Berechtigung AD_ID im Manifest der Bibliothek deklarieren, wird die Berechtigung standardmäßig mit der Manifestdatei Ihrer App zusammengeführt. In diesem Fall musst du die Berechtigung nicht in der Manfiest-Datei deiner App deklarieren.
Weitere Informationen findest du in der Play Console-Hilfe unter Werbe-ID.
Aktualisierte Einschränkungen für Nicht-SDKs
Android 13 enthält aktualisierte Listen eingeschränkter nicht SDK-basierter Schnittstellen, die auf der Zusammenarbeit mit Android-Entwicklern und den neuesten internen Tests basieren. Wann immer möglich, achten wir darauf, dass öffentliche Alternativen verfügbar sind, bevor wir Nicht-SDK-Schnittstellen einschränken.
Wenn Ihre App nicht auf Android 13 ausgerichtet ist, wirken sich einige dieser Änderungen möglicherweise nicht sofort auf Sie aus. Derzeit können Sie zwar einige Nicht-SDK-Schnittstellen verwenden (je nach Ziel-API-Level Ihrer App), aber bei Verwendung von Nicht-SDK-Methoden und -Feldern besteht immer ein hohes Risiko, dass Ihre App nicht mehr funktioniert.
Wenn Sie nicht sicher sind, ob Ihre App Nicht-SDK-Schnittstellen verwendet, können Sie Ihre App testen, um das herauszufinden. Wenn Ihre App Nicht-SDK-Schnittstellen benötigt, sollten Sie eine Migration zu SDK-Alternativen planen. Uns ist aber bewusst, dass es bei einigen Apps gültige Anwendungsfälle für die Verwendung von Nicht-SDK-Schnittstellen gibt. Wenn Sie keine Alternative zur Verwendung einer Nicht-SDK-Benutzeroberfläche für eine Funktion in Ihrer App finden, sollten Sie eine neue öffentliche API anfordern.
Weitere Informationen zu den Änderungen in dieser Android-Version finden Sie unter Änderungen an den Einschränkungen für nicht SDK-spezifische Oberflächen in Android 13. Weitere Informationen zu Nicht-SDK-Schnittstellen finden Sie unter Einschränkungen für Nicht-SDK-Schnittstellen.