הגדרת הפרויקט

בדף הזה מוסבר איך להתקין את ספריית 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 כמו שמתואר במאמר הצהרה על CarAppService, צריך גם להצהיר על הקטגוריה של האפליקציה על ידי הוספה של אחד או יותר מהערכים האלה במסנן ה-Intent.

• ‫androidx.car.app.category.NAVIGATION: מספקת הוראות ניווט מפורטות. מידע נוסף זמין במאמר בנושא פיתוח אפליקציות ניווט לרכב.

• ‫androidx.car.app.category.POI: מספק פונקציונליות שרלוונטית למציאת נקודות עניין כמו מקומות חנייה, תחנות טעינה ותחנות דלק. מידע נוסף זמין במאמר בנושא בניית אפליקציות של נקודות עניין לרכב.

• ‫androidx.car.app.category.IOT: מאפשר למשתמשים לבצע פעולות רלוונטיות במכשירים מחוברים מתוך המכונית. אפשר לקרוא את המאמר בנושא פיתוח אפליקציות לאינטרנט של הדברים (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.

תיאורים מפורטים של כל קטגוריה והקריטריונים שנדרשים כדי לעמוד בדרישות של קטגוריה מסוימת זמינים במאמר בנושא איכות אפליקציות ל-Android לרכבים.

ציון השם והסמל של האפליקציה

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

הגדרת עיצוב מותאם אישית

כדי להגדיר עיצוב מותאם אישית לאפליקציה לרכב:

1. מוסיפים רכיב <meta-data> לקובץ המניפסט:

   <meta-data
       android:name="androidx.car.app.theme"
       android:resource="@style/MyCarAppTheme />
   

2. מצהירים על משאב הסגנון כדי להגדיר את המאפיינים של העיצוב המותאם אישית של אפליקציית הרכב:

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