Wie in früheren Releases umfasst auch Android 15 Verhaltensänderungen, die sich auf deine App auswirken können. Die folgenden Änderungen gelten ausschließlich für Apps, die auf Android 15 oder höher ausgerichtet sind. Wenn deine App auf Android 15 oder höher ausgerichtet ist, solltest du sie gegebenenfalls so anpassen, dass diese Verhaltensweisen ordnungsgemäß unterstützt werden.
Sehen Sie sich auch die Liste der Änderungen des Verhaltens an, die unabhängig vom targetSdkVersion
Ihrer App Auswirkungen auf alle Apps unter Android 15 haben.
Hauptfunktion
Mit Android 15 werden verschiedene Kernfunktionen des Android-Systems modifiziert oder erweitert.
Änderungen an Diensten im Vordergrund
Mit Android 15 nehmen wir die folgenden Änderungen an Diensten im Vordergrund vor.
- Neuer Typ des Diensts für die Medienverarbeitung im Vordergrund
- Einschränkungen für
BOOT_COMPLETED
Broadcast-Empfänger, die Dienste im Vordergrund starten
Neuer Typ des Diensts für die Medienverarbeitung im Vordergrund
Mit Android 15 wird der neue Diensttyp mediaProcessing
im Vordergrund eingeführt. Dieser Diensttyp eignet sich für Vorgänge wie das Transcodieren von Mediendateien. Eine Medien-App lädt beispielsweise eine Audiodatei herunter und muss sie vor der Wiedergabe in ein anderes Format konvertieren. Mit einem mediaProcessing
-Dienst im Vordergrund können Sie dafür sorgen, dass die Konvertierung auch dann fortgesetzt wird, wenn die App im Hintergrund ausgeführt wird.
Weitere Informationen zum Diensttyp mediaProcessing
findest du unter Änderungen an den Diensttypen im Vordergrund für Android 15.
Einschränkungen für BOOT_COMPLETED
Sender, die Dienste im Vordergrund starten
Es gibt neue Einschränkungen für BOOT_COMPLETED
-Sender, die Dienste im Vordergrund starten. BOOT_COMPLETED
-Empfänger dürfen die folgenden Arten von Diensten im Vordergrund nicht starten:
dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone
(diese Einschränkung gilt fürmicrophone
seit Android 14)
Wenn ein BOOT_COMPLETED
-Empfänger versucht, einen dieser Arten von Diensten im Vordergrund zu starten, gibt das System ForegroundServiceStartNotAllowedException
aus.
Nutzererfahrung
Android 15 umfasst einige Änderungen, die für eine einheitlichere und intuitivere Nutzererfahrung sorgen sollen.
Änderungen des Fenstereinsatzes
Es gibt zwei Änderungen in Bezug auf Fenstereinsätze in Android 15. In der Betaversion 1 wird Edge-to-Edge-Regeln erzwungen. Außerdem kommt es zu Änderungen an der Konfiguration, einschließlich der Standardkonfiguration von Systemleisten.
Edge-to-Edge-Erzwingung
Apps sind auf Geräten mit Android 15 standardmäßig Edge-to-Edge-Geräten, wenn sie auf Android 15 ausgerichtet sind.
Dies ist eine funktionsgefährdende Änderung, die sich negativ auf die Benutzeroberfläche Ihrer App auswirken kann. Folgende Änderungen wurden vorgenommen:
- Navigationsleiste durch Gesten-Ziehpunkt
- Standardmäßig transparent.
- Der untere Offset ist deaktiviert, sodass der Inhalt hinter die Navigationsleiste des Systems zieht, sofern keine Einsätze angewendet werden.
setNavigationBarColor
undR.attr#navigationBarColor
wurden verworfen und wirken sich nicht auf die Bedienung über Gesten aus.setNavigationBarContrastEnforced
undR.attr#navigationBarContrastEnforced
haben weiterhin keinen Einfluss auf die Bedienung über Gesten.
- Bedienung über 3 Schaltflächen
- Die Deckkraft ist standardmäßig auf 80% festgelegt, wobei die Farbe möglicherweise dem Fensterhintergrund entspricht.
- Unterer Offset ist deaktiviert, sodass der Inhalt hinter die Navigationsleiste des Systems zieht, wenn keine Einsätze angewendet werden.
setNavigationBarColor
undR.attr#navigationBarColor
sind standardmäßig so eingestellt, dass sie dem Fensterhintergrund entsprechen. Der Fensterhintergrund muss ein Drawable sein, damit diese Standardeinstellung angewendet wird. Diese API wurde eingestellt, wirkt sich aber weiterhin auf die Navigation über drei Schaltflächen aus.setNavigationBarContrastEnforced
undR.attr#navigationBarContrastEnforced
sind standardmäßig auf „true“ gesetzt, wodurch bei den drei Schaltflächen ein undurchsichtiger Hintergrund von 80 % hinzugefügt wird.
- Statusleiste
- Standardmäßig transparent.
- Der obere Offset ist deaktiviert, sodass der Inhalt hinter die Statusleiste gezogen wird, sofern keine Einsätze angewendet werden.
setStatusBarColor
undR.attr#statusBarColor
wurden eingestellt und haben keine Auswirkungen auf Android 15.setStatusBarContrastEnforced
undR.attr#statusBarContrastEnforced
wurden eingestellt, haben aber weiterhin Auswirkungen auf Android 15.
- Display-Aussparung
layoutInDisplayCutoutMode
der nicht unverankerten Fenster mussLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
sein. Andernfalls stürzen Apps mit der Ausnahme „= Ausnahme“ ab. Damit lässt sich verhindern, dass Nutzer im Querformat einen schwarzen Balken sehen, der durch die Display-Aussparung verursacht wurde, und diesen somit randvoll erscheinen. Das ist die einzige zulässige Option.
Das folgende Beispiel zeigt eine App vor und nach dem Targeting auf Android 15 sowie vor und nach dem Anwenden von Einsätzen.
Wenn Ihre App:
- bereits Edge-to-Edge ist und Einsätze anwendet, sind Sie größtenteils nicht betroffen, mit Ausnahme der folgenden Szenarien. Auch wenn Sie der Meinung sind, dass Sie nicht betroffen sind, sollten Sie Ihre App testen.
- Ihre App stürzt ab, weil Sie ein nicht schwebendes Fenster haben, z. B. eine Activity, die
SHORT_EDGES, NEVER
oderDEFAULT
anstelle vonLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
verwendet. Wenn Ihre App beim Start abstürzt, kann dies an Ihrem Ladebildschirm liegen. Legen Siewindow.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
fest, bis eine Korrektur verfügbar ist. - Möglicherweise sind Bildschirme mit geringerem Verkehrsaufkommen mit verdeckter Benutzeroberfläche zu sehen. Diese Bildschirme, die seltener aufgerufen werden, dürfen keine verdeckte Benutzeroberfläche haben. Zu den Bildschirmen mit geringerem Traffic gehören:
- Onboarding- oder Anmeldebildschirme
- Einstellungsseiten
- Ihre App stürzt ab, weil Sie ein nicht schwebendes Fenster haben, z. B. eine Activity, die
- nicht randvoll ist, sind Sie höchstwahrscheinlich betroffen. Zusätzlich zu den Szenarien für Anwendungen, die bereits Edge-to-Edge-Anwendungen sind, müssen Sie Folgendes berücksichtigen:
- Wenn in Ihrer App Material 3-Komponenten (androidx.compose.material3) beim Schreiben verwendet werden, z. B.
TopAppBar, BottomAppBar
undNavigationBar
, sind diese Komponenten wahrscheinlich nicht betroffen, da sie Eingaben automatisch verarbeiten. - Wenn Ihre App Material 2-Komponenten (androidx.compose.material in Compose) verwendet, verarbeiten diese Komponenten nicht automatisch Einsätze. Sie können jedoch Zugriff auf die Einsätze erhalten und sie manuell anwenden. Verwenden Sie in androidx.compose.material 1.6.0 und höher den Parameter windowInsets, um die Einsätze manuell auf
BottomAppBar
,TopAppBar
,BottomNavigation
undNavigationRail
anzuwenden. Verwenden Sie ebenso den ParametercontentWindowInsets
fürScaffold
. - Wenn Ihre App Ansichten und Materialkomponenten (com.google.android.material) verwendet, verarbeiten die meisten auf Ansichten basierenden Materialkomponenten wie
BottomNavigationView
,BottomAppBar
,NavigationRailView
oderNavigationView
Einsätze und erfordern keine zusätzliche Arbeit. Wenn Sie jedochAppBarLayout
verwenden, müssen Sieandroid:fitsSystemWindows="true"
hinzufügen. - Wenden Sie bei benutzerdefinierten zusammensetzbaren Funktionen die Einfügungen manuell als Abstand an. Wenn sich Ihr Inhalt in einem Scaffold befindet, können Sie Werte mit den Padding-Werten von Scaffold verwenden. Andernfalls wenden Sie das Padding mit einer der
WindowInsets
an. - Wenn Ihre App „Views“ und „BottomSheet“, „SideSheet“ oder benutzerdefinierte Container verwendet, wenden Sie mit
ViewCompat.setOnApplyWindowInsetsListener
einen Abstand an. Wenden Sie für RecyclerView mit diesem Listener einen Innenabstand an und fügen SieclipToPadding="false"
hinzu.
- Wenn in Ihrer App Material 3-Komponenten (androidx.compose.material3) beim Schreiben verwendet werden, z. B.
- einen benutzerdefinierten Hintergrundschutz für die Navigation über drei Schaltflächen oder die Statusleiste anbieten muss, sollten Sie eine zusammensetzbare Funktion oder Ansicht mit
WindowInsets.Type#tappableElement()
hinter der Systemleiste platzieren, um die Höhe der Navigationsleiste oderWindowInsets.Type#statusBars
abzurufen.
Weitere Informationen zum Anwenden von Einsätzen finden Sie in den Leitfäden Edge-to-Edge-Ansichten und Edge-to-Edge-Compose.
Liste der verworfenen und deaktivierten APIs:
- R.attr#statusBarColor
- #navigationBarColor
- R.attr#navigationBarDividerColor
- Window#setDecorFitsSystemWindows
- Fenster#setStatusBarColor
- Fenster#setStatusBarContrastEnforced
- Fenster#setNavigationBarColor
- Window#setNavigationBarDividerColor
- Fenster#getStatusBarColor
- Fenster#getStatusBarContrastEnforced
- Window#getNavigationBarColor
- Window#getNavigationBarDividerColor
Stabile Konfiguration
Diese Änderung ist in Beta 1 noch nicht verfügbar, wird aber demnächst eingeführt.
Wenn Ihre App auf Android 15 oder höher ausgerichtet ist, schließt Configuration
die Systemleisten nicht mehr aus. Wenn Sie die Bildschirmgröße in der Klasse Configuration
für die Layoutberechnung verwenden, sollten Sie sie je nach Bedarf durch geeignete Alternativen wie ViewGroup
, WindowInsets
oder WindowMetricsCalculator
ersetzen.
Configuration
ist seit API 1 verfügbar. Sie wird normalerweise aus Activity.onConfigurationChanged
abgerufen. Sie liefert Informationen wie Fensterdichte,
Ausrichtung und Größe. Ein wichtiges Merkmal der von Configuration
zurückgegebenen Fenstergrößen ist, dass die Systemleisten zuvor ausgeschlossen wurden.
Die Konfigurationsgröße wird in der Regel für die Ressourcenauswahl verwendet, z. B. /res/layout-h500dp
, und dies ist immer noch ein gültiger Anwendungsfall. Wir raten jedoch immer davon ab, sie für
Layoutberechnungen zu verwenden. In diesem Fall sollten Sie
sich jetzt davon entfernen. Sie sollten die Verwendung von Configuration
je nach Anwendungsfall durch einen geeigneteren Wert ersetzen.
Wenn Sie ihn zur Berechnung des Layouts nutzen, verwenden Sie einen geeigneten ViewGroup
wie CoordinatorLayout
oder ConstraintLayout
. Wenn Sie damit die Höhe der Systemnavigationsleiste ermitteln möchten, verwenden Sie WindowInsets
. Wenn Sie die aktuelle Größe Ihres App-Fensters wissen möchten, verwenden Sie computeCurrentWindowMetrics
.
In der folgenden Liste werden die von dieser Änderung betroffenen Felder beschrieben:
- Bei den Größen
Configuration.screenWidthDp
undscreenHeightDp
werden die Systemleisten nicht mehr ausgeschlossen. Configuration.smallestScreenWidthDp
ist indirekt von Änderungen anscreenWidthDp
undscreenHeightDp
betroffen.Configuration.orientation
ist indirekt von Änderungen anscreenWidthDp
undscreenHeightDp
auf Close-to- Square-Geräten betroffen.Display.getSize(Point)
ist indirekt von den Änderungen an der Konfiguration betroffen. Seit API-Level 30 ist dies nicht mehr verfügbar.Display.getMetrics()
funktioniert schon seit API-Level 33 so.
Der Standardwert für das eleganteTextHeight-Attribut ist „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.
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
Apps, die auf Android 15 ausgerichtet sind, müssen die Top-Apps sein oder einen audiobezogenen Dienst im Vordergrund ausführen, um den Audiofokus anzufordern. Wenn eine App versucht, den Fokus anzufordern, obwohl sie eine dieser Anforderungen nicht erfüllt, gibt der Aufruf AUDIOFOCUS_REQUEST_FAILED
zurück.
Ein Dienst im Vordergrund gilt als audiobezogen, wenn sein Typ mediaPlayback
, camera
, microphone
oder phoneCall
ist.
Weitere Informationen zum Audiofokus finden Sie unter Audiofokus verwalten.
Nicht-SDK-Einschränkungen aktualisiert
Android 15 enthält aktualisierte Listen eingeschränkter Nicht-SDK-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 deine App nicht auf Android 15 ausgerichtet ist, betreffen dich einige dieser Änderungen möglicherweise nicht sofort. Ihre App kann zwar je nach Ziel-API-Level Ihrer App auf einige Nicht-SDK-Schnittstellen zugreifen, aber die Verwendung von Nicht-SDK-Methoden oder -Feldern birgt immer ein hohes Risiko für Probleme mit Ihrer App.
Wenn Sie sich nicht sicher sind, ob Ihre App Nicht-SDK-Schnittstellen verwendet, können Sie Ihre App testen. Wenn Ihre App Nicht-SDK-Schnittstellen verwendet, sollten Sie mit der Planung einer Migration zu SDK-Alternativen beginnen. Trotzdem sind wir uns bewusst, dass einige Anwendungen gültige Anwendungsfälle für die Verwendung von Nicht-SDK-Schnittstellen haben. Wenn Sie für ein Feature in Ihrer App keine Alternative zur Verwendung einer Benutzeroberfläche ohne SDK finden, sollten Sie eine neue öffentliche API anfordern.
Weitere Informationen zu den Änderungen in diesem Android-Release finden Sie unter Aktualisierungen der Einschränkungen für Nicht-SDK-Schnittstellen in Android 15. Weitere Informationen zu Nicht-SDK-Schnittstellen im Allgemeinen finden Sie unter Einschränkungen für Nicht-SDK-Schnittstellen.