Testar usando o emulador configurável
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para ajudar a emular algumas das configurações encontradas em OEMs, alguns perfis
de hardware oferecem suporte à
configurabilidade do ambiente de execução.
Essas configurações são implementadas usando Overlays de
recurso de execução (RROs, na sigla em inglês)
e podem ser gerenciadas usando o comando adb shell cmd overlay.
Use os comandos abaixo para ativar ou desativar um RRO:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Modificar a posição da barra do sistema
Por padrão, o emulador configurável tem duas barras de sistema: uma barra de status na
parte de cima da tela e uma barra de navegação na parte de baixo. Embora muitos
carros compartilhem esse layout, alguns não. Alguns carros têm
as barras de sistema nas laterais horizontais da tela e não nas verticais, o que pode violar as suposições feitas ao desenvolver apps para fatores de forma
de dispositivos móveis. Consulte Barra de sistema, modo imersivo e
renderização de ponta a ponta
para mais detalhes e orientações técnicas.
Os seguintes RROs podem ser usados para modificar as barras do sistema:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Emular cortes de tela
Alguns carros têm telas com cortes muito diferentes dos encontrados em dispositivos móveis. Em vez dos entalhes ou recortes da câmera
com orifício, alguns veículos com Android Automotive OS têm telas curvas que
tornam a imagem não retangular. Consulte Adaptar para telas de formato irregular
para mais detalhes e orientações técnicas.
Os RROs a seguir podem ser usados para emular recortes de tela:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Configurações de teste recomendadas
Como o número total de configurações que podem ser criadas combinando esses
RROs é bastante grande, recomendamos testar seu app usando as seguintes
combinações de perfis de hardware
e RROs, que são semelhantes a alguns veículos na estrada hoje.
- Automotive (paisagem 1080p) com
com.android.systemui.rro.left
ou com.android.systemui.rro.right
- Ultrawide automotivo com
com.android.systemui.rro.left e
com.android.internal.emulation.automotive_ultrawide_cutout
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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`"]]
