Einrichtungsanleitung für die App-Kompatibilität mit großen Displays

Auf der Seite finden Sie eine umfassende Einrichtungsanleitung und einen Index für Konfigurations-Overlays für die App-Kompatibilität auf Android-Geräten mit großem Display.

Display

In diesem Abschnitt werden alle Konfigurationseinstellungen aufgeführt, die sich auf die Konfiguration auf Anzeigenebene auswirken.

Name Standort Typ Standard
ignoreOrientationRequest display_settings.xml config false
true für große Bildschirme (>= 600 dp)
Beschreibung
Ermöglicht die kostenlose Drehung von Aktivitäten mit fester Ausrichtung auf dem angegebenen Display.
Beispiel: 
          <display-settings>
              <config identifier="0" />
              <display
                  name="<display's uniqueId>"
                  ignoreOrientationRequest="true"/>
          </display-settings>

Anwendungsfall oder Kontext
Das Display ignoriert die angeforderte Ausrichtung aller Apps und die App wird im Letterbox-Format angezeigt.
Wird auf allen Geräten mit großem Display und Android Automotive OS verwendet. Dies ist die Standardeinstellung für alle Geräte mit großem Display und smallestScreenWidthDp >= 600dp in Android 16 und höher.
config_letterboxIsDisplayRotationImmersiveAppCompatPolicyEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Aktiviert die Richtlinie zur Rotationskompatibilität für immersive Apps, die die automatische Drehung in eine nicht optimale Bildschirmausrichtung im Vollbildmodus verhindert. Das ist erforderlich, weil immersive Apps wie Spiele oft nicht für alle Ausrichtungen optimiert sind und bei einer Drehung eine schlechte Nutzerfreundlichkeit aufweisen können. Außerdem sind für einige Spiele Sensoren erforderlich. Nutzer können solche Drehungen daher versehentlich auslösen, wenn die automatische Drehung aktiviert ist.
Gilt nur, wenn ignoreOrientationRequest aktiviert ist.

Anwendungsfall oder Kontext
Sperrt die Drehung für immersive Apps.

Seitenverhältnis

In diesem Abschnitt werden alle Konfigurationseinstellungen aufgeführt, die sich auf die Konfiguration des Aktivitätsfensters für das Seitenverhältnis auswirken.

Name Standort Typ Standard
config_fixedOrientationLetterboxAspectRatio frameworks/base/core/res/res/values/config.xml Float 0.0
Beschreibung
Konfiguriert das Seitenverhältnis des Letterboxings für eine feste Ausrichtung. Werte, die kleiner oder gleich 1.0 sind, werden ignoriert.

Anwendungsfall oder Kontext
Konfiguriert das Standard-Seitenverhältnis des Geräts, das für die meisten Apps mit Letterbox-Formatierung geeignet ist. In der Regel näher an einem quadratischen Seitenverhältnis.
config_letterboxIsSplitScreenAspectRatioForUnresizableAppsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob das Split-Screen-Seitenverhältnis als Standardseitenverhältnis für Apps verwendet werden soll, deren Größe nicht geändert werden kann.

Anwendungsfall oder Kontext
Die meisten Apps, deren Größe nicht geändert werden kann, erwarten ein Layout für Smartphones im Hochformat.
config_letterboxIsDisplayAspectRatioForFixedOrientationLetterboxEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob das Display-Seitenverhältnis als Standardseitenverhältnis für alle Apps mit Letterboxing verwendet werden soll.

Anwendungsfall oder Kontext
Eine Konfiguration, mit der das Display-Seitenverhältnis programmatisch verwendet werden kann, anstatt einen Gleitkommawert zu konfigurieren.

Kamera

In diesem Abschnitt werden alle Konfigurationseinstellungen aufgeführt, die sich auf Apps auswirken, wenn onCameraOpened zurückgegeben wird. Diese Einstellungen können sich auf die Anzeige, die Aktivität und die Kamerakonfiguration auswirken.

Name Standort Typ Standard
config_isWindowManagerCameraCompatTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Ermöglicht die Behandlung von Problemen mit der Kamerakompatibilität, die durch eine Orientierungsabweichung zwischen Kamerabuffern und einem App-Fenster verursacht werden.
Dazu gehört das Erzwingen der Drehung von Aktivitäten mit fester Ausrichtung, die im Vollbildmodus mit der Kamera verbunden sind, und das Anzeigen eines Tooltips im Splitscreen-Modus.
Die Behandlung zum Erzwingen der Drehung kann durch die app-spezifische Überschreibung deaktiviert werden: OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION.

Anwendungsfall oder Kontext
Behebt gedrehte Kameravorschaubilder, indem das Display erzwungen wird, sich an der von der App angeforderten Ausrichtung zu orientieren.
config_isWindowManagerCameraCompatSplitScreenAspectRatioEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob für eine Aktivität das Split-Screen-Seitenverhältnis verwendet wird, wenn die Behandlung der Kamerakompatibilität aktiviert ist und die Aktivität im Vollbildmodus mit der Kamera verbunden ist.

Anwendungsfall oder Kontext
Behebt verzerrte Kameravorschaubilder, indem die Aktivität auf ein Seitenverhältnis im Querformat zugeschnitten wird.
Wird in der Regel zusammen mit der aktivierten Behandlung „Rotation erzwingen“ (config_isWindowManagerCameraCompatTreatmentEnabled und camera.enable_landscape_to_portrait) auf Geräten im Querformat verwendet, um Probleme mit der Kompatibilität von gestreckten Kameras zu beheben, indem für die Aktivität ein Hochformat-Seitenverhältnis simuliert wird.
camera.enable_landscape_to_portrait System property Bool false
Beschreibung
Schränkt die OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT-Testgruppe ein.
Erzwingt, dass die Kameraausgabe auf Kameras mit natürlicher Ausrichtung im Querformat zugeschnitten und um 90 Grad gedreht wird, um die natürliche Ausrichtung im Hochformat zu simulieren. Die gemeldete Ausrichtung des Kamerasensors ist für alle Landschaftskameras auf dem Gerät „Hochformat“. Viele Apps können damit nicht umgehen und zeigen die Bilder dann gestreckt an.

Anwendungsfall oder Kontext
Aktiviert die Funktion zum Drehen und Zuschneiden im Kamera-HAL. Weitere Informationen zur Bearbeitung finden Sie unter Drehen, zuschneiden, skalieren.
Fügen Sie Ihrer mk-Datei zur Build-Zeit Folgendes hinzu: PRODUCT_PROPERTY_OVERRIDES += camera.enable_landscape_to_portrait=true
Für diese Behandlung muss das Gerät SCALER_ROTATE_AND_CROP im HAL unterstützen. Weitere Informationen finden Sie unter CameraCharacteristics#SCALER_AVAILABLE_ROTATE_AND_CROP_MODES.
Informationen zur HAL-spezifischen Implementierung für SCALER_ROTATE_AND_CROP finden Sie unter metadata_definitions.xml.
config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool true
Beschreibung
Gibt an, ob die Behandlung der Kamerakompatibilität aktiviert ist, bei der die angeforderte Ausrichtung einer App simuliert wird. Die Behandlung soll Probleme beheben, die durch eine Ausrichtungsabweichung zwischen dem Kamerabuffer und dem App-Fenster verursacht werden. Dazu gehören das Letterboxing von Aktivitäten mit fester Ausrichtung, die mit der Kamera verbunden sind, das Zuschneiden des Kamerabuffers (Drehen und Zuschneiden) und das Sandboxing der Displaydrehung, um der erwarteten Ausrichtung der App zu entsprechen.

Anwendungsfall oder Kontext
Simulieren der angeforderten Ausrichtung für Kameraaktivitäten in:
  • Freiform-Fenster-Modus
  • Anfrage für eine feste Ausrichtung, die nicht im Modus locked oder nosensor erfolgt

In Android 17 und höher wird mit dieser Einstellung die Force-Rotate-Behandlung von config_isWindowManagerCameraCompatTreatmentEnabled deaktiviert. Außerdem werden die Richtlinien für die Sandbox-Umgebung für die Displaydrehung, das Letterboxing und das Drehen und Zuschneiden der Kamera für Kamera-Apps mit fester Ausrichtung vereinheitlicht.
config_isCameraCompatSimReqOrientationLandscapeTreatmentEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Gibt an, ob die Behandlung der Kamerakompatibilität, die die angeforderte Ausrichtung einer App simuliert, für Kameras im Querformat aktiviert ist. Mit der Behandlung sollen Probleme behoben werden, die dadurch entstehen, dass Apps Porträtkamerasensoren fest codieren. Die Behandlung umfasst das Letterboxing von Aktivitäten mit fester Ausrichtung, die mit der Kamera verbunden sind, das Zuschneiden des Kamerabuffers (Drehen und Zuschneiden), das Ausrichten des Sensors auf das Hochformat und das Sandboxing der Displaydrehung, um der erwarteten Ausrichtung der App zu entsprechen.

Anwendungsfall oder Kontext
Unter Android 17 und höher entspricht diese Behandlung der Behandlung „Angeforderte Ausrichtung simulieren“ für config_isCameraCompatSimulateRequestedOrientationTreatmentEnabled, jedoch für Geräte mit Kameras im Querformat.

Hintergrund und Benutzeroberfläche

In diesem Abschnitt werden alle Konfigurationseinstellungen aufgeführt, die auf die Oberfläche der Letterbox-Ebene für die Anpassung der Benutzeroberfläche oder auf Aktivitätsebene angewendet werden.

Name Standort Typ Standard
config_letterboxActivityCornersRadius frameworks/base/core/res/res/values/config.xml Integer 0
Beschreibung
Konfiguriert den Eckenradius für eine Aktivität, die im Letterbox-Modus dargestellt wird. Werte unter 0 ermöglichen abgerundete Ecken mit einem Radius, der dem Mindestwert der Radien der unteren Ecken des Geräts entspricht. Mit dem Standardwert 0 wird die Logik für abgerundete Ecken in AppCompatLetterboxPolicy deaktiviert.

Anwendungsfall oder Kontext
Wird in der Regel so konfiguriert, dass sie den abgerundeten Ecken des physischen Geräts entspricht.
config_letterboxIsEnabledForTranslucentActivities frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob für bestimmte Verhaltensweisen für durchscheinende Aktivitäten Letterboxing aktiviert ist.

Anwendungsfall oder Kontext
Ermöglicht, dass durchscheinende Aktivitäten oder Modale in Letterbox-Format dargestellt und innerhalb der Letterbox-Aktivitätskonfiguration eingeschränkt werden. Die Richtlinie gilt in TransparentPolicy.
config_isCompatFakeFocusEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob das Senden von gefälschten Fokus-Kompatibilitätsinformationen für Aktivitäten, die im Splitscreen-Modus fortgesetzt werden, aktiviert ist.
Dies ist erforderlich, da einige Game-Engines warten, bis sie den Fokus erhalten, bevor sie die Inhalte der App rendern. Dies ist in Multi-Window-Modi nicht standardmäßig der Fall.

Anwendungsfall oder Kontext
Ein altes Flag zum Anwenden von Kompatibilitätsbehandlungen für Unity-Game-Engines für Apps, die nach dem Aufrufen des Splitscreen-Modus schwarz werden und erst gerendert werden, nachdem der Nutzer auf die App tippt und sie fokussiert.
config_letterboxBackgroundType frameworks/base/core/res/res/values/config.xml Integer 0
Beschreibung
Konfiguriert die Darstellung der Ecken des Letterbox-Hintergrunds:
  • 0: Einfarbiger Hintergrund mit der in R.color.config_letterboxBackgroundColor angegebenen Farbe.
  • 1: Farbe, die in R.attr.colorBackground für die Letterbox-Anwendung angegeben ist.
  • 2: Die in R.attr.colorBackgroundFloating angegebene Farbe für die Letterbox-Anwendung.
  • 3: Hintergrund mit gedämpfter Unschärfe oder dunklem Schleier. Mindestens einer der folgenden Parameter muss größer als 0 sein: config_letterboxBackgroundWallpaperBlurRadius oder config_letterboxBackgroundWallpaperDarkScrimAlpha. Wenn dies nicht der Fall ist oder wenn ein Unschärferadius angegeben wird, die Unschärfe aber vom Gerät nicht unterstützt wird und diese Option ausgewählt ist, wird standardmäßig Option 0 verwendet. Wenn der angegebene Wert außerhalb dieses Bereichs liegt, wird Option 0 angenommen.


Anwendungsfall oder Kontext
Diese Funktion wird aufgrund bestehender Leistungsprobleme nicht eingeführt. OEMs können ihre eigene Implementierung dieser Funktion erstellen, aber AOSP behebt keine Fehler.
config_letterboxBackgroundColor frameworks/base/core/res/res/values/config.xml Color @color/system_neutral1_1000
Beschreibung
Konfiguriert die Farbe des Letterbox-Hintergrunds, wenn eine der folgenden Bedingungen true ist:
  • Die Option 0 ist für R.integer.config_letterboxBackgroundType ausgewählt.
  • Die Option 1 ist für R.integer.config_letterboxBackgroundType ausgewählt und R.attr.colorBackground ist für die App nicht angegeben.
  • Die Option 2 ist für R.integer.config_letterboxBackgroundType ausgewählt und R.attr.colorBackgroundFloating ist für die App nicht angegeben.
  • Die Option 3 ist für R.integer.config_letterboxBackgroundType ausgewählt und es wird eine Unschärfe angefordert, die auf dem Gerät nicht unterstützt wird. Alternativ wurden weder der Alphawert für den dunklen Hintergrund noch der Unschärferadius angegeben.


Anwendungsfall oder Kontext
Diese Funktion wird aufgrund bestehender Leistungsprobleme nicht eingeführt. OEMs können ihre eigene Implementierung dieser Funktion erstellen, aber AOSP behebt keine Fehler.
config_letterboxBackgroundWallpaperBlurRadius frameworks/base/core/res/res/values/config.xml Dimen 38dp
Beschreibung
Konfiguriert den Unschärferadius für Option 3 in R.integer.config_letterboxBackgroundType. Werte unter 0 werden ignoriert und 0 wird verwendet.

Anwendungsfall oder Kontext
Diese Funktion wird aufgrund bestehender Leistungsprobleme nicht eingeführt. OEMs können ihre eigene Implementierung dieser Funktion erstellen, aber AOSP behebt keine Fehler.
config_letterboxBackgroundWallpaperDarkScrimAlpha frameworks/base/core/res/res/values/config.xml Float 0.54
Beschreibung
Konfiguriert den Alphawert eines schwarzen, durchscheinenden Scrim, der über dem Letterbox-Hintergrund des Hintergrundbilds angezeigt wird, wenn für R.integer.config_letterboxBackgroundType die Option 3 ausgewählt ist. Werte unter 0 oder größer oder gleich 1 werden ignoriert und stattdessen wird 0.0 (transparent) verwendet.

Anwendungsfall oder Kontext
Diese Funktion wurde aufgrund bestehender Leistungsprobleme nicht eingeführt. OEMs können ihre eigene Implementierung dieser Funktion erstellen, aber AOSP behebt keine Fehler.
config_enableSelfKillRecoveryBetweenInternalDisplays frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Wenn true, werden Displaywechsel zwischen internen Displays nicht von der Logik zur Wiederherstellung nach dem automatischen Beenden ausgenommen.

Anwendungsfall oder Kontext
In Android 17 und höher wird der Prozess zur Wiederherstellung nach dem automatischen Beenden nur für Displaywechsel mit externen Monitoren aktiviert. Das Verfahren funktioniert aber auch auf Falt-Smartphones mit unterschiedlichen Pixeldichten auf dem Innen- und Außendisplay. Diese Konfiguration aktiviert den Prozess für diese Geräte.

Erreichbarkeit und Positionierung

In diesem Abschnitt werden alle Konfigurationseinstellungen aufgeführt, die auf die Konfiguration des Aktivitätsfensters für Bedienungshilfen angewendet werden.

Name Standort Typ Standard
config_letterboxIsHorizontalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die horizontale Neupositionierung der Erreichbarkeit für Apps mit Letterboxing im Vollbild-Fenstermodus aktiviert ist.

Anwendungsfall oder Kontext
Eine im Hochformat ausgerichtete App wird zur besseren Erreichbarkeit nach links oder rechts verschoben.
config_letterboxHorizontalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.5
Beschreibung
Konfiguriert die horizontale Position des Mittelpunkts des Letterbox-App-Fensters.
0 entspricht der linken Seite des Bildschirms und 1 der rechten Seite.
Wenn der angegebene Wert kleiner als 0 oder größer als 1 ist, wird er ignoriert. Bei anderen als Buch-Positionen wird die zentrale Position (0.5) verwendet. Für die Buchposition wird die linke Position (0.0) verwendet.

Anwendungsfall oder Kontext
Standardmäßig wird die Mitte für eine im Letterbox-Format dargestellte App im Hochformat verwendet.
config_letterboxIsVerticalReachabilityEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die vertikale Neupositionierung für Apps mit Letterbox im Vollbildfenstermodus aktiviert ist.

Anwendungsfall oder Kontext
Eine Querformat-App wird zur besseren Zugänglichkeit oben oder unten neu positioniert.
config_letterboxVerticalPositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Beschreibung
Konfiguriert die vertikale Position der Mitte des Letterbox-App-Fensters.
Der Wert 0 entspricht der Oberseite des Bildschirms und 1 der Unterseite.
Wenn der angegebene Wert kleiner als 0 oder größer als 1 ist, wird er ignoriert. Für den Modus ohne Tischaufstellung wird die zentrale Position (0.5) verwendet. Für die Tischposition wird die obere Position (0.0) verwendet.

Anwendungsfall oder Kontext
Auf großen Bildschirmen für eine im Letterbox-Format dargestellte App im Querformat in der Mitte konfiguriert.
config_letterboxIsAutomaticReachabilityInBookModeEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die automatische horizontale Positionierung der Buchhaltung für Apps mit Letterbox im Vollbild-Fenstermodus aktiviert ist.

Anwendungsfall oder Kontext
Ermöglicht es einer App mit Letterbox im Hochformat, sich zwischen links und rechts zu bewegen, wenn sich ein faltbares Gerät im Buchhaltungsmodus befindet.
config_letterboxBookModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Beschreibung
Konfiguriert die horizontale Position des Mittelpunkts des Letterbox-App-Fensters im Buchmodus.
0 entspricht der linken Seite des Bildschirms und 1 der rechten Seite. Wenn der angegebene Wert kleiner als 0 oder größer als 1 ist, wird er ignoriert und die linke Position (0.0) verwendet.

Anwendungsfall oder Kontext
Ein Multiplikator für die Verschiebung der Position der App, wenn sie im Buchmodus neu positioniert wird.
config_letterboxDefaultPositionForBookModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Beschreibung
Konfiguriert die standardmäßige horizontale Position des Letterbox-App-Fensters, wenn die Erreichbarkeit aktiviert ist und eine App im Querformat und im Buchmodus im Vollbildmodus angezeigt wird. Wenn die Erreichbarkeit aktiviert ist, kann sich die Position zwischen links, Mitte und rechts ändern:
  • Option 0 – Links
  • Option 1 – Mitte
  • Option 2 – rechts
Wenn der angegebene Wert außerhalb dieses Bereichs liegt, wird Option 0 (links) angenommen.

Anwendungsfall oder Kontext
Die Standardposition, an der die App im Buchmodus platziert wird.
config_letterboxTabletopModePositionMultiplier frameworks/base/core/res/res/values/config.xml Float 0.0
Beschreibung
Konfiguriert die vertikale Position der Mitte des Letterbox-App-Fensters im Tischmodus.
Der Wert 0 entspricht der Oberseite des Bildschirms und 1 der Unterseite. Wenn der angegebene Wert kleiner als 0 oder größer als 1 ist, wird er ignoriert und die oberste Position 0.0 verwendet.

Anwendungsfall oder Kontext
Ein Multiplikator dafür, wie stark sich die Position der App auf einem faltbaren Gerät im Tischmodus ändert.
config_letterboxDefaultPositionForTabletopModeReachability frameworks/base/core/res/res/values/config.xml Integer 0
Beschreibung
Konfiguriert die vertikale Standardposition des Letterbox-App-Fensters, wenn die Einhandbedienung aktiviert ist und eine App im Vollbildmodus im Hochformat und im Tablet-Modus ausgeführt wird. Wenn die Erreichbarkeit aktiviert ist, kann sich die Position zwischen oben, Mitte und unten ändern. Diese Konfiguration definiert die Standardkonfiguration:
  • Option 0 – Oben
  • Option 1 – Mitte
  • Option 2 – Unten
Wenn der angegebene Wert außerhalb dieses Bereichs liegt, wird Option 0 (oben) angenommen.

Anwendungsfall oder Kontext
Die Standardposition, an der die App im Tischmodus platziert wird.

Einstellungen

In diesem Abschnitt werden alle Konfigurationseinstellungen zum Anpassen und Aktivieren der Einstellungen für das Seitenverhältnis in Einstellungen > Apps > Seitenverhältnis aufgeführt.

Name Standort Typ Standard
config_appCompatUserAppAspectRatioSettingsIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die Einstellungen zum Überschreiben des Seitenverhältnisses für einzelne Apps aktiviert sind.

Anwendungsfall oder Kontext
Aktiviert die Funktion Einstellungen für das Seitenverhältnis unter Einstellungen > Apps > Seitenverhältnis.
config_appCompatUserAppAspectRatioFullscreenIsEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die Option zum Überschreiben des Vollbildmodus pro App in den Einstellungen für das Seitenverhältnis des Nutzers aktiviert ist.

Anwendungsfall oder Kontext
Aktiviert die Option Vollbild in den Einstellungen für das Seitenverhältnis des Nutzers.
Bei dieser Einstellung werden die Einschränkungen für die Größe, das Seitenverhältnis und die Ausrichtung einer App ignoriert.
config_userAspectRatioOverrideEntries packages/apps/Settings/res/values/config.xml string-array Alle Optionen sind standardmäßig aktiviert.
Beschreibung
Konfiguriert den Bildschirm mit den Einstellungen für das Seitenverhältnis der App und die Optionen zum Überschreiben des Seitenverhältnisses durch den Nutzer. Muss dieselbe Länge und Reihenfolge wie config_userAspectRatioOverrideValues haben.
Bei Änderungen muss auch die Logik für das Sichern und Wiederherstellen aktualisiert werden, um den nächstgelegenen Wert in UserAspectRatioBackupManager.java auszuwählen.

Anwendungsfall oder Kontext
Zuweisungen für die Strings, die in den Einstellungen angezeigt werden.
config_userAspectRatioOverrideValues packages/apps/Settings/res/values/config.xml integer-array Standardmäßig werden alle AOSP-Strings verwendet.
Beschreibung
Konfiguriert den Bildschirm mit den Einstellungen für das Seitenverhältnis der App und die Optionen zum Überschreiben des Seitenverhältnisses durch den Nutzer. Muss dieselbe Länge und Reihenfolge wie config_userAspectRatioOverrideEntries haben. Die Werte müssen PackageManager.UserMinAspectRatio entsprechen.
Wenn sich die Werte ändern, aktualisieren Sie auch die Logik für die Sicherung und Wiederherstellung, um den nächstgelegenen Wert in UserAspectRatioBackupManager.java auszuwählen.

Anwendungsfall oder Kontext
Zuordnung der Optionen zum Backend PackageManager.UserMinAspectRatio:
  • Standardeinstellung der App – 0
  • Splitscreen – 1
  • Seitenverhältnis des Displays: 2
  • 4:3 – 3
  • 16:9 – 4
  • 3:2 – 5
  • Vollbild – 6
Statische Drawables mit hellem Design packages/apps/Settings/res/drawable/ic_app_aspect_ratio_<option>.xml vector Assets im Querformat für faltbare Geräte
Beschreibung
Konfiguriert die verfügbaren Drawables:


Anwendungsfall oder Kontext
Statische Bilder mit hellem Design unter jeder Option in Einstellungen > App-Informationen > Seitenverhältnis.
Statische Drawables für das dunkle Design packages/apps/Settings/res/drawable-night/ic_app_aspect_ratio_<option>.xml vector Assets im Querformat für faltbare Geräte
Beschreibung
Konfiguriert die verfügbaren Drawables:


Anwendungsfall oder Kontext
Statische Bilder mit dunklem Design unter jeder Option in Einstellungen > App-Informationen > Seitenverhältnis.
Dynamische Drawables
user_aspect_ratio_education.json		 packages/apps/Settings/res/raw/user_aspect_ratio_education.json JSON Dynamisches Asset im Querformat für faltbare Geräte
Beschreibung
Konfiguriert eine Lottie-Illustration in UserAspectRatioAppsPageProvider.

Anwendungsfall oder Kontext
Eine Animation unter der App-Liste: Einstellungen > Apps > Seitenverhältnis.

Bildung

In diesem Abschnitt werden alle Konfigurationseinstellungen für die Information von Nutzern über Funktionen zur App-Kompatibilität aufgeführt.

Name Standort Typ Standard
config_letterboxIsEducationEnabled frameworks/base/core/res/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob die Letterbox-Schulung für Letterbox-Vollbild-Apps aktiviert ist.

Anwendungsfall oder Kontext
Abbildung 1 zeigt einen Anwendungsfall für die Letterbox-Schulung für Vollbild-Apps.
config_letterboxIsRestartDialogEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob das erweiterte Neustartdialogfeld aktiviert ist.

Anwendungsfall oder Kontext
Einen Anwendungsfall für das erweiterte Neustartdialogfeld finden Sie in Abbildung 2.
config_letterboxIsReachabilityEducationEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool false
Beschreibung
Konfiguriert, ob zusätzliche Informationen zur Erreichbarkeit aktiviert sind.

Anwendungsfall oder Kontext
Einen Anwendungsfall für Informationen zur Erreichbarkeit finden Sie in Abbildung 3.
config_isSizeCompatRestartButtonEnabled frameworks/base/libs/WindowManager/Shell/res/values/config.xml Bool true
Beschreibung
Konfiguriert, ob die Schaltfläche zum Neustarten der Größenkompatibilität aktiviert ist.

Anwendungsfall oder Kontext
Eine Schaltfläche zum Neustarten der Konfiguration für Apps, deren Größe nicht geändert werden kann, nachdem sich die Fenstergröße geändert hat, z. B. beim Wechsel in den Splitscreen-Modus oder beim Drehen des Displays.
Ein Anwendungsbeispiel für die Schaltfläche „Größenkompatibilität neu starten“ finden Sie in Abbildung 4.
config_letterboxRestartButtonHideTolerance frameworks/base/libs/WindowManager/Shell/res/values/config.xml Integer 100
Beschreibung
Konfiguriert die Mindesttoleranz des Prozentsatzes der Aktivitätsgrenzen innerhalb der zugehörigen Aufgabe, um die Schaltfläche zum Neustarten der Größenkompatibilität auszublenden. Werte unter 0 oder über 100 werden ignoriert.
100 ist der Standardwert. Die Aktivität muss genau in die Aufgabe passen, damit die Schaltfläche zum Neustarten der Größenkompatibilität ausgeblendet werden kann. Der Wert 0 bedeutet, dass die Schaltfläche zum Neustarten aufgrund der Größe immer ausgeblendet ist.

Anwendungsfall oder Kontext
Wird auf Geräten verwendet, die fast quadratisch sind, um die Schaltfläche zum Neustarten auszublenden, wenn nicht anpassbare Apps vom Nutzer gedreht werden, aber ein Neustart der App die Benutzeroberfläche nicht wesentlich verbessert.

Die folgenden Bilder zeigen Anwendungsfälle für das Bildungs-Overlay:

Letterbox-Format für Lern-Apps im Vollbildmodus

Abbildung 1. Letterbox-Format für Lern-Apps im Vollbildmodus

Beispiel für ein erweitertes Neustartdialogfeld

Abbildung 2: Erweitertes Dialogfeld für Neustart

Ein Beispiel für die Erreichbarkeitsinformationen.

Abbildung 3: Informationen zur Erreichbarkeit.

Beispiel für den Neustart-Button für die Größenkompatibilität

Abbildung 4: Schaltfläche zum Neustarten der Größenkompatibilität