Randloses Display manuell einrichten

Rufen Sie enableEdgeToEdge auf, um das Edge-to-Edge-Display in Ihrer App zu aktivieren. Dies sollte für die meisten Apps ausreichen. In diesem Leitfaden wird beschrieben, wie Sie Edge-to-Edge aktivieren, wenn Ihre App dies ohne enableEdgeToEdge tun muss.

App im Vollbildmodus darstellen

Verwende WindowCompat.setDecorFitsSystemWindows(window, false), um deine App hinter den Systemleisten anzuordnen, wie im folgenden Codebeispiel gezeigt:

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  WindowCompat.setDecorFitsSystemWindows(window, false)
}

@Override
public void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
}

Farbe der Systemleisten ändern

Wenn Sie in einem randlosen Layout arbeiten, muss Ihre App die Farben der Systemleisten ändern, damit der darunterliegende Inhalt sichtbar ist. Nachdem deine App diesen Schritt ausgeführt hat, übernimmt das System den gesamten visuellen Schutz der Benutzeroberfläche im Gestennavigationsmodus und im Schaltflächenmodus.

• Bedienung über Gesten:Das System wendet eine dynamische Farbanpassung an, bei der sich die Farbe der Inhalte der Systemleisten abhängig vom Inhalt dahinter ändert. Im folgenden Beispiel ändert sich der Ziehpunkt in der Navigationsleiste in eine dunkle Farbe, wenn er sich über hellem Inhalt befindet, und in eine helle Farbe, wenn er sich über dunklen Inhalten befindet.

• Schaltflächenmodus:Das System wendet ein durchsichtiges Gewebe hinter den Systemleisten (ab API-Level 29) oder eine transparente Systemleiste (API-Level 28 oder niedriger) an.

• Farbe des Inhalts der Statusleiste:Hiermit wird die Farbe des Inhalts der Statusleiste festgelegt, z. B. Uhrzeit und Symbole.

Sie können die Datei themes.xml bearbeiten, um die Farbe der Navigationsleiste festzulegen und optional die Farbe der Statusleiste und die Farbe des Inhalts der Statusleiste auf dunkel festzulegen.

<!-- values-v29/themes.xml -->
<style name="Theme.MyApp">
  <item name="android:navigationBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set to transparent if your app is drawing behind the status bar. -->
  <item name="android:statusBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set for a light status bar with dark content. -->
  <item name="android:windowLightStatusBar">
    true
  </item>
</style>

Sie können die WindowInsetsController API direkt verwenden. Wir empfehlen jedoch dringend, nach Möglichkeit die Supportbibliothek WindowInsetsControllerCompat zu verwenden. Sie können die WindowInsetsControllerCompat API anstelle von theme.xml verwenden, um die Inhaltsfarbe der Statusleiste festzulegen. Verwenden Sie dazu die Funktion setAppearanceLightNavigationBars() und übergeben Sie true, um die Vordergrundfarbe der Navigation in eine helle Farbe zu ändern, oder false, um zur Standardfarbe zurückzukehren.

val windowInsetsController =
      ViewCompat.getWindowInsetsController(window.decorView)

windowInsetsController?.isAppearanceLightNavigationBars = true

WindowInsetsControllerCompat windowInsetsController =
      ViewCompat.getWindowInsetsController(getWindow().getDecorView());
if (windowInsetsController == null) {
    return;
}

windowInsetsController.setAppearanceLightNavigationBars(true);