Effectuer des tests à l'aide de l'émulateur configurable
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Pour aider à émuler certaines des configurations observées chez les OEM, certains profils matériels sont compatibles avec la configurabilité d'exécution.
Ces configurations sont implémentées à l'aide de superpositions de ressources d'exécution (RRO, Runtime Resource Overlays) et peuvent être gérées à l'aide de la commande adb shell cmd overlay.
Utilisez les commandes suivantes pour activer ou désactiver un RRO:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Modifier la position de la barre système
Par défaut, l'émulateur configurable comporte deux barres système : une barre d'état en haut de l'écran et une barre de navigation en bas de l'écran. Bien que de nombreuses voitures partagent cette disposition, certaines ne le font pas. Notez que certaines voitures ont leur ou leurs barres système sur les côtés horizontaux de l'écran et non sur les côtés verticaux, ce qui peut contredire les hypothèses faites lors du développement d'applications pour les facteurs de forme mobiles. Pour en savoir plus et obtenir des conseils techniques, consultez Barres système, mode immersif et rendu de bord à bord.
Vous pouvez utiliser les RRO suivants pour modifier les barres système:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Émuler les encoches
Certains écrans de voiture sont dotés d'encoches très différentes de celles des appareils mobiles. Au lieu d'encoches ou de découpes en trou d'épingle pour appareils photo, certains véhicules équipés d'Android Automotive OS disposent d'écrans incurvés qui ne sont pas rectangulaires. Pour en savoir plus et obtenir des conseils techniques, consultez S'adapter aux écrans de forme non conventionnelle.
Les RRO suivants peuvent être utilisés pour émuler les encoches d'écran:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Configurations de test recommandées
Étant donné que le nombre total de configurations pouvant être créées en combinant ces RRO est assez important, nous vous recommandons de tester votre application à l'aide des combinaisons suivantes de profils matériels et de RRO, qui sont similaires à certains véhicules actuellement sur la route.
- Automotive (1080p landscape) (Automobile [paysage 1080p]) avec
com.android.systemui.rro.left ou com.android.systemui.rro.right
- Ultra grand angle pour l'automobile avec
com.android.systemui.rro.left et com.android.internal.emulation.automotive_ultrawide_cutout
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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`"]]
