Cómo realizar pruebas con el emulador configurable
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Para ayudar a emular algunas de las configuraciones que se ven en los OEM, ciertos perfiles de hardware admiten la configurabilidad del entorno de ejecución.
Estas configuraciones se implementan con superposiciones de recursos del tiempo de ejecución (RRO) y se pueden administrar con el comando adb shell cmd overlay.
Usa los siguientes comandos para habilitar o inhabilitar un RRO:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Modifica la posición de la barra del sistema
De forma predeterminada, el emulador configurable tiene dos barras del sistema: una barra de estado en la parte superior de la pantalla y una barra de navegación en la parte inferior. Aunque muchos autos comparten este diseño, algunos no. Es de particular importancia que algunos automóviles tengan sus barras del sistema en los lados horizontales de la pantalla y no en los verticales, lo que puede deshacer las suposiciones que se hacen cuando se desarrollan apps para factores de forma de dispositivos móviles. Consulta Barras del sistema, modo envolvente y renderización de borde a borde para obtener más detalles y orientación técnica.
Se pueden usar los siguientes RRO para modificar las barras del sistema:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Cómo emular cortes de pantalla
Algunos automóviles tienen pantallas con cortes de pantalla muy diferentes a los que se ven en los dispositivos móviles. En lugar de las muescas o los cortes de la cámara estenopeica, algunos automóviles con el SO Android Automotive tienen pantallas curvas que hacen que la pantalla no sea rectangular. Consulta Cómo adaptar a pantallas con formas irregulares para obtener más detalles y orientación técnica.
Se pueden usar los siguientes RRO para emular recortes de pantalla:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Parámetros de configuración de prueba recomendados
Dado que la cantidad total de parámetros de configuración que se pueden crear combinando estos RRO es bastante grande, te recomendamos que pruebes tu app con las siguientes combinaciones de perfiles de hardware y RRO, que son similares a algunos vehículos que circulan actualmente.
- Automotive (1080p horizontal) con
com.android.systemui.rro.left o com.android.systemui.rro.right
- Ultra gran angular para la industria automotriz con
com.android.systemui.rro.left y com.android.internal.emulation.automotive_ultrawide_cutout
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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`"]]
