إعداد مشروعك

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

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

لإضافة المكتبة إلى تطبيقك، راجِع صفحة إصدار مكتبة 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>
   

مستوى واجهة برمجة التطبيقات لتطبيقات السيارات

تحدّد "مكتبة تطبيقات السيارات" مستويات واجهة برمجة التطبيقات الخاصة بها حتى تتمكّن من معرفة ميزات المكتبة المتوافقة مع مضيف النماذج في السيارة. لاسترداد أعلى مستوى لواجهة برمجة تطبيقات Car App API متوافق مع مضيف، استخدِم الطريقة getCarAppApiLevel.

عليك الإفصاح عن الحد الأدنى لمستوى Car App API الذي يتيحه تطبيقك في ملف AndroidManifest.xml:

<manifest ...>
    <application ...>
        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="1"/>
    </application>
</manifest>

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