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

کلمات کلیدی عمومی: اندروید اتو، سیستم عامل اندروید اتو، AAOS، مانیفست، سرویس مرورگر رسانه، آیکون‌های برنامه، رابط کاربری خودرو، پیکربندی مانیفست، برنامه رسانه، توسعه خودرو

فایل‌های مانیفست برنامه خود را برای ادغام با Android Auto و Android Automotive OS (AAOS) پیکربندی کنید. برای فعال کردن کشف و اتصال توسط این پلتفرم‌ها، سرویس مرورگر رسانه خود را در مانیفست اعلام کنید. آیکون‌های برنامه مورد نیاز، از جمله یک آیکون لانچر برای یک آیکون تخصیص برای استفاده توسط اجزای رابط کاربری سیستم مانند کنترل‌های رسانه را مشخص کنید.

برای کسب اطلاعات بیشتر در مورد فایل‌های مانیفست، به نمای کلی مانیفست برنامه مراجعه کنید.

سرویس مرورگر رسانه خود را اعلام کنید

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

این قطعه کد نحوه تعریف سرویس مرورگر رسانه در مانیفست را نشان می‌دهد. بخش بعدی این راهنما، «ایجاد سرویس مرورگر رسانه» ، جزئیات فرآیند پیاده‌سازی سرویس را شرح می‌دهد.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

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

برای نمایش برنامه خود در رابط کاربری سیستم، آیکون‌های برنامه‌ای که Android Auto و AAOS باید از آنها استفاده کنند را مشخص کنید. این دو آیکون الزامی هستند:

نماد راه‌انداز را تعریف کنید

آیکون لانچر، برنامه شما را در رابط کاربری سیستم، مانند لانچر و در سینی آیکون‌ها، نشان می‌دهد.

به طور پیش‌فرض، ویژگی android:icon از عنصر <application> برنامه شما به عنوان آیکون لانچر استفاده می‌شود:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

برای استفاده از یک آیکون متفاوت، ویژگی android:icon عنصر <service> سرویس مرورگر رسانه خود را تنظیم کنید:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

نماد انتساب را تعریف کنید

نماد انتساب در جاهایی استفاده می‌شود که محتوای رسانه اولویت دارد، مانند کارت‌های رسانه. استفاده مجدد از نماد کوچک مورد استفاده برای اعلان‌ها را در نظر بگیرید. این نماد باید تک رنگ باشد. ما اکیداً توصیه می‌کنیم برای جلوگیری از تار شدن نماد، از یک تصویر برداری استفاده کنید.

نماد انتساب در کارت رسانه

شکل ۱. نماد انتساب روی کارت رسانه.

شما می‌توانید با استفاده از این اعلان مانیفست، یک آیکون که برای نمایش برنامه شما استفاده می‌شود را مشخص کنید:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

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

به طور پیش‌فرض، مقدار ویژگی android:label از عنصر <application> برنامه شما به عنوان نام نمایشی برنامه شما در صفحه نمایش خودرو استفاده می‌شود.

برای استفاده از نام نمایشی متفاوت - یا اگر برنامه شما چندین سرویس مرورگر رسانه دارد - ویژگی android:label را برای عنصر <service> سرویس مرورگر رسانه تنظیم کنید.

رنگ تأکیدی برنامه خود را مشخص کنید

رنگ تأکیدی برنامه شما توسط Android Auto و AAOS برای استایل‌دهی به کنترل‌های پخش و سایر عناصر رابط کاربری استفاده می‌شود.

به طور پیش‌فرض، رنگ تاکیدی از آیتم colorAccent از منبع استایل android:theme عنصر <application> برنامه شما گرفته می‌شود.

برای استفاده از یک رنگ تاکیدی متفاوت برای تجربه درون خودرو، یک عنصر <meta-data> را برای یک منبع سبک متفاوت که حاوی یک آیتم colorAccent است، اضافه کنید:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

پیکربندی مخصوص پلتفرم

علاوه بر پیکربندی دقیق در این صفحه، برای الزامات خاص پلتفرم به بخش‌های زیر مراجعه کنید: