Mit dem konfigurierbaren Emulator testen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Um einige der bei OEMs verwendeten Konfigurationen zu emulieren, unterstützen bestimmte Hardwareprofile die Konfiguration zur Laufzeit.
Diese Konfigurationen werden mithilfe von Runtime Resource Overlays (RROs) implementiert und können mit dem Befehl adb shell cmd overlay verwaltet werden.
Mit den folgenden Befehlen können Sie eine RRO aktivieren oder deaktivieren:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Position der Systemleiste ändern
Der konfigurierbare Emulator hat standardmäßig zwei Systemleisten: eine Statusleiste oben auf dem Bildschirm und eine Navigationsleiste unten auf dem Bildschirm. Viele Autos haben dieses Layout, einige jedoch nicht. Besonders bemerkenswert ist, dass einige Autos ihre Systemleisten an den horizontalen Seiten des Bildschirms und nicht an den vertikalen Seiten haben. Dies kann Annahmen bei der Entwicklung von Apps für mobile Formfaktoren infrage stellen. Weitere Informationen und technische Hinweise finden Sie unter Systemleisten, immersiver Modus und randloses Rendering.
Mit den folgenden RROs können Sie die Systemleisten ändern:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Display-Aussparungen emulieren
Einige Autos haben Displays mit Aussparungen, die sich stark von denen auf Mobilgeräten unterscheiden. Anstatt der Kerben oder Lochkameras haben einige Fahrzeuge mit Android Automotive OS gekrümmte Bildschirme, die nicht rechteckig sind. Weitere Informationen und technische Hinweise finden Sie unter An unregelmäßig geformte Displays anpassen.
Die folgenden RROs können verwendet werden, um Displayausschnitte zu emulieren:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Empfohlene Testkonfigurationen
Da die Gesamtzahl der Konfigurationen, die durch die Kombination dieser RROs erstellt werden können, recht groß ist, empfehlen wir Ihnen, Ihre App mit den folgenden Kombinationen von Hardwareprofilen und RROs zu testen, die einigen Fahrzeugen ähneln, die heute auf der Straße unterwegs sind.
- Automotive (1080p, Querformat) mit
com.android.systemui.rro.left oder com.android.systemui.rro.right
- Automotive Ultrawide mit
com.android.systemui.rro.left und com.android.internal.emulation.automotive_ultrawide_cutout
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# Test using the configurable emulator\n\nTo help emulate some of the configurations seen across OEMs, certain [hardware\nprofiles](/training/cars/testing/emulator#bundled-profiles) support runtime\nconfigurability.\n\nThese configurations are implemented using [Runtime Resource\nOverlays](https://source.android.com/docs/core/runtime/rros) (RROs)\nand can be managed using the `adb shell cmd overlay` command.\n\nUse the following commands to enable or disable a RRO: \n\n adb shell cmd overlay enable \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e\n adb shell cmd overlay disable \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e\n\nModify system bar position\n--------------------------\n\nBy default, the configurable emulator has two system bars -- a status bar on the\ntop of the screen and a navigation bar at the bottom of the screen. Though many\ncars share this layout, some don't. Of particular note is that some cars have\ntheir system bar(s) on the horizontal sides of the screen and not the vertical\nsides, which may break assumptions made when developing apps for mobile form\nfactors. See [System bars, immersive mode, and\nedge-to-edge rendering](/training/cars/parked/automotive-os#bars-immersive-edge)\nfor more details and technical guidance.\n\nThe following RROs can be used to modify the system bars:\n\n- `com.android.systemui.rro.bottom`\n- `com.android.systemui.rro.bottom.rounded`\n- `com.android.systemui.rro.left`\n- `com.android.systemui.rro.right`\n\nEmulate display cutouts\n-----------------------\n\nSome cars have screens with display cutouts that are very different when\ncompared to those seen on mobile devices. Instead of the notches or pinhole\ncamera cutouts, some Android Automotive OS vehicles have curved screens that\nmake the screen non-rectangular. See [Adapt to irregularly shaped displays](/training/cars/parked/automotive-os#irregular-displays)\nfor more details and technical guidance.\n\nThe following RROs can be used to emulate display cutouts:\n\n- `com.android.internal.display.cutout.emulation.top_and_right`\n- `com.android.internal.display.cutout.emulation.free_form`\n- `com.android.internal.emulation.automotive_ultrawide_cutout`\n\nRecommended testing configurations\n----------------------------------\n\nSince the total number of configurations that can be created by combining these\nRROs is quite large, we recommend testing your app using the following\ncombinations of [hardware profiles](/training/cars/testing/emulator#bundled-profiles)\nand RROs, which are similar to some vehicles on the road today.\n\n- *Automotive (1080p landscape)* with `com.android.systemui.rro.left` or `com.android.systemui.rro.right`\n- *Automotive Ultrawide* with `com.android.systemui.rro.left` and `com.android.internal.emulation.automotive_ultrawide_cutout`"]]
