إعداد مشروعك

توضّح هذه الصفحة كيفية تثبيت مكتبة "تطبيقات السيارات" وكيفية ضبط ملف البيان الخاص بتطبيقك.

تثبيت مكتبة "تطبيقات السيارة"

لإضافة المكتبة إلى تطبيقك، راجِع صفحة إصدار مكتبة Jetpack.

ضبط ملفات بيان التطبيق

قبل إنشاء تطبيق للسيارة، يجب ضبط ملفات البيان الخاصة بتطبيقك.

تعريف CarAppService

يتصل المضيف بتطبيقك من خلال تنفيذ CarAppService. عليك تعريف هذه الخدمة في البيان لكي يتمكّن المضيف من اكتشاف تطبيقك والاتصال به.

عليك أيضًا تحديد فئة تطبيقك في العنصر <category> ضمن فلتر الأهداف الخاص بتطبيقك. اطّلِع على قائمة فئات التطبيقات المتوافقة لمعرفة القيم المسموح بها لهذا العنصر.

يوضّح مقتطف الرمز التالي كيفية تعريف خدمة تطبيق سيارة لتطبيق خاص بنقاط الاهتمام في ملف البيان:

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService"/>
        <category android:name="androidx.car.app.category.POI"/>
      </intent-filter>
    </service>

    ...
<application>

فئات التطبيقات المتوافقة

عند تعريف CarAppService كما هو موضّح في تعريف CarAppService، عليك أيضًا تعريف فئة تطبيقك من خلال إضافة قيمة واحدة أو أكثر من هذه القيم في intent filter.

• androidx.car.app.category.NAVIGATION: تعرض هذه السمة تعليمات التنقّل المفصّلة. اطّلِع على إنشاء تطبيقات تنقّل للسيارات.

• androidx.car.app.category.POI: توفّر وظائف ذات صلة بالعثور على نقاط الاهتمام، مثل أماكن ركن السيارات ومحطات الشحن ومحطات الوقود. اطّلِع على إنشاء تطبيقات نقاط الاهتمام للسيارات.

• androidx.car.app.category.IOT: تتيح للمستخدمين اتخاذ إجراءات ذات صلة على الأجهزة المتصلة من داخل السيارة. اطّلِع على إنشاء تطبيقات إنترنت الأشياء للسيارات.

• androidx.car.app.category.WEATHER: تتيح هذه السمة للمستخدمين الاطّلاع على معلومات الطقس ذات الصلة بموقعهم الجغرافي الحالي أو على طول طريقهم. اطّلِع على إنشاء تطبيقات الطقس للسيارات.

• ‫androidx.car.app.category.MEDIA: تتيح للمستخدمين تصفّح الموسيقى والراديو والكتب الصوتية وغيرها من المحتوى الصوتي وتشغيلها في السيارة. اطّلِع على إنشاء تطبيقات وسائط تستند إلى نماذج للسيارات.

• ‫androidx.car.app.category.MESSAGING: تتيح للمستخدمين التواصل عبر رسائل نصية قصيرة. يمكنك الاطّلاع على إنشاء تجارب مراسلة مستندة إلى نماذج في Android Auto.

• ‫androidx.car.app.category.CALLING: تتيح للمستخدمين التواصل عبر المكالمات الصوتية. اطّلِع على إنشاء تجارب اتصال لتطبيق Android Auto.

للحصول على أوصاف تفصيلية لكل فئة والمعايير المطلوبة للتأهّل لها، يمكنك الاطّلاع على جودة تطبيقات Android للسيارات.

تحديد اسم التطبيق ورمزه

لتمثيل تطبيقك في واجهة مستخدم النظام، يجب أن يحدّد carPermissionActivityLayout اسم تطبيق ورمزًا للمضيف. استخدِم سمتَي label وicon في CarAppService لتحديد اسم التطبيق والرمز الذي يستخدمه المضيف لتمثيل تطبيقك:

...
<service
   android:name=".MyCarAppService"
   android:exported="true"
   android:label="@string/my_app_name"
   android:icon="@drawable/my_app_icon">
   ...
</service>
...

في حال عدم تحديد تصنيف أو رمز في العنصر <service>، سيعود التطبيق المضيف إلى القيم المحدّدة في العنصر <application>.

ضبط مظهر مخصّص

لضبط مظهر مخصّص لتطبيق السيارة، اتّبِع الخطوات التالية:

1. أضِف عنصر <meta-data> في ملف البيان:

   <meta-data
       android:name="androidx.car.app.theme"
       android:resource="@style/MyCarAppTheme />
   

2. عليك تعريف مصدر التصميم لضبط سمات تصميم تطبيق السيارة المخصّص:

   <resources>
     <style name="MyCarAppTheme">
       <item name="carColorPrimary">@color/my_primary_car_color</item>
       <item name="carColorPrimaryDark">@color/my_primary_dark_car_color</item>
       <item name="carColorSecondary">@color/my_secondary_car_color</item>
       <item name="carColorSecondaryDark">@color/my_secondary_dark_car_color</item>
       <item name="carPermissionActivityLayout">@layout/my_custom_background</item>
     </style>
   </resources>