Randloses Display manuell einrichten

Sie können die randlose Anzeige in Ihrer App aktivieren, indem Sie enableEdgeToEdge aufrufen. Das sollte für die meisten Apps ausreichen. In diesem Leitfaden wird beschrieben, wie Sie den Vollbildmodus aktivieren, wenn dies für Ihre App ohne enableEdgeToEdge erforderlich ist.

App im Vollbildmodus layouten

Verwenden Sie WindowCompat.setDecorFitsSystemWindows(window, false), um Ihre App hinter den Systemleisten zu platzieren, 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 Ihre App im Vollbildmodus ausgeführt wird, müssen die Farben der Systemleisten geändert werden, damit die darunter liegenden Inhalte sichtbar sind. Nachdem Ihre App diesen Schritt ausgeführt hat, übernimmt das System den gesamten visuellen Schutz der Benutzeroberfläche im Modus für die Gestennavigation und im Modus für die Tastennavigation.

• Modus für die Gestennavigation:Das System verwendet eine dynamische Farbanpassung, bei der die Inhalte der Systemleisten je nach dem dahinter liegenden Inhalt die Farbe ändern. Im folgenden Beispiel ändert sich der Griff in der Navigationsleiste in eine dunkle Farbe, wenn er sich über hellen Inhalten befindet, und in eine helle Farbe, wenn er sich über dunklen Inhalten befindet.

• Schaltflächenmodus:Das System wendet hinter den Systemleisten einen durchsichtigen Hintergrund (für API-Level 29 oder höher) oder eine transparente Systemleiste (für API-Level 28 oder niedriger) an.

• Farbe der Statusleiste:Hiermit wird die Farbe der Statusleiste festgelegt, z. B. für die Uhrzeit und Symbole.

Sie können die Datei themes.xml bearbeiten, um die Farbe der Navigationsleiste festzulegen und optional die Statusleiste transparent und die Farbe der Statusleiste dunkel zu gestalten.

<!-- 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 nach Möglichkeit die Supportbibliothek WindowInsetsControllerCompat. Sie können die WindowInsetsControllerCompat API anstelle von theme.xml verwenden, um die Inhaltsfarbe der Statusleiste zu steuern. Verwenden Sie dazu die Funktion setAppearanceLightNavigationBars() und geben Sie true ein, 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);