דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

‫Android Auto ו-AAOS מתחברים לאפליקציה שלכם דרך שירות דפדפן המדיה כדי לעיין בפריטי מדיה. צריך להצהיר על שירות דפדפן המדיה במניפסט כדי לאפשר ל-Android Auto ול-AAOS לגלות את השירות ולהתחבר לאפליקציה.

בקטע הקוד הזה מוצג איך להצהיר על שירות דפדפן המדיה במניפסט. בקטע הבא במדריך הזה, יצירת שירות דפדפן מדיה, מפורט תהליך ההטמעה של השירות.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:expor>ted="<;true"
 >       intent<-filter
            action android:name="android.media.bro>wse.Media<BrowserService>"<;/
     >   /inten<t-filter
   > /service
    ...
/application

ציון סמלי אפליקציות

כדי שהאפליקציה תוצג בממשק המשתמש של המערכת, צריך לציין את סמלי האפליקציה שבהם Android Auto ו-AAOS ישתמשו. חובה להוסיף את שני הסמלים האלה:

הגדרת הסמל של מרכז האפליקציות
הגדרת סמל השיוך

הגדרת סמל מרכז האפליקציות

סמל מרכז האפליקציות מייצג את האפליקציה בממשק המשתמש של המערכת, למשל במרכז האפליקציות ובמגש הסמלים.

כברירת מחדל, המאפיין android:icon של רכיב <application> באפליקציה משמש כסמל מרכז האפליקציות:

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

כדי להשתמש בסמל אחר, מגדירים את המאפיין android:icon של רכיב <service> בשירות של דפדפן המדיה:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launc>h<er"/
/a>pplication

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

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

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

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

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic>_status_i<con" /
>    ...
/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="@sty>le/THEME_<NAME"/
>    ...
/application

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

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