الاختبار باستخدام المحاكي القابل للضبط
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
للمساعدة في محاكاة بعض الإعدادات التي تظهر لدى المصنّعين الأصليين للأجهزة، تتيح بعض ملفّات تعريف
الأجهزة إمكانية تعديل الإعدادات أثناء التشغيل.
يتم تنفيذ هذه الإعدادات باستخدام تراكبات موارد وقت التشغيل (RROs)
ويمكن إدارتها باستخدام الأمر adb shell cmd overlay.
استخدِم الأوامر التالية لتفعيل ميزة "الاستجابة السريعة للطلبات" أو إيقافها:
adb shell cmd overlay enable NAME
adb shell cmd overlay disable NAME
تعديل موضع شريط النظام
يتضمّن المحاكي القابل للضبط تلقائيًا شريطَي نظام، وهما شريط حالة في
أعلى الشاشة وشريط تنقّل في أسفل الشاشة. على الرغم من أنّ العديد من
السيارات تتشارك هذا التنسيق، إلا أنّ بعضها لا يتشاركه. يُرجى العِلم أنّ بعض السيارات تضع
أشرطة النظام على الجوانب الأفقية للشاشة وليس على الجوانب عموديًا، ما قد يخالف الافتراضات التي يتمّ إجراؤها عند تطوير التطبيقات لعوامل شكل الأجهزة الجوّالة. اطّلِع على أشرطة النظام والوضع الشامل ومعالجة الرسومات من الحافة إلى الحافة
لمزيد من التفاصيل والإرشادات الفنية.
يمكن استخدام طلبات الحصول على إذن الوصول إلى مساحة التخزين المؤقت التالية لتعديل أشرطة النظام:
com.android.systemui.rro.bottomcom.android.systemui.rro.bottom.roundedcom.android.systemui.rro.leftcom.android.systemui.rro.right
محاكاة الصور المقتطعة للشاشة
تحتوي بعض السيارات على شاشات ذات فتحات عرض مختلفة جدًا مقارنةً بالفتحات التي تظهر على الأجهزة الجوّالة. بدلاً من الفتحات أو النتوءات المخصّصة لكاميرا السيلفي، تحتوي بعض المركبات التي تعمل بنظام التشغيل Android Automotive على شاشات منحنية تجعلها غير مستطيلة. اطّلِع على التوافق مع الشاشات ذات الشكل غير المنتظم
لمزيد من التفاصيل والإرشادات الفنية.
يمكن استخدام طلبات الحصول على إذن الوصول إلى مساحة التخزين المؤقت التالية لمحاكاة أجزاء الشاشة المُقتطعة:
com.android.internal.display.cutout.emulation.top_and_rightcom.android.internal.display.cutout.emulation.free_formcom.android.internal.emulation.automotive_ultrawide_cutout
إعدادات الاختبار المقترَحة
بما أنّ إجمالي عدد الإعدادات التي يمكن إنشاؤها من خلال دمج ملفّات RRO هذه كبير جدًا، ننصحك باختبار تطبيقك باستخدام مجموعات ملفّات تعريف الأجهزة التالية
وملفات RRO، والتي تشبه بعض المركبات المعروضة حاليًا في الأسواق.
- Automotive (1080p أفقي) مع
com.android.systemui.rro.left
أو com.android.systemui.rro.right
- الصور الموسّعة للسيارات باستخدام
com.android.systemui.rro.left و
com.android.internal.emulation.automotive_ultrawide_cutout
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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`"]]
