Esegui il test utilizzando l'emulatore configurabile
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Per contribuire a emulare alcune delle configurazioni riscontrate negli OEM, alcuni profili hardware supportano la configurabilità di runtime.
Queste configurazioni vengono implementate utilizzando gli overlay delle risorse di runtime (RRO) e possono essere gestite utilizzando il comando adb shell cmd overlay.
Utilizza i seguenti comandi per attivare o disattivare un RRO:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Modificare la posizione della barra di sistema
Per impostazione predefinita, l'emulatore configurabile ha due barre di sistema: una barra di stato nella parte superiore dello schermo e una barra di navigazione nella parte inferiore dello schermo. Sebbene molte auto condividano questo layout, alcune no. È particolarmente importante notare che alcune auto hanno le barre di sistema sui lati orizzontali dello schermo e non su quelli verticali, il che potrebbe violare le ipotesi fatte durante lo sviluppo di app per fattori di forma mobile. Per ulteriori dettagli e indicazioni tecniche, consulta Barre di sistema, modalità immersiva e rendering edge-to-edge.
Per modificare le barre di sistema, puoi utilizzare i seguenti RRO:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Emulare i ritagli del display
Alcune auto hanno schermi con ritagli molto diversi rispetto a quelli visti sui dispositivi mobili. Anziché i notch o i fori della fotocamera, alcuni veicoli con Android Automotive OS hanno schermi curvi che non sono rettangolari. Per maggiori dettagli e indicazioni tecniche, consulta Adattare i contenuti ai display di forma irregolare.
I seguenti RRO possono essere utilizzati per emulare i ritagli del display:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Configurazioni di test consigliate
Poiché il numero totale di configurazioni che possono essere create combinando questi
RRO è piuttosto elevato, ti consigliamo di testare la tua app utilizzando le seguenti
combinazioni di profili hardware
e RRO, che sono simili ad alcuni veicoli attualmente in circolazione.
- Automotive (1080p orizzontale) con
com.android.systemui.rro.left
o com.android.systemui.rro.right
- Ultrawide per auto e motori con
com.android.systemui.rro.left e
com.android.internal.emulation.automotive_ultrawide_cutout
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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`"]]
