הגדרת קובצי מניפסט

‪. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

מגדירים את קובצי המניפסט של האפליקציה כדי לשלב אותה עם Android Auto ו-Android Automotive OS ‏ (AAOS). כדי לאפשר לפלטפורמות האלה לגלות את שירות הדפדפן של המדיה ולחבר אותו, צריך להצהיר על שירות הדפדפן של המדיה במניפסט. מציינים את סמלי האפליקציה הנדרשים, כולל סמל של מרכז האפליקציות וסמל ייחוס לשימוש ברכיבי ממשק המשתמש של המערכת, כמו ממשק השליטה במדיה.

מידע נוסף על קובצי מניפסט זמין במאמר סקירה כללית של קובץ מניפסט של אפליקציה.

הצהרה על שירות דפדפן המדיה

‫Android Auto ו-AAOS מתחברים לאפליקציה שלכם דרך שירות דפדפן המדיה כדי לעיין בפריטי מדיה. מצהירים על שירות דפדפן המדיה במניפסט כדי לאפשר ל-Android Auto ול-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>

הגדרת סמל השיוך

סמל השיוך משמש במקומות שבהם תוכן מדיה מקבל עדיפות, כמו בכרטיסי מדיה. מומלץ לעשות שימוש חוזר בסמל הקטן שמשמש להתראות. הסמל הזה חייב להיות חד-צבעי. מומלץ מאוד להשתמש בנכס וקטורי כדי למנוע טשטוש של הסמל.

סמל הייחוס בכרטיס המדיה

איור 1. סמל השיוך בכרטיס המדיה.

אפשר לציין סמל שמשמש לייצוג האפליקציה באמצעות ההצהרה הבאה בקובץ המניפסט:

<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>

הגדרה ספציפית לפלטפורמה

בנוסף להגדרות שמפורטות בדף הזה, אפשר לעיין בקטעים הבאים כדי לראות את הדרישות הספציפיות לפלטפורמה: