این صفحه نحوه نصب کتابخانه Car App و اکنون پیکربندی فایل مانیفست برای برنامه شما را شرح میدهد.
کتابخانه 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> مشخص شدهاند، برمیگردد.
تنظیم تم سفارشی
برای تنظیم یک تم سفارشی برای برنامه خودرو خود:
یک عنصر
<meta-data>در فایل مانیفست خود اضافه کنید:<meta-data android:name="androidx.car.app.theme" android:resource="@style/MyCarAppTheme />منبع استایل خود را برای تنظیم ویژگیهای تم اپلیکیشن خودروی سفارشی خود تعریف کنید:
<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>