اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
التحكّم في ميزات خدمة السيارات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تكون معظم خدمات السيارات إلزامية بشكل تلقائي ويتم تفعيلها دائمًا. ومع ذلك، يمكنك تحديد مجموعة فرعية من خدمات السيارات لتكون اختيارية لأنّ بعض الميزات قد لا تكون متوفرة في كل سيارة.
قائمة الميزات الاختيارية
في الجدول أدناه، يمكنك الاطّلاع على ميزات التحكّم في السيارة الاختيارية التي يمكنك تفعيلها أو إيقافها.
| ميزة التحكّم في السيارة |
قيمة سلسلة |
|---|
| خدمة EVS للسيارة |
car_evs_service |
| خدمة تجريبية لميزة "قفل الشاشة" في السيارات |
experimental_car_keyguard_service |
| خدمة التنقّل بالسيارة |
car_navigation_service |
| خدمة اتصال ركّاب السيارة |
car_occupant_connection_service |
| خدمة الوصول عن بُعد إلى السيارة |
car_remote_access_service |
| خدمة جهاز التحكّم عن بُعد في السيارة |
car_remote_device_service |
| خدمة القياس عن بُعد في السيارة |
car_telemetry_service |
| خدمة إرسال إشعارات إلى مستخدمي السيارات |
com.android.car.user.CarUserNoticeService |
| الخدمة المنزلية للمجموعة |
cluster_home_service |
| خدمة التشخيص |
diagnostic |
| خدمة التعرّف على حالة الإشغال |
occupant_awareness |
| خدمة مراقبة مساحة التخزين |
storage_monitoring |
| خدمة توفير بيانات التنقّل للمركبة |
vehicle_map_service |
تفعيل ميزات التحكّم في السيارة وإيقافها
يمكنك التحكّم في توافق الميزات في حِزمك بطريقتَين، إما باستخدام
طبقات الموارد أثناء التشغيل (RRO) أو من خلال Vehicle Hardware Abstraction Layer (VHAL).
استخدام طلبات إعادة النظر
استخدِم إعداد المورد الذي يحمل الاسم config_allowed_optional_car_features، والذي
يسرد جميع الميزات الاختيارية التي يمكنك تفعيلها. عند تشغيل السيارة لأول مرة، يتم تسجيل ميزات السيارة
الاختيارية المحتملة وتفعيلها إذا لم تضِفها VHAL إلى القائمة المحظورة.
لمزيد من المعلومات عن عمليات إعادة التوجيه، يُرجى الاطّلاع على مقالة تغيير قيمة موارد التطبيق أثناء التشغيل.
استخدام VHAL
تتحكّم طبقة Vehicle Hardware Abstraction Layer (VHAL) في الميزات من خلال العمل كقائمة محظورة
لإيقاف ميزات اختيارية معيّنة. يسرد عنصر VHAL الذي يحمل الاسم
DISABLED_OPTIONAL_FEATURES الميزات الاختيارية في التراكب التي
يجب إيقافها. إذا لم تكن هذه السمة متوفّرة، سيتم تفعيل قائمة الميزات الاختيارية من
عمليات الربط بتطبيقات أخرى. للاطّلاع على مزيد من المعلومات عن VHAL، يُرجى الاطّلاع على
نظرة عامة على VHAL.
استخدام أوامر Shell لتصحيح الأخطاء
هناك طريقة ثالثة للتحكّم في الميزات الاختيارية التي تريد تفعيلها أو إيقافها، وهي استخدام
زوج من أوامر shell، والتي لا تتوفّر إلا في إصدارات user-debug
ويتم توفيرها للمطوّرين لاستخدامها. يحتوي الجدول في
قائمة الميزات الاختيارية على القيم التي يجب استخدامها بدلاً من
<FEATURE_STRING_VALUE>.
لتفعيل ميزة:
adb root; adb shell cmd car_service enable-feature <FEATURE_STRING_VALUE>; adb reboot
لإيقاف ميزة، اتّبِع الخطوات التالية:
adb root; adb shell cmd car_service disable-feature <FEATURE_STRING_VALUE>; adb reboot
تحديد الميزات المفعّلة
عند تصحيح الأخطاء في المشاكل المتعلّقة بميزات معيّنة، قد يكون من المفيد معرفة الميزات التي
تم تفعيلها وسبب تفعيلها. لتفريغ معلومات feature-related، يمكنك تنفيذ:
adb shell dumpsys car_service --services CarFeatureController
يسرد هذا الأمر أنواع المعلومات الموضّحة أدناه.
| القيمة |
الوصف |
|---|
mEnabledFeatures |
الميزات المفعّلة حاليًا |
mDefaultEnabledFeaturesFromConfig |
الميزات الاختيارية المدرَجة في config_allowed_optional_car_features |
mDisabledFeaturesFromVhal |
الميزات التي يحدّدها VHAL لإيقافها في سمة VHAL،
DISABLED_OPTIONAL_FEATURES. |
mPendingEnabledFeatures |
الميزات التي سيتم تفعيلها عند إعادة التشغيل |
mPendingDisabledFeatures |
الميزات التي سيتم إيقافها بعد إعادة التشغيل |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Car service feature control\n\nBy default, most car services are mandatory and are always enabled. However, you can\ndesignate a subset of car services to be *optional* because some features might not\nbe supported in every car.\n\nList of optional features\n-------------------------\n\nThe optional car control features you can enable and disable are listed in the table below.\n\n| Car control feature | String value |\n|-----------------------------------|---------------------------------------------|\n| Car EVS service | `car_evs_service` |\n| Car experimental keyguard service | `experimental_car_keyguard_service` |\n| Car navigation service | `car_navigation_service` |\n| Car occupant connection service | `car_occupant_connection_service` |\n| Car remote access service | `car_remote_access_service` |\n| Car remote device service | `car_remote_device_service` |\n| Car telemetry service | `car_telemetry_service` |\n| Car user notice service | `com.android.car.user.CarUserNoticeService` |\n| Cluster home service | `cluster_home_service` |\n| Diagnostic service | `diagnostic` |\n| Occupant awareness wervice | `occupant_awareness` |\n| Storage monitoring service | `storage_monitoring` |\n| Vehicle map service | `vehicle_map_service` |\n\nEnable and disable car control features\n---------------------------------------\n\nYou can control support for features in your builds in one of two ways, either with\nruntime resource overlays (RROs) or through the Vehicle Hardware Abstraction Layer (VHAL).\n\n### Use RROs\n\nUse the resource configuration named `config_allowed_optional_car_features`, which\nlists all the optional features you can enable. When a car is first booted up, possible\noptional car features are noted and are enabled if they're not blocklisted by the VHAL.\nTo learn more RROs, see\n[Change the value of an app's resources at runtime.](/docs/core/runtime/rros)\n\n### Use the VHAL\n\nThe Vehicle Hardware Abstraction Layer (VHAL) controls features by serving as a\nblocklist to disable specific optional features. The VHAL property named\n`DISABLED_OPTIONAL_FEATURES` lists the optional features in the overlay that\nare to be disabled. If this property doesn't exist, then the list of optional features from\nthe RROs are all enabled. To learn more about the VHAL, see the\n[VHAL overview](/docs/automotive/vhal).\n\n### Use debug shell commands\n\nA third way to control which optional features to enable or disable is through the use of a\npair of shell commands, which are available only in `user-debug` builds and are\nprovided for use by developers. The table in\n[List of optional features](#list) contains the values to use instead of\n`\u003cFEATURE_STRING_VALUE\u003e`.\n\nTo enable a feature: \n\n```\nadb root; adb shell cmd car_service enable-feature \u003cFEATURE_STRING_VALUE\u003e; adb reboot\n```\n\nTo disable a feature: \n\n```\nadb root; adb shell cmd car_service disable-feature \u003cFEATURE_STRING_VALUE\u003e; adb reboot\n```\n\nDetermine which features are enabled\n------------------------------------\n\nWhen debugging issues related to specific features, it can be helpful to know which features are\nenabled and why. To dump `feature-related` information, run: \n\n```\nadb shell dumpsys car_service --services CarFeatureController\n```\n\nThis command lists the types of information shown below.\n\n| Value | Description |\n|-------------------------------------|---------------------------------------------------------------------------------------------------|\n| `mEnabledFeatures` | Currently enabled features. |\n| `mDefaultEnabledFeaturesFromConfig` | Optional features listed in `config_allowed_optional_car_features`. |\n| `mDisabledFeaturesFromVhal` | Features specified by the VHAL to be disabled in the VHAL property, `DISABLED_OPTIONAL_FEATURES`. |\n| `mPendingEnabledFeatures` | Features to be enabled upon a reboot. |\n| `mPendingDisabledFeatures` | Features to be disabled after a reboot. |"]]
