本頁說明如何安裝 Car App 程式庫，以及如何設定應用程式的資訊清單檔案。
安裝 Car App 程式庫
如要將程式庫新增至應用程式，請參閱 Jetpack 程式庫發布頁面。
設定應用程式的資訊清單檔案
您必須先設定應用程式的資訊清單檔案，才能建立車輛應用程式。
宣告 CarAppService
主機會透過 CarAppService 實作項目連線至應用程式。在資訊清單中宣告這項服務，讓主機探索及連線至您的應用程式。
您也需要在應用程式意圖篩選器的 <category> 元素中宣告應用程式類別。如要瞭解這個元素允許的值，請參閱支援的應用程式類別清單。
下列程式碼片段說明如何在資訊清單中，為興趣點應用程式宣告車輛應用程式服務：
<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」一文的說明操作，並在意圖篩選器中加入一或多個下列值，宣告應用程式類別。
androidx.car.app.category.NAVIGATION：提供即時路況導航指示。請參閱「建構車用導航應用程式」。androidx.car.app.category.POI：提供尋找興趣點的相關功能，例如停車位、充電站和加油站。請參閱「建構車輛專用搜尋點應用程式」。androidx.car.app.category.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 應用程式品質」。
指定應用程式名稱和圖示
如要在系統 UI 中代表應用程式，carPermissionActivityLayout 必須為主機指定應用程式名稱和圖示。使用 CarAppService 的 label 和 icon 屬性，指定主機用來代表應用程式的應用程式名稱和圖示：
...
<service
android:name=".MyCarAppService"
android:exported="true"
android:label="@string/my_app_name"
android:icon="@drawable/my_app_icon">
...
</service>
...
如未在 <service> 元素中宣告標籤或圖示，主機會改用 <application> 元素指定的值。
設定自訂主題
如要為車用應用程式設定自訂主題，請按照下列步驟操作：
在資訊清單檔案中新增
<meta-data>元素：<meta-data android:name="androidx.car.app.theme" android:resource="@style/MyCarAppTheme />宣告樣式資源，為自訂車輛應用程式主題設定屬性：
<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>
Car App API 級別
車輛應用程式程式庫會定義自己的 API 級別，方便您瞭解車輛上的範本主機支援哪些程式庫功能。如要擷取主機支援的最高 Car App API 級別，請使用 getCarAppApiLevel() 方法。
在 AndroidManifest.xml 檔案中，宣告應用程式支援的最低 Car App API 級別：
<manifest ...>
<application ...>
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="1"/>
</application>
</manifest>
如要瞭解如何維持回溯相容性，以及宣告使用某項功能所需的最低 API 級別，請參閱 RequiresCarApi 註解的說明文件。如要瞭解使用 Car App Library 的特定功能需要哪個 API 級別，請參閱 CarAppApiLevels 的參考文件。