Menguji menggunakan emulator yang dapat dikonfigurasi
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Untuk membantu mengemulasi beberapa konfigurasi yang terlihat di seluruh OEM, profil
hardware tertentu mendukung konfigurasi
runtime.
Konfigurasi ini diterapkan menggunakan Runtime Resource
Overlays (RRO)
dan dapat dikelola menggunakan perintah adb shell cmd overlay.
Gunakan perintah berikut untuk mengaktifkan atau menonaktifkan RRO:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
Mengubah posisi panel sistem
Secara default, emulator yang dapat dikonfigurasi memiliki dua panel sistem – status bar di
bagian atas layar dan menu navigasi di bagian bawah layar. Meskipun banyak
mobil memiliki tata letak ini, beberapa tidak. Yang perlu diperhatikan adalah beberapa mobil memiliki
kolom sistem di sisi horizontal layar, bukan sisi
vertikal, yang dapat merusak asumsi yang dibuat saat mengembangkan aplikasi untuk faktor
bentuk seluler. Lihat Panel sistem, mode imersif, dan
rendering dari tepi ke tepi
untuk mengetahui detail selengkapnya dan panduan teknis.
RRO berikut dapat digunakan untuk mengubah panel sistem:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
Mengemulasikan potongan layar
Beberapa mobil memiliki layar dengan potongan layar yang sangat berbeda jika
dibandingkan dengan yang terlihat di perangkat seluler. Sebagai ganti potongan kamera pinhole atau notch, beberapa kendaraan Android Automotive OS memiliki layar melengkung yang membuat layar menjadi non-persegi panjang. Lihat Beradaptasi dengan layar berbentuk tidak beraturan
untuk mengetahui detail selengkapnya dan panduan teknis.
RRO berikut dapat digunakan untuk mengemulasi cutout layar:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
Konfigurasi pengujian yang direkomendasikan
Karena jumlah total konfigurasi yang dapat dibuat dengan menggabungkan
RRO ini cukup besar, sebaiknya uji aplikasi Anda menggunakan kombinasi
profil hardware
dan RRO berikut, yang mirip dengan beberapa kendaraan di jalan saat ini.
- Automotive (lanskap 1080p) dengan
com.android.systemui.rro.left
atau com.android.systemui.rro.right
- Ultrawide Otomotif dengan
com.android.systemui.rro.left dan
com.android.internal.emulation.automotive_ultrawide_cutout
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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`"]]
