دليل الدمج

توضح هذه الصفحة كيفية دمج التطبيقات غير المجمّعة. التطبيقات التي تشمل Dialer وMedia وواجهة مستخدم السيارة وتُعتبر المكتبة والرسائل القصيرة SMS من التطبيقات غير المجمّعة. هذه التطبيقات غير مجمعة من نظام Android الأساسي وتشمل منطق تلقي البيانات من التطبيق المصاحب للهاتف وتجربة المستخدم على جانب السيارة، بما في ذلك إعدادات الربط وتسجيل الميزات.

تعمل حِزم APK التي تم إنشاؤها من الرمز غير المجمّع مع عدة إصدارات من النظام الأساسي.

تحقق من الرمز

للاطلاع على الرمز غير المجمّع:

1. قم بتشغيل ما يلي:

   repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
   repo sync -cq -j4
   

2. للحصول على مزيد من المعلومات حول استخدام رمز مصدر AOSP، يمكنك الاطلاع على إعداد عميل Repo.

إنشاء الرمز البرمجي

استوديو Android

لإنشاء الرمز البرمجي في "استوديو Android"، اتّبِع الخطوات التالية:

1. في "استوديو Android"، استورد ملف الإصدار هذا:

   packages/apps/Car/libs/aaos-apps-gradle-project/build.gradle

2. تأكَّد من ضبط Gradle JDK في "استوديو Android" على الإصدار 11 على الأقل:
   
   
   الشكل 1. الإصدار 11.
3. أنشئ حِزم APK المطلوبة.

سطر الأوامر

لإنشاء التعليمات البرمجية من سطر الأوامر:

1. يمكنك ضبط موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android بإحدى الطريقتين التاليتين:
   • إنشاء packages/apps/Car/libs/aaos-apps-gradle-project/local.properties و ثم اضبط السمة sdk.dir التي تحتوي عليها. يمكن لـ Android Studio إجراء ذلك تلقائيًا عند فتح مشروع ما. على سبيل المثال، استخدم sdk.dir=/Users/MY-USERNAME/Library/Android/sdk
     
     أو
   • إعداد متغيّر البيئة ANDROID_SDK_ROOT باستخدام المسار إلى حزمة تطوير البرامج (SDK) لنظام التشغيل Android
2. افتح موجِّه أوامر أو نافذة واجهة.
3. الانتقال إلى packages/apps/Car/libs/aaos-apps-gradle-project.
4. شغِّل الأمر التالي:

   ./gradlew assemble

الحد الأدنى لمستويات واجهة برمجة التطبيقات المطلوبة

يعمل كل تطبيق غير مجمّع على أنظمة Android الأساسية بإصدار يساوي أو يزيد عن إصداره minSdkVersion يسرد الجدول التالي الحد الأدنى لإصدار واجهة برمجة التطبيقات المتوافق مع كل تطبيق:

التطبيق	الحد الأدنى لمستوى واجهة برمجة التطبيقات
التقويم	29
مكتبة واجهة مستخدم السيارة	29
جهاز مصاحب	29
Dialer	31
الوسائط	30
الرسائل القصيرة	30
مضيف AOSP	29

دمج أداة إنشاء مُسبق في صورة النظام

الصور التي تعمل بالإصدار 13 من نظام التشغيل Android والإصدارات الأحدث

وتتم إزالة الرمز غير المجمّع من النظام الأساسي Android 13. لذلك، قد تكون إضافة حِزم APK معدّة مسبقًا إلى إصدارات النظام الأساسي مطلوبة في الحالات التالية:

• اختبار الامتثال لـ CDD
• إدارة حسابات التطبيقات المميزة

يتم تحقيق ذلك باستخدام android_app_import قاعدة Sung:

android_app_import {
    name: "CarMediaApp",
    apk: "CarMediaApp.apk",
    privileged: true,
    certificate: "platform", // Media must be signed by the platform
    required: ["allowed_privapp_com.android.car.media"],
}

الإصدار 12 من نظام التشغيل Android والإصدارات الأقدم

ما دام إصدار نظام Android الأساسي متوافقًا مع التطبيق (راجِع الجدول أعلاه)، يمكن لحزمة APK ستتم إضافته إلى صورة النظام هذه. ومع ذلك، تحتوي معظم التطبيقات غير المجمّعة على إصدارات سابقة من رمز المصدر. المتوفّرة في الأنظمة الأساسية التي تعمل بالإصدارات الأقدم من نظام التشغيل Android 13 بشكل افتراضي، يعطي Sumg الأسبقية لرمز المصدر على الرمز المُنشأ مسبقًا. لذلك، من الضروري تعيين وضع علامة prefer على "true" داخل القاعدة android_app_import:

android_app_import {
    name: "CarDialerApp",
    apk: "CarDialerApp.apk",
    privileged: true,
    presigned: true, // Dialer can have its own signature
    required: ["allowed_privapp_com.android.car.dialer"],
    overrides: ["Dialer"],
    prefer: true, // The prebuilt replaces a source target with the same name,
    }

التطبيقات مدرجة وفقًا للنوع غير المجمّع

التطبيق	المحتوى المميّز غير المجمَّع		غير مجمع (لا يكون ذلك في قسم النظام)
	موقَّع من النظام	موقّع من غير النظام
التقويم			X
جهاز مصاحب		X
Dialer		X
مضيف AOSP		X
الوسائط	X
الرسائل القصيرة		X
تعديل التوزيع	عبر الهواء	عبر الهواء أو Google Play	عبر الهواء أو Google Play