الملحق "ج"، الحد الأدنى للإصدار المتوافق لواجهة برمجة التطبيقات الخاصة بالمكوّن الإضافي لواجهة المستخدم في السيارة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

من المتوقّع أن تنتقل المصنّعين الأصليّين للأجهزة إلى أحدث إصدار من car-ui-lib-plugin-apis (1.2.0 أو إصدار أحدث) في أقرب وقت ممكن. من المفترض ألا تُرسل المصنّعين الأصليّين للأجهزة أي مكوّن إضافي يستخدم إصدارًا قديمًا.

ما هي أسباب إجراء هذا التعديل؟

‫واجهات برمجة تطبيقات Java 8 والإصدارات الأحدث: تتوفّر للإصدارات السابقة من Android من خلال إتاحة إزالة رمز Java 8 والإصدارات الأحدث. يتم تجميع عمليات تنفيذ واجهات برمجة التطبيقات غير المتوفّرة في التطبيقات، ويتم إعادة كتابة الرمز الثنائي لحِزم APK للإشارة إلى عمليات التنفيذ بدلاً من المكتبات على الطور الأساسي.

يتطلّب تحميل عمليات تنفيذ المصنّعين الأصليين لمكونات واجهة المستخدم من المكوّن الإضافي لمكتبة واجهة المستخدم في السيارة الإشارة إلى الطرق المحدّدة من خلال واجهات car-ui-lib-plugin-apis. يتم إنشاء إشارات الطرق هذه من التطبيقات إلى المكوّنات الإضافية لمكتبة واجهة المستخدم في السيارة أثناء التشغيل مع توقّع أن تكون توقيعات الطرق متطابقة في عمليات تنفيذ التطبيق والمكوّن الإضافي.

تفعِّل بعض أنظمة الإنشاء ميزة إزالة رمز واجهة برمجة التطبيقات في جميع الأوقات بسبب متطلبات الحد الأدنى لمستوى حزمة تطوير البرامج (SDK). قد لا تتطابق توقيعات الطرق التي تم إزالة تشفيرها لواجهتَي car-ui-lib-plugin-apis مع تلك الواردة في تنفيذ المكوّن الإضافي لجهة التصنيع الذي لم تتم إزالة تشفيره، ما يؤدي إلى تعذُّر تحميل المكوّنات الإضافية.

ونتيجةً لذلك، فإنّ بعض تطبيقات GAS التي تم تجميعها باستخدام نظام الإنشاء الداخلي في Google غير متوافقة مع المكوّن الإضافي لمكتبة واجهة المستخدم في السيارة. لذلك، أزلنا كل الاعتمادات على واجهات برمجة تطبيقات Java 8 (والإصدارات الأحدث) التي تتطلّب إزالة رمز السكر. يتطلب هذا التغيير تعديلات على واجهة برمجة التطبيقات للواجهات التي تحدّدها car-ui-lib-plugin-apis.

الخطوات المطلوبة للمكوّنات الإضافية الخاصة بالمصنّعين الأصليّين للأجهزة

اتّبِع الخطوات التالية لتعديل واجهة برمجة التطبيقات:

1. عدِّل عملية تنفيذ المكوّن الإضافي لاستخدام أحدث إصدار من car-ui-lib-plugin-apis. للحصول على أحدث إصدار (1.2.0 أو إصدار أحدث)، يُرجى الاطّلاع على مستودع Maven في Google.

2. عدِّل عملية تنفيذ المكوّن الإضافي لتنفيذ واجهة PluginFactoryOEMV4. يتطلب هذا التغيير اتّباع الخطوات التالية عند تنفيذ المكوّن باستخدام المكوّن الإضافي للمصنع الأصلي للجهاز. تعديل تنفيذ المصنّع الأصلي للجهاز لما يلي:

   1. شريط الأدوات، لتنفيذ ToolbarControllerOEMV2

   2. عناصر قائمة المحتوى، لتوسيع ContentListItemOEMV2

   3. معالجة نتائج البحث في IME، لتوسيع ImeSearchInterfaceOEMV2

3. ثبِّت أحدث إصدار من التطبيق لاستخدام أحدث إصدار من Car UI Library.

ماذا يحدث في حال عدم تطبيق هذا التعديل؟

في حال عدم إكمال الخطوات الواردة في هذه الصفحة لأحد مكوّنات إضافية من المصنّع الأصلي للجهاز، يتعذّر على التطبيقات التي تمّ إزالة السكر منها، مثل Google Automotive Services (GAS)، تحميل عمليات تنفيذ المكوّن الإضافي لـ Car UI Library ولا يتم تطبيق أي تخصيصات من المصنّع الأصلي للجهاز من خلال آلية المكوّن الإضافي.

لا تتأثّر عمليات تخصيص RRO الحالية لمكتبة واجهة المستخدم في السيارة بهذه الصعوبة، وستستمر في العمل كالمعتاد.