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

מגדירים את קובצי המניפסט של האפליקציה כדי לשלב אותם עם 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>

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

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