Änderungen beim Verhalten: Apps, die auf Android 15 oder höher ausgerichtet sind

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

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:

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.

Eine App, die auf Android 14 ausgerichtet ist und auf einem Android 15-Gerät nicht auf dem neuesten Stand ist.


Eine App, die auf Android 15 ausgerichtet ist und auf einem Gerät mit Android 15 läuft. Diese App verwendet hauptsächlich Material 3 Compose-Komponenten, die automatisch Einsätze anwenden. Die randlose Erzwingung von Android 15 wirkt sich nicht negativ auf diesen Bildschirm aus.

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 und R.attr#navigationBarColor wurden verworfen und wirken sich nicht auf die Bedienung über Gesten aus.
    • setNavigationBarContrastEnforced und R.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 und R.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 und R.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 und R.attr#statusBarColor wurden eingestellt und haben keine Auswirkungen auf Android 15.
    • setStatusBarContrastEnforced und R.attr#statusBarContrastEnforced wurden eingestellt, haben aber weiterhin Auswirkungen auf Android 15.
  • Display-Aussparung
    • layoutInDisplayCutoutMode der nicht unverankerten Fenster muss LAYOUT_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.

Eine App, die auf Android 14 ausgerichtet ist und auf einem Android 15-Gerät nicht auf dem neuesten Stand ist.
Eine auf Android 15 ausgerichtete App, die auf einem Gerät mit Android 15 auf dem neuesten Stand ist. Allerdings werden viele Elemente jetzt durch die Statusleiste, die 3-Schaltflächen-Navigationsleiste oder die Display-Aussparung verdeckt. Grund dafür sind die randlosen Einschränkungen von Android 15. Die verdeckte Benutzeroberfläche enthält die Material 2 TopAppBar, FAB und Listenelemente.
Eine App, die auf Android 15 ausgerichtet ist, auf einem Android 15-Gerät Edge-to-Edge-fähig ist und Einsätze anwendet, damit die Benutzeroberfläche nicht verdeckt wird.

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 oder DEFAULT anstelle von LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS verwendet. Wenn Ihre App beim Start abstürzt, kann dies an Ihrem Ladebildschirm liegen. Legen Sie window.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
  • 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 und NavigationBar, 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 und NavigationRail anzuwenden. Verwenden Sie ebenso den Parameter contentWindowInsets für Scaffold.
    • Wenn Ihre App Ansichten und Materialkomponenten (com.google.android.material) verwendet, verarbeiten die meisten auf Ansichten basierenden Materialkomponenten wie BottomNavigationView, BottomAppBar, NavigationRailView oder NavigationView Einsätze und erfordern keine zusätzliche Arbeit. Wenn Sie jedoch AppBarLayout verwenden, müssen Sie android: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 Sie clipToPadding="false" hinzu.
  • 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 oder WindowInsets.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:

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.

elegantTextHeight-Verhalten für Apps, die auf Android 14 (API-Level 34) und niedriger ausgerichtet sind.
elegantTextHeight Verhalten für Apps, die auf Android 15 ausgerichtet sind.

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.