Wie bei früheren Releases enthält Android 15 Verhaltensänderungen, die sich auf Ihre App auswirken können. Die folgenden Verhaltensänderungen gelten ausschließlich für Apps, die auf Android 15 oder höher ausgerichtet sind. Wenn Ihre App auf Android 15 oder höher ausgerichtet ist, sollten Sie sie gegebenenfalls so ändern, dass sie diese Verhaltensweisen korrekt unterstützt.
Lesen Sie sich auch die Liste der Verhaltensänderungen durch, die sich auf alle Apps auswirken, die unter Android 15 ausgeführt werden, unabhängig von der targetSdkVersion
Ihrer App.
Hauptfunktion
In Android 15 wurden verschiedene Kernfunktionen des Android-Systems geändert oder erweitert.
Änderungen an Diensten im Vordergrund
Wir nehmen unter Android 15 die folgenden Änderungen an Diensten im Vordergrund vor.
- Verhalten bei Zeitüberschreitung bei der Datensynchronisierung im Vordergrund
- Neuer Dienst für die Medienverarbeitung im Vordergrund
- Einschränkungen für
BOOT_COMPLETED
Übertragungsempfänger, die Dienste im Vordergrund starten - Einschränkungen beim Starten von Diensten im Vordergrund, während eine App die Berechtigung
SYSTEM_ALERT_WINDOW
enthält
Verhalten bei Zeitüberschreitung bei der Datensynchronisierung im Vordergrund
Unter Android 15 wird für dataSync
ein neues Zeitlimit für Apps eingeführt, die auf Android 15 (API-Level 35) oder höher ausgerichtet sind. Dies gilt auch für den neuen Diensttyp mediaProcessing
im Vordergrund.
Das System erlaubt es den dataSync
-Diensten einer App, innerhalb eines Zeitraums von 24 Stunden insgesamt 6 Stunden lang ausgeführt zu werden. Danach ruft das System die Methode Service.onTimeout(int, int)
des laufenden Dienstes auf (in Android 15 eingeführt). In dieser Zeit hat der Dienst einige Sekunden Zeit, Service.stopSelf()
aufzurufen. Wenn Service.onTimeout()
aufgerufen wird, gilt der Dienst nicht mehr als Dienst im Vordergrund. Wenn der Dienst Service.stopSelf()
nicht aufruft, löst das System eine interne Ausnahme aus. Die Ausnahme wird in Logcat mit der folgenden Meldung protokolliert:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"
So vermeiden Sie Probleme mit dieser Verhaltensänderung:
- Lassen Sie Ihren Dienst die neue
Service.onTimeout(int, int)
-Methode implementieren. Wenn Ihre App den Callback empfängt, müssen Sie innerhalb weniger SekundenstopSelf()
anrufen. Wenn Sie die App nicht sofort beenden, generiert das System einen Fehler. - Die
dataSync
-Dienste Ihrer App dürfen innerhalb eines 24-Stunden-Zeitraums nicht länger als insgesamt 6 Stunden ausgeführt werden, es sei denn, der Nutzer interagiert mit der App und setzt den Timer zurück. - Starten Sie
dataSync
Dienste im Vordergrund nur als Folge einer direkten Nutzerinteraktion. Da sich Ihre App beim Start des Dienstes im Vordergrund befindet, hat Ihr Dienst die vollen sechs Stunden Zeit, nachdem die App in den Hintergrund gewechselt ist. - Verwenden Sie stattdessen eine alternative API.
dataSync
Wenn die dataSync
-Dienste im Vordergrund Ihrer App in den letzten 24 Stunden sechs Stunden lang ausgeführt wurden, können Sie keinen weiteren dataSync
-Dienst im Vordergrund starten, es sei denn, der Nutzer hat Ihre App in den Vordergrund gebracht (wodurch der Timer zurückgesetzt wird). Wenn Sie versuchen, einen weiteren dataSync
-Vordergrunddienst zu starten, gibt das System ForegroundServiceStartNotAllowedException
mit einer Fehlermeldung zurück, z. B. „Zeitlimit für den Typ ‚dataSync‘ des Vordergrunddienstes bereits überschritten“.
Testen
Sie können Zeitüberschreitungen für die Datensynchronisierung aktivieren, um das Verhalten Ihrer App zu testen, auch wenn Ihre App nicht auf Android 15 ausgerichtet ist, solange die App auf einem Android 15-Gerät ausgeführt wird. Führen Sie den folgenden Befehl adb
aus, um Zeitüberschreitungen zu aktivieren:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
Sie können auch die Zeitüberschreitung anpassen, um das Verhalten Ihrer App nach Erreichen des Limits leichter zu testen. Führen Sie den folgenden adb
-Befehl aus, um ein neues Zeitlimit festzulegen:
adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds
Neuer Typ von Dienst zur Medienverarbeitung im Vordergrund
In Android 15 wird der neue Diensttyp mediaProcessing
eingeführt. Dieser Diensttyp eignet sich für Vorgänge wie das Transcodieren von Mediendateien. Eine Medien-App könnte beispielsweise eine Audiodatei herunterladen und sie vor der Wiedergabe in ein anderes Format konvertieren. Sie können einen mediaProcessing
-Dienst im Vordergrund verwenden, damit die Conversion auch dann fortgesetzt wird, wenn die App im Hintergrund ausgeführt wird.
Das System lässt zu, dass die mediaProcessing
-Dienste einer App insgesamt 6 Stunden innerhalb von 24 Stunden ausgeführt werden. Anschließend ruft das System die Service.onTimeout(int, int)
-Methode des laufenden Dienstes auf (in Android 15 eingeführt). Derzeit hat der Dienst einige Sekunden Zeit, um Service.stopSelf()
aufzurufen. Wenn der Dienst Service.stopSelf()
nicht aufruft, löst das System eine interne Ausnahme aus. Die Ausnahme wird in Logcat mit der folgenden Meldung protokolliert:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
Sie können eine Ausnahme vermeiden, indem Sie einen der folgenden Schritte ausführen:
- Implementieren Sie in Ihrem Dienst die neue
Service.onTimeout(int, int)
-Methode. Wenn Ihre App den Callback empfängt, müssen Sie innerhalb weniger SekundenstopSelf()
anrufen. Wenn Sie die App nicht sofort beenden, generiert das System einen Fehler. - Die
mediaProcessing
-Dienste Ihrer App dürfen innerhalb eines 24-Stunden-Zeitraums insgesamt nicht länger als 6 Stunden ausgeführt werden, es sei denn, der Nutzer interagiert mit der App und setzt den Timer zurück. - Starten Sie
mediaProcessing
Dienste im Vordergrund nur als Folge einer direkten Nutzerinteraktion. Da sich Ihre App beim Start des Dienstes im Vordergrund befindet, hat Ihr Dienst die vollen sechs Stunden Zeit, nachdem die App in den Hintergrund gewechselt ist. - Verwende anstelle eines
mediaProcessing
-Dienstes im Vordergrund eine alternative API wie WorkManager.
Wenn die mediaProcessing
-Dienste im Vordergrund Ihrer App in den letzten 24 Stunden sechs Stunden lang ausgeführt wurden, können Sie keinen weiteren mediaProcessing
-Dienst im Vordergrund starten, es sei denn, der Nutzer hat Ihre App in den Vordergrund gebracht (wodurch der Timer zurückgesetzt wird). Wenn Sie versuchen, einen weiteren mediaProcessing
-Vordergrunddienst zu starten, löst das System ForegroundServiceStartNotAllowedException
mit einer Fehlermeldung wie „Zeitlimit für den Typ „mediaProcessing“ des Dienstes im Vordergrund bereits überschritten“ aus.
Weitere Informationen zum Diensttyp mediaProcessing
finden Sie unter Änderungen an Diensttypen im Vordergrund für Android 15: Medienverarbeitung.
Testen
Wenn du das Verhalten deiner App testen möchtest, kannst du Zeitüberschreitungen bei der Medienverarbeitung aktivieren, auch wenn deine App nicht auf Android 15 ausgerichtet ist, solange sie auf einem Android 15-Gerät ausgeführt wird. Führen Sie den folgenden Befehl adb
aus, um Zeitüberschreitungen zu aktivieren:
adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name
Sie können auch das Zeitlimit anpassen, um zu testen, wie sich Ihre Anwendung verhält, wenn das Limit erreicht ist. Führen Sie den folgenden adb
-Befehl aus, um ein neues Zeitlimit festzulegen:
adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds
Einschränkungen für BOOT_COMPLETED
Übertragungsempfänger, die Dienste im Vordergrund starten
There are new restrictions on BOOT_COMPLETED
broadcast receivers launching
foreground services. BOOT_COMPLETED
receivers are not allowed to launch the
following types of foreground services:
dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone
(this restriction has been in place formicrophone
since Android 14)
If a BOOT_COMPLETED
receiver tries to launch any of those types of foreground
services, the system throws ForegroundServiceStartNotAllowedException
.
Testing
To test your app's behavior, you can enable these new restrictions even if your
app is not targeting Android 15 (as long as the app is running on an Android 15
device). Run the following adb
command:
adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name
To send a BOOT_COMPLETED
broadcast without restarting the device,
run the following adb
command:
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name
Einschränkungen beim Starten von Diensten im Vordergrund, während eine App die Berechtigung „SYSTEM_ALERT_WINDOW
“ enthält
Bisher konnte eine App mit der Berechtigung SYSTEM_ALERT_WINDOW
einen Dienst im Vordergrund starten, auch wenn sie sich gerade im Hintergrund befand (wie unter Ausnahmen von Einschränkungen beim Starten im Hintergrund beschrieben).
Wenn eine App auf Android 15 ausgerichtet ist, ist diese Ausnahme jetzt eingeschränkter. Die App benötigt jetzt die Berechtigung SYSTEM_ALERT_WINDOW
und auch ein sichtbares Overlay-Fenster. Das bedeutet, dass die App zuerst ein TYPE_APPLICATION_OVERLAY
-Fenster öffnen und das Fenster sichtbar sein muss, bevor Sie einen Dienst im Vordergrund starten.
Wenn Ihre App versucht, einen Dienst im Vordergrund aus dem Hintergrund zu starten, ohne diese neuen Anforderungen zu erfüllen (und keine andere Ausnahme vorliegt), löst das System ForegroundServiceStartNotAllowedException
aus.
Wenn Ihre App die Berechtigung SYSTEM_ALERT_WINDOW
deklariert und Dienste im Vordergrund aus dem Hintergrund startet, kann sich diese Änderung auf Ihre App auswirken. Wenn deine App eine ForegroundServiceStartNotAllowedException
erhält, prüfe die Reihenfolge der Vorgänge in deiner App und achte darauf, dass deine App bereits ein aktives Overlay-Fenster hat, bevor sie versucht, einen Dienst im Vordergrund im Hintergrund zu starten. Du kannst mit View.getWindowVisibility()
prüfen, ob dein Overlay-Fenster gerade sichtbar ist. Du kannst auch View.onWindowVisibilityChanged()
überschreiben, um benachrichtigt zu werden, wenn sich die Sichtbarkeit ändert.
Testen
Um das Verhalten deiner App zu testen, kannst du diese neuen Einschränkungen auch dann aktivieren, wenn deine App nicht auf Android 15 ausgerichtet ist, solange sie auf einem Android 15-Gerät ausgeführt wird. Wenn Sie diese neuen Einschränkungen für den Start von Diensten im Vordergrund aus dem Hintergrund aktivieren möchten, führen Sie den folgenden adb
-Befehl aus:
adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name
Änderungen bei der Möglichkeit von Apps, den globalen Status des Modus „Bitte nicht stören“ zu ändern
Apps that target Android 15 (API level 35) and higher can no longer change the
global state or policy of Do Not Disturb (DND) on a device (either by modifying
user settings, or turning off DND mode). Instead, apps must contribute an
AutomaticZenRule
, which the system combines into a global policy with the
existing most-restrictive-policy-wins scheme. Calls to existing APIs that
previously affected global state (setInterruptionFilter
,
setNotificationPolicy
) result in the creation or update of an implicit
AutomaticZenRule
, which is toggled on and off depending on the call-cycle of
those API calls.
Note that this change only affects observable behavior if the app is calling
setInterruptionFilter(INTERRUPTION_FILTER_ALL)
and expects that call to
deactivate an AutomaticZenRule
that was previously activated by their owners.
Änderungen an der OpenJDK API
In Android 15 werden die Kernbibliotheken von Android weiter aktualisiert, um sie an die Funktionen der neuesten OpenJDK-LTS-Releases anzupassen.
Einige dieser Änderungen können sich auf die App-Kompatibilität für Apps auswirken, die auf Android 15 (API-Level 35) ausgerichtet sind:
Änderungen an APIs für die Stringformatierung: Die Validierung von Argumentindex, Flags, Breite und Genauigkeit ist jetzt bei der Verwendung der folgenden
String.format()
- undFormatter.format()
-APIs strenger:String.format(String, Object[])
String.format(Locale, String, Object[])
Formatter.format(String, Object[])
Formatter.format(Locale, String, Object[])
Beispielsweise wird die folgende Ausnahme geworfen, wenn der Argumentindex 0 verwendet wird (
%0
im Formatstring):IllegalFormatArgumentIndexException: Illegal format argument index = 0
In diesem Fall kann das Problem durch Verwendung eines Argumentindexes von 1 (
%1
im Formatstring) behoben werden.Änderungen am Komponententyp von
Arrays.asList(...).toArray()
: Bei Verwendung vonArrays.asList(...).toArray()
ist der Komponententyp des resultierenden Arrays jetzt einObject
– nicht der Typ der Elemente des zugrunde liegenden Arrays. Der folgende Code führt daher zu einemClassCastException
:String[] elements = (String[]) Arrays.asList("one", "two").toArray();
Wenn Sie in diesem Fall
String
als Komponententyp im resultierenden Array beibehalten möchten, können Sie stattdessenCollection.toArray(Object[])
verwenden:String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
Änderungen bei der Verarbeitung von Sprachcodes: Bei der Verwendung der
Locale
API werden Sprachcodes für Hebräisch, Jiddisch und Indonesisch nicht mehr in ihre veralteten Formen umgewandelt (Hebräisch:iw
, Jiddisch:ji
und Indonesisch:in
). Geben Sie den Sprachcode für eine dieser Sprachen stattdessen mit den Codes aus ISO 639-1 an (Hebräisch:he
, Jiddisch:yi
und Indonesisch:id
).Änderungen an Zufallszahlenfolgen: Aufgrund der Änderungen unter https://bugs.openjdk.org/browse/JDK-8301574 geben die folgenden
Random.ints()
-Methoden jetzt eine andere Zahlenfolge zurück als dieRandom.nextInt()
-Methoden:Im Allgemeinen sollte diese Änderung nicht zu einem Absturz der App führen. Ihr Code sollte jedoch nicht davon ausgehen, dass die von
Random.ints()
-Methoden generierte Sequenz mitRandom.nextInt()
übereinstimmt.
Die neue SequencedCollection
API kann sich auf die Kompatibilität Ihrer App auswirken, nachdem Sie compileSdk
in der Build-Konfiguration Ihrer App auf Android 15 (API-Level 35) aktualisiert haben:
Überschneidung mit den Erweiterungsfunktionen
MutableList.removeFirst()
undMutableList.removeLast()
inkotlin-stdlib
Der Typ
List
in Java wird dem TypMutableList
in Kotlin zugeordnet. Da die APIsList.removeFirst()
undList.removeLast()
in Android 15 (API-Ebene 35) eingeführt wurden, löst der Kotlin-Compiler Funktionsaufrufe wielist.removeFirst()
statisch auf die neuenList
APIs statt auf die Erweiterungsfunktionen inkotlin-stdlib
auf.Wenn eine App neu kompiliert wird, wobei
compileSdk
auf35
undminSdk
auf34
oder niedriger festgelegt ist, und dann auf Android 14 oder niedriger ausgeführt wird, wird ein Laufzeitfehler ausgegeben:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
Mit der vorhandenen
NewApi
-Lint-Option im Android Gradle-Plug-in können diese neuen API-Nutzungen erkannt werden../gradlew lint
MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()Um die Laufzeitausnahme und die Lint-Fehler zu beheben, können die Funktionsaufrufe
removeFirst()
undremoveLast()
in Kotlin durchremoveAt(0)
undremoveAt(list.lastIndex)
ersetzt werden. Wenn Sie Android Studio Ladybug | 2024.1.3 oder höher verwenden, gibt es auch eine Option zur Schnellkorrektur dieser Fehler.Entfernen Sie
@SuppressLint("NewApi")
undlintOptions { disable 'NewApi' }
, wenn die Lint-Option deaktiviert wurde.Überschneidung mit anderen Methoden in Java
Den vorhandenen Typen wurden neue Methoden hinzugefügt, z. B.
List
undDeque
. Diese neuen Methoden sind möglicherweise nicht mit den Methoden mit demselben Namen und denselben Argumenttypen in anderen Schnittstellen und Klassen kompatibel. Bei einer Kollision der Methodensignatur mit Inkompatibilität gibt derjavac
-Compiler einen Buildzeitfehler aus. Beispiel:Beispiel für Fehler 1:
javac MyList.java
MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List public void removeLast() { ^ return type void is not compatible with Object where E is a type-variable: E extends Object declared in interface ListBeispiel für Fehlermeldung 2:
javac MyList.java
MyList.java:7: error: types Deque<Object> and List<Object> are incompatible; public class MyList implements List<Object>, Deque<Object> { both define reversed(), but with unrelated return types 1 errorBeispiel für Fehler 3:
javac MyList.java
MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible; public static class MyList implements List<Object>, MyInterface<Object> { class MyList inherits unrelated defaults for getFirst() from types List and MyInterface where E#1,E#2 are type-variables: E#1 extends Object declared in interface List E#2 extends Object declared in interface MyInterface 1 errorUm diese Buildfehler zu beheben, sollte die Klasse, die diese Schnittstellen implementiert, die Methode mit einem kompatiblen Rückgabetyp überschreiben. Beispiel:
@Override public Object getFirst() { return List.super.getFirst(); }
Sicherheit
Android 15 enthält Änderungen, die die Systemsicherheit verbessern und Apps und Nutzer vor schädlichen Apps schützen sollen.
Start von sicheren Hintergrundaktivitäten
Android 15 protects users from malicious apps and gives them more control over their devices by adding changes that prevent malicious background apps from bringing other apps to the foreground, elevating their privileges, and abusing user interaction. Background activity launches have been restricted since Android 10 (API level 29).
Other changes
In addition to the restriction for UID matching, these other changes are also included:
- Change
PendingIntent
creators to block background activity launches by default. This helps prevent apps from accidentally creating aPendingIntent
that could be abused by malicious actors. - Don't bring an app to the foreground unless the
PendingIntent
sender allows it. This change aims to prevent malicious apps from abusing the ability to start activities in the background. By default, apps are not allowed to bring the task stack to the foreground unless the creator allows background activity launch privileges or the sender has background activity launch privileges. - Control how the top activity of a task stack can finish its task. If the top activity finishes a task, Android will go back to whichever task was last active. Moreover, if a non-top activity finishes its task, Android will go back to the home screen; it won't block the finish of this non-top activity.
- Prevent launching arbitrary activities from other apps into your own task. This change prevents malicious apps from phishing users by creating activities that appear to be from other apps.
- Block non-visible windows from being considered for background activity launches. This helps prevent malicious apps from abusing background activity launches to display unwanted or malicious content to users.
Sicherere Intents
Mit Android 15 werden neue optionale Sicherheitsmaßnahmen eingeführt, um Intents sicherer und robuster zu machen. Mit diesen Änderungen sollen potenzielle Sicherheitslücken und Missbrauch von Intents verhindert werden, die von schädlichen Apps ausgenutzt werden können. In Android 15 wurden zwei wichtige Verbesserungen an der Sicherheit von Intents vorgenommen:
- Intent-Filter des Ziels abgleichen: Intents, die auf bestimmte Komponenten ausgerichtet sind, müssen genau den Intent-Filterspezifikationen des Ziels entsprechen. Wenn Sie einen Intent senden, um die Aktivität einer anderen App zu starten, muss die Ziel-Intent-Komponente mit den deklarierten Intent-Filtern der Empfangsaktivität übereinstimmen.
- Intents müssen Aktionen haben: Intents ohne Aktion werden nicht mehr mit Intent-Filtern abgeglichen. Das bedeutet, dass Intents, die zum Starten von Aktivitäten oder Diensten verwendet werden, eine klar definierte Aktion haben müssen.
Wenn Sie prüfen möchten, wie Ihre App auf diese Änderungen reagiert, verwenden Sie StrictMode
in Ihrer App. Wenn Sie detaillierte Protokolle zu Verstößen bei der Nutzung von Intent
sehen möchten, fügen Sie die folgende Methode hinzu:
Kotlin
fun onCreate() { StrictMode.setVmPolicy(VmPolicy.Builder() .detectUnsafeIntentLaunch() .build() ) }
Java
public void onCreate() { StrictMode.setVmPolicy(new VmPolicy.Builder() .detectUnsafeIntentLaunch() .build()); }
Nutzererfahrung und System-UI
Android 15 enthält einige Änderungen, die für eine einheitlichere und intuitivere Nutzererfahrung sorgen sollen.
Änderungen am Fenstereinsatz
In Android 15 gibt es zwei Änderungen im Zusammenhang mit Fenstereinsätzen: Edge-to-Edge-Änderungen werden standardmäßig erzwungen. Außerdem gibt es Konfigurationsänderungen, z. B. die Standardkonfiguration von Systemleisten.
Edge-to-Edge-Erzwingung
Apps sind auf Geräten mit Android 15 standardmäßig Edge-to-Edge-Apps, wenn sie auf Android 15 (API-Level 35) ausgerichtet sind.
Diese nicht abwärtskompatible Änderung kann sich negativ auf die Benutzeroberfläche Ihrer App auswirken. Die Änderungen betreffen die folgenden Bereiche der Benutzeroberfläche:
- Navigationsleiste mit Touch-Griff
- Standardmäßig transparent.
- Der vertikale Versatz ist deaktiviert, sodass Inhalte hinter der Navigationsleiste des Systems dargestellt werden, es sei denn, Einzüge werden angewendet.
setNavigationBarColor
undR.attr#navigationBarColor
sind eingestellt und haben keine Auswirkungen auf die Gestennavigation.setNavigationBarContrastEnforced
undR.attr#navigationBarContrastEnforced
haben weiterhin keine Auswirkungen auf die Gestennavigation.
- Bedienung über 3 Schaltflächen
- Die Deckkraft ist standardmäßig auf 80% eingestellt und die Farbe entspricht möglicherweise dem Fensterhintergrund.
- Offset am unteren Rand ist deaktiviert, sodass Inhalte hinter der Systemnavigationsleiste angezeigt werden, sofern keine Einfügungen angewendet werden.
setNavigationBarColor
undR.attr#navigationBarColor
sind standardmäßig auf den Fensterhintergrund abgestimmt. Der Fensterhintergrund muss ein farbiges Drawable sein, damit diese Standardeinstellung angewendet werden kann. Diese API wird eingestellt, hat aber weiterhin Auswirkungen auf die Navigation mit drei Schaltflächen.setNavigationBarContrastEnforced
undR.attr#navigationBarContrastEnforced
sind standardmäßig aktiviert. Dadurch wird der Navigationsbereich mit drei Schaltflächen einen 80% opaken Hintergrund haben.
- Statusleiste
- Standardmäßig transparent.
- Der obere Versatz ist deaktiviert, sodass Inhalte hinter der Statusleiste dargestellt werden, es sei denn, es werden Einzüge angewendet.
setStatusBarColor
undR.attr#statusBarColor
werden nicht mehr unterstützt und haben keine Auswirkungen auf Android 15.setStatusBarContrastEnforced
undR.attr#statusBarContrastEnforced
sind eingestellt, wirken sich aber weiterhin auf Android 15 aus.
- Displayausschnitt
layoutInDisplayCutoutMode
von nicht frei schwebenden Fenstern mussLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
sein.SHORT_EDGES
,NEVER
undDEFAULT
werden alsALWAYS
interpretiert, damit Nutzer keine schwarze Leiste sehen, die durch den Displayausschnitt verursacht wird, und die Inhalte randlos angezeigt werden.
Im folgenden Beispiel wird eine App vor und nach der Ausrichtung auf Android 15 (API-Ebene 35) sowie vor und nach dem Anwenden von Einsätzen gezeigt.
Prüfen, ob Ihre App bereits bildschirmfüllend ist
Wenn Ihre App bereits randlos ist und Einzüge verwendet, sind Sie in den folgenden Fällen davon nicht betroffen: Auch wenn Sie der Meinung sind, dass Sie nicht betroffen sind, empfehlen wir Ihnen, Ihre App zu testen.
- Sie haben ein nicht schwebendes Fenster, z. B. ein
Activity
, dasSHORT_EDGES
,NEVER
oderDEFAULT
anstelle vonLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
verwendet. Wenn Ihre App beim Starten abstürzt, kann das an Ihrem Splashscreen liegen. Sie können die Abhängigkeit des Core-Splashscreens auf 1.2.0-alpha01 oder höher aktualisieren oderwindow.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
festlegen. - Es kann sein, dass es Bildschirme mit weniger Zugriffen gibt, auf denen die Benutzeroberfläche verdeckt ist. Prüfen Sie, ob die Benutzeroberfläche auf diesen weniger besuchten Bildschirmen nicht verdeckt ist. Beispiele für Bildschirme mit weniger Zugriffen:
- Einrichtungs- oder Anmeldebildschirme
- Einstellungsseiten
Was Sie prüfen sollten, wenn Ihre App noch nicht bildschirmfüllend ist
Wenn Ihre App noch nicht auf dem neuesten Stand ist, sind Sie höchstwahrscheinlich betroffen. Zusätzlich zu den Szenarien für Anwendungen, die bereits Edge-to-Edge-Anwendungen haben, sollten Sie Folgendes berücksichtigen:
- Wenn Ihre App Material 3-Komponenten (
androidx.compose.material3
) beim Schreiben verwendet, z. B.TopAppBar
,BottomAppBar
undNavigationBar
, sind diese Komponenten wahrscheinlich nicht betroffen, da sie Einfügungen automatisch verarbeiten. - Wenn Ihre App Material 2-Komponenten (
androidx.compose.material
) in Compose verwendet, verarbeiten diese Komponenten nicht automatisch Einfügungen. Sie können jedoch auf die Einleger zugreifen und sie manuell anwenden. In androidx.compose.material 1.6.0 und höher können Sie mit dem ParameterwindowInsets
die Einzüge manuell fürBottomAppBar
,TopAppBar
,BottomNavigation
undNavigationRail
anwenden. Verwenden Sie den ParametercontentWindowInsets
auch fürScaffold
. - Wenn Ihre App Ansichten und Material Components (
com.google.android.material
) verwendet, werden die meisten auf Ansichten basierenden Material Components wieBottomNavigationView
,BottomAppBar
,NavigationRailView
oderNavigationView
für Einzüge verwendet und erfordern keine zusätzlichen Arbeiten. Wenn SieAppBarLayout
verwenden, müssen Sie jedochandroid:fitsSystemWindows="true"
hinzufügen. - Bei benutzerdefinierten Composeables müssen Sie die Einzüge manuell als Abstand anwenden. Wenn sich Ihr Inhalt in einem
Scaffold
befindet, können Sie Einfügungen mithilfe derScaffold
-Padding-Werte aufnehmen. Andernfalls können Sie mithilfe vonWindowInsets
ein Abstandselement hinzufügen. - Wenn Ihre App Ansichten und
BottomSheet
-,SideSheet
- oder benutzerdefinierte Container verwendet, wenden Sie mitViewCompat.setOnApplyWindowInsetsListener
einen Abstand an. Wenden Sie fürRecyclerView
mit diesem Listener einen Abstand an und fügen SieclipToPadding="false"
hinzu.
Prüfen, ob Ihre App benutzerdefinierten Hintergrundschutz bieten muss
Wenn Ihre App einen benutzerdefinierten Hintergrundschutz für die Bedienung über 3 Schaltflächen oder die Statusleiste bieten muss, sollte in Ihrer App eine zusammensetzbare Funktion oder Ansicht hinter der Systemleiste platziert werden. Verwenden Sie dazu WindowInsets.Type#tappableElement()
, um die Höhe der Navigationsleiste mit 3 Schaltflächen oder WindowInsets.Type#statusBars
zu ermitteln.
Weitere Ressourcen für die Bildbearbeitung
Weitere Informationen zum Anwenden von Einfügungen finden Sie in den Leitfäden Edge to Edge View und Edge to Edge Compose.
Eingestellte APIs
Die folgenden APIs wurden verworfen, aber nicht deaktiviert:
R.attr#enforceStatusBarContrast
R.attr#navigationBarColor
(für die Bedienung über drei Schaltflächen mit 80 % Alpha)Window#isStatusBarContrastEnforced
Window#setNavigationBarColor
(für die Bedienung über drei Schaltflächen, mit 80% Alpha)Window#setStatusBarContrastEnforced
Die folgenden APIs werden eingestellt und deaktiviert:
R.attr#navigationBarColor
(für die Bedienung über Gesten)R.attr#navigationBarDividerColor
R.attr#statusBarColor
Window#setDecorFitsSystemWindows
Window#getNavigationBarColor
Window#getNavigationBarDividerColor
Window#getStatusBarColor
Window#setNavigationBarColor
(für die Bedienung über Gesten)Window#setNavigationBarDividerColor
Window#setStatusBarColor
Stabile Konfiguration
Wenn Ihre App auf Android 15 (API-Level 35) oder höher ausgerichtet ist, werden die Systemleisten von Configuration
nicht mehr ausgeschlossen. Wenn Sie die Bildschirmgröße in der Configuration
-Klasse für die Layoutberechnung verwenden, sollten Sie sie je nach Bedarf durch bessere Alternativen wie ViewGroup
, WindowInsets
oder WindowMetricsCalculator
ersetzen.
Configuration
ist seit API 1 verfügbar. Sie wird normalerweise aus Activity.onConfigurationChanged
abgerufen. Sie enthält Informationen wie Fensterdichte, -ausrichtung und -größe. Ein wichtiges Merkmal der von Configuration
zurückgegebenen Fenstergrößen ist, dass zuvor die Systemleisten ausgeschlossen wurden.
Die Konfigurationsgröße wird in der Regel für die Ressourcenauswahl verwendet, z. B. für /res/layout-h500dp
. Dies ist weiterhin ein gültiger Anwendungsfall. Es wurde jedoch immer davon abgeraten, es zur Berechnung
des Layouts zu verwenden. In diesem Fall sollten Sie sich jetzt davon abwenden. Je nach Anwendungsfall sollten Sie Configuration
durch einen geeigneteren Wert ersetzen.
Wenn Sie es zum Berechnen des Layouts verwenden, verwenden Sie eine geeignete ViewGroup
, z. B. CoordinatorLayout
oder ConstraintLayout
. Wenn Sie damit die Höhe der System-Navigationsleiste festlegen möchten, verwenden Sie WindowInsets
. Wenn Sie die aktuelle Größe Ihres App-Fensters ermitteln möchten, verwenden Sie computeCurrentWindowMetrics
.
In der folgenden Liste werden die Felder beschrieben, die von dieser Änderung betroffen sind:
- Bei den Größen
Configuration.screenWidthDp
undscreenHeightDp
werden die Systemleisten nicht mehr ausgeblendet. Configuration.smallestScreenWidthDp
ist indirekt von Änderungen anscreenWidthDp
undscreenHeightDp
betroffen.Configuration.orientation
wird indirekt von Änderungen anscreenWidthDp
undscreenHeightDp
auf nahezu quadratischen Geräten beeinflusst.Display.getSize(Point)
ist indirekt von den Änderungen inConfiguration
betroffen. Diese Funktion wurde ab API-Level 30 eingestellt.Display.getMetrics()
funktioniert seit API-Level 33 bereits so.
Das Attribut „elegantTextHeight“ hat standardmäßig den Wert „true“.
Bei Apps, die auf Android 15 ausgerichtet sind, wird das elegantTextHeight
-TextView
-Attribut standardmäßig auf true
gesetzt. Dabei wird die standardmäßig verwendete kompakte Schriftart durch einige Skripts mit großen vertikalen Messwerten durch eine Schriftart ersetzt, die viel besser lesbar ist. Die kompakte Schriftart wurde eingeführt, um fehlerhafte Layouts zu verhindern. Android 13 (API-Level 33) verhindert viele dieser Fehler, da das Textlayout mithilfe des Attributs fallbackLineSpacing
die vertikale Höhe erweitert.
In Android 15 ist die kompakte Schriftart weiterhin im System vorhanden. Daher kann deine App elegantTextHeight
auf false
setzen, um dasselbe Verhalten wie zuvor zu erzielen, wird aber in zukünftigen Releases wahrscheinlich nicht unterstützt. Wenn deine App also die folgenden Skripts unterstützt: Arabisch, Laotisch, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Ordia, Telugu oder Thai, teste deine App, indem du elegantTextHeight
auf true
setzt.
Breite des TextViews ändert sich bei komplexen Buchstabenformen
In früheren Android-Versionen wurden bei einigen Schriftarten mit Kurrentschrift oder Sprachen mit komplexer Schriftbildgestaltung die Buchstaben möglicherweise im Bereich des vorherigen oder nächsten Zeichens gezeichnet.
In einigen Fällen wurden solche Buchstaben am Anfang oder Ende abgeschnitten.
Ab Android 15 weist eine TextView
eine Breite zu, um genügend Platz für solche Buchstaben zu erhalten. Außerdem können Apps auf der linken Seite zusätzliche Abstände anfordern, um das Abschneiden zu verhindern.
Da sich diese Änderung darauf auswirkt, wie TextView
die Breite festlegt, weist TextView
standardmäßig mehr Breite zu, wenn die App auf Android 15 (API-Level 35) oder höher ausgerichtet ist. Sie können dieses Verhalten aktivieren oder deaktivieren, indem Sie die setUseBoundsForWidth
API auf TextView
aufrufen.
Da das Hinzufügen eines linken Abstands zu einer Fehlausrichtung bestehender Layouts führen kann, wird der Abstand auch bei Apps, die auf Android 15 oder höher ausgerichtet sind, nicht standardmäßig hinzugefügt.
Sie können jedoch zusätzliche Abstände hinzufügen, um ein Abschneiden zu verhindern. Rufen Sie dazu setShiftDrawingOffsetForStartOverhang
auf.
Die folgenden Beispiele zeigen, wie sich diese Änderungen auf das Textlayout für bestimmte Schriftarten und Sprachen auswirken können.
Localespezifische Standardzeilenhöhe für EditText
In früheren Android-Versionen wurde durch das Textlayout die Höhe des Texts so weit erweitert, dass sie der Zeilenhöhe der Schriftart entspricht, die der aktuellen Sprache entsprach. Wenn der Inhalt beispielsweise auf Japanisch war, da die Zeilenhöhe der japanischen Schriftart etwas größer als die einer lateinischen Schriftart ist, wurde die Höhe des Texts etwas größer. Trotz dieser unterschiedlichen Zeilenhöhen wurde die Größe des Elements EditText
unabhängig von der verwendeten Sprache jedoch einheitlich, wie in der folgenden Abbildung dargestellt:
Für Apps, die auf Android 15 ausgerichtet sind, ist jetzt für EditText
eine Mindestzeilenhöhe reserviert, die mit der Referenzschrift für das angegebene Gebietsschema übereinstimmt, wie in der folgenden Abbildung dargestellt:
Bei Bedarf können Sie das vorherige Verhalten Ihrer App wiederherstellen, indem Sie das Attribut useLocalePreferredLineHeightForMinimum
auf false
festlegen. Außerdem können in Ihrer App mithilfe der setMinimumFontMetrics
API in Kotlin und Java benutzerdefinierte vertikale Mindestmesswerte festgelegt werden.
Kamera und Medien
Unter Android 15 werden die folgenden Änderungen am Kamera- und Medienverhalten für Apps vorgenommen, die auf Android 15 oder höher ausgerichtet sind.
Einschränkungen beim Anfordern des Audiofokus
以 Android 15 为目标平台的应用必须是顶级应用或运行前台服务,才能请求音频焦点。如果应用在不符合其中任何一项要求时尝试请求焦点,该调用将返回 AUDIOFOCUS_REQUEST_FAILED
。
您可以参阅管理音频焦点,详细了解音频焦点。
Aktualisierte Einschränkungen für Nicht-SDKs
Android 15 包含更新后的受限非 SDK 接口列表(基于与 Android 开发者之间的协作以及最新的内部测试)。在限制使用非 SDK 接口之前,我们会尽可能确保有可用的公开替代方案。
如果您的应用并非以 Android 15 为目标平台,其中一些变更可能不会立即对您产生影响。不过,尽管您的应用可能会根据应用的目标 API 级别访问某些非 SDK 接口,但只要您使用任何非 SDK 方法或字段,终归存在导致应用出问题的显著风险。
如果您不确定自己的应用是否使用了非 SDK 接口,则可以测试该应用,进行确认。如果您的应用依赖于非 SDK 接口,您应该开始计划迁移到 SDK 替代方案。不过,我们知道某些应用具有使用非 SDK 接口的有效用例。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案,则应请求新的公共 API。
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 15. Weitere Informationen zu Nicht-SDK-Schnittstellen finden Sie unter Einschränkungen für Nicht-SDK-Schnittstellen.