پروژه خود را تنظیم کنید

این صفحه نحوه نصب کتابخانه Car App و اکنون پیکربندی فایل manifest برای برنامه شما را شرح می‌دهد.

کتابخانه Car App را نصب کنید

برای افزودن کتابخانه به برنامه خود، به صفحه انتشار کتابخانه Jetpack مراجعه کنید.

فایل‌های مانیفست برنامه خود را پیکربندی کنید

قبل از اینکه بتوانید برنامه ماشین خود را ایجاد کنید، باید فایل‌های مانیفست برنامه خود را پیکربندی کنید.

CarAppService خود را اعلام کنید

میزبان از طریق پیاده‌سازی CarAppService به برنامه شما متصل می‌شود. شما این سرویس را در مانیفست خود تعریف می‌کنید تا میزبان بتواند برنامه شما را کشف کرده و به آن متصل شود.

همچنین باید دسته بندی برنامه خود را در عنصر <category> از فیلتر intent برنامه خود اعلام کنید. برای مقادیر مجاز برای این عنصر، لیست دسته بندی های برنامه پشتیبانی شده را مشاهده کنید.

قطعه کد زیر نحوه تعریف سرویس اپلیکیشن خودرو برای یک اپلیکیشن نقطه مورد نظر در مانیفست شما را نشان می‌دهد:

<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 خود را همانطور که در Declare your CarAppService توضیح داده شده است، تعریف می‌کنید، باید دسته برنامه خود را نیز با اضافه کردن یک یا چند مورد از این مقادیر در فیلتر intent تعریف کنید.

• 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» مراجعه کنید.

برای توضیحات دقیق هر دسته و معیارهای لازم برای واجد شرایط بودن در یک دسته، به کیفیت برنامه اندروید برای خودروها مراجعه کنید.

نام و آیکون برنامه را مشخص کنید

برای نمایش برنامه شما در رابط کاربری سیستم، 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>
   

سطح API اپلیکیشن خودرو

کتابخانه برنامه خودرو (Car App Library) سطوح API مخصوص به خود را تعریف می‌کند تا بتوانید بدانید کدام ویژگی‌های کتابخانه توسط میزبان قالب روی یک وسیله نقلیه پشتیبانی می‌شوند. برای بازیابی بالاترین سطح API برنامه خودرو که توسط یک میزبان پشتیبانی می‌شود، از متد getCarAppApiLevel() استفاده کنید.

حداقل سطح API برنامه Car App که توسط برنامه شما پشتیبانی می‌شود را در فایل AndroidManifest.xml خود اعلام کنید:

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

برای جزئیات بیشتر در مورد حفظ سازگاری با نسخه‌های قبلی و اعلام حداقل سطح API مورد نیاز برای استفاده از یک ویژگی، به مستندات مربوط به حاشیه‌نویسی RequiresCarApi مراجعه کنید. برای تعریف اینکه کدام سطح API برای استفاده از یک ویژگی خاص از کتابخانه برنامه خودرو مورد نیاز است، مستندات مرجع CarAppApiLevels را بررسی کنید.