在範本應用程式中新增對 Android Automotive OS 的支援

Android Automotive OS 可讓使用者在車輛中安裝應用程式。為觸及這個平台的使用者，您必須發布專為駕駛人設計且與 Android Automotive OS 相容的應用程式。您可以重複使用 Android Auto 應用程式中絕大部分的程式碼和資源，但必須建立符合本頁所述規定的獨立版本。

如要在 Android Automotive OS 上執行車輛應用程式，請務必安裝最新版的 Templates Host 系統應用程式。

開發總覽

新增對 Android Automotive OS 的支援只需完成幾個步驟，如本頁各節所述：

1. 建立汽車模組
2. 宣告支援 Android Automotive OS
3. 宣告 CarAppService 和 CarAppActivity
4. 更新 Gradle 依附元件

使用 Android Studio Bumblebee 以上版本，確保已啟用所有 Automotive OS 功能。

建立車用模組

Android Automotive OS 的部分元件 (例如資訊清單) 設有平台專屬的需求。建立可區隔這些元件程式碼與專案中的其他程式碼 (例如手機應用程式使用的程式碼) 的模組。

針對現有專案，請按照下列步驟在專案中新增汽車模組：

1. 在 Android Studio 中，依序點選「File」>「New」>「New Module」。
2. 選取「Automotive Module」，然後按一下「Next」。
3. 提供「Application/Library name」。這是使用者會在 Android Automotive OS 上看到的應用程式名稱。
4. 輸入「Module name」。
5. 依據現有應用程式編輯「Package name」。

6. 將「Minimum SDK」設為「API 29: Android 10 (Q)」，然後點選「Next」。 所有支援 Android Automotive OS Car App Library 的車輛均搭載 Android 10 API 級別 29 以上版本，因此選取這個值可指定所有相容的車輛。

7. 選取「Add No Activity」，然後按一下「Finish」。

如要新建專案：

1. 在 Android Studio 中，依序選取「File」>「New」>「New Project」。
2. 在「Project Type」中選取「Automotive」。
3. 選取「No Activity」，然後點選「Next」。
4. 在「Name」中設定專案名稱。這是使用者會在 Android Automotive OS 上看到的應用程式名稱。
5. 在「Package name」中輸入套件名稱。如要進一步瞭解如何選取套件名稱，請參閱「套件名稱」一節。

6. 將「Minimum SDK」設為「API 29: Android 10 (Q)」，然後點選「Next」。

   所有支援 Android Automotive OS Car App Library 的車輛均搭載 Android 10 API 級別 29 以上版本，因此選取這個值可指定所有相容的車輛。

在 Android Studio 中建立模組後，請在新的汽車模組中開啟 AndroidManifest.xml 檔案：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.car.app">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />

</manifest>

application 元素提供一些標準應用程式資訊，以及宣告支援 Android Automotive OS 的 uses-feature 元素。請注意，資訊清單中未宣告任何活動。

下一步，將下列 uses-feature 元素新增至資訊清單：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.car.app">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />
    <uses-feature
        android:name="android.software.car.templates_host"
        android:required="true" />

    <uses-feature
        android:name="android.hardware.wifi"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.portrait"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.landscape"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.camera"
        android:required="false" />

</manifest>

第一個 uses-feature 元素會宣告應用程式使用 Templates Host 執行。將剩餘的四個 uses-feature 元素明確設定為 required="false"，可確保應用程式不會與 Android Automotive OS 裝置上的可用硬體功能發生衝突。

更新 Gradle 依附元件

在汽車模組中，您必須在 androidx.car.app:app-automotive 構件中新增依附元件，當中包含應用程式在 Android Automotive OS 上執行所需的 CarAppActivity 實作項目。

如果您要開發應用程式以同時支援 Android Auto 和 Android Automotive OS，建議您將 CarAppService 存放在可供行動裝置與汽車模組共用的獨立模組中。如要使用這個方法，您必須更新汽車模組，以使用 Gradle 的專案依附元件加入共用模組，如以下程式碼片段所示：

buildscript {
    ...
    dependencies {
        ...
        implementation "androidx.car.app:app-automotive:car_app_library_version"
        implementation project(':shared_module_name')
    }
}

buildscript {
    ...
    dependencies {
        ...
        implementation("androidx.car.app:app-automotive:car_app_library_version")
        implementation(project(":shared_module_name"))
    }
}

宣告支援 Android Automotive OS

使用下列資訊清單項目宣告您的應用程式支援 Android Automotive OS：

<application>
    ...
    <meta-data android:name="com.android.automotive"
        android:resource="@xml/automotive_app_desc"/>
    ...
</application>

這個資訊清單項目參照的 XML 檔案會宣告應用程式支援的汽車功能。

如要表示您擁有 Car App Library 應用程式，請在 Android Automotive OS 模組的 res/xml/ 目錄中新增名為 automotive_app_desc.xml 的 XML 檔案。此檔案應包含下列內容：

<automotiveApp>
    <uses name="template"/>
</automotiveApp>

宣告您的 CarAppService 和 CarAppActivity

和 Android Auto 一樣，Android Automotive OS 會使用您的 CarAppService 實作來執行應用程式。如需實作及宣告 CarAppService 的操作說明，請參閱「建立 CarAppService 與工作階段」和「宣告 CarAppService」相關說明。

與 Android Auto 不同，您必須加入其他應用程式元件 CarAppActivity，做為 Android Automotive OS 應用程式的進入點。這項活動的實作包含在 androidx.car.app:app-automotive 成果中，且負責與範本主機應用程式通訊，以轉譯應用程式的使用者介面。您的資訊清單中應該只會有這個活動的一個例項，而且必須按照以下方式宣告：

<activity
    android:exported="true"
    android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
    android:name="androidx.car.app.activity.CarAppActivity"
    android:launchMode="singleTask"
    android:label="Your app name">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <meta-data android:name="distractionOptimized" android:value="true" />

</activity>

• android:name 會設為 app-automotive 構件中的 CarAppActivity 類別完整類別名稱。
• android:exported 設為 true，因為活動必須由應用程式本身 (即啟動器) 以外的應用程式啟動。
• android:launchMode 設為 singleTask，因此使用者在離開時，可以從啟動器返回相同的活動例項。
• android:theme 設為 @android:style/Theme.DeviceDefault.NoActionBar，因此應用程式會佔用可用的全螢幕空間。
• 意圖篩選器表示這是應用程式的啟動器活動。
• 有一個 <meta-data> 元素會指示 OS 可在設有使用者體驗限制時使用應用程式，例如車輛處於動作狀態。

導航應用程式的其他規定

如果是導覽應用程式，CarAppActivity 還有一些必要的資訊清單項目，如以下程式碼片段所示：

<activity
    android:exported="true"
    android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
    android:name="androidx.car.app.activity.CarAppActivity"
    android:launchMode="singleTask"
    android:label="Your app name">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
        <!-- Include the category below ONLY for navigation apps -->
        <category android:name="android.intent.category.APP_MAPS" />
    </intent-filter>

    <!-- Include the intent-filter below ONLY for navigation apps -->
    <intent-filter>
        <action android:name="androidx.car.app.action.NAVIGATE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="geo" />
    </intent-filter>

    <meta-data android:name="distractionOptimized" android:value="true" />

</activity>

• 其他 android.intent.category.APP_MAPS 類別會告知系統，應用程式可以顯示使用者的位置資訊。
• androidx.car.app.action.NAVIGATE 意圖篩選器可確保使用者在處理來自其他車輛應用程式的隱含導航意圖時，可以選擇使用您的應用程式。

其他考量

開發 Android Automotive OS 應用程式時，請考量下列幾點：

套件名稱

由於您發布了 Android Automotive OS 專用的獨立 Android 應用程式套件 (APK)，因此可以重複使用您行動應用程式中的套件名稱，或者建立新的套件名稱。如果您使用其他套件名稱，應用程式會有兩筆獨立的 Play 商店資訊。若重複使用既有套件名稱，應用程式則會在兩個平台共用同一筆商店資訊。

您可以依據業務考量決定採用哪一種做法。舉例來說，假設您有一個團隊負責開發行動應用程式，而另一個獨立的團隊負責開發 Android Automotive OS 應用程式，就非常適合使用不同的套件名稱，讓兩個團隊各自管理自己的 Play 商店資訊。無論採用哪一種方式，在技術上所需投入的人力差異不大。

下表摘要說明保留既有套件名稱與使用新套件名稱之間的其他主要差異：

離線內容

在適用情況下，請為應用程式實作離線支援功能。一般來說，搭載 Android Automotive OS 的車輛應具備專屬的數據連線，也就是內含於車輛費用或使用者付費的數據方案。不過，與行動裝置相較，車輛也應提供更多樣化的連線方式。

將離線支援策略納入考量時，請留意下列事項：

• 應用程式正在使用的當下是下載內容的最佳時機。
• 請勿假設有可供使用的 Wi-Fi。車輛可能未進入 Wi-Fi 訊號範圍內，或者原始設備製造商 (OEM) 可能偏好使用行動網路，因而停用了 Wi-Fi。
• 儘管可以使用智慧型快取機制，下載您預期使用者會使用的內容，我們仍建議您讓使用者變更這項行為。
• 車輛上的磁碟空間各有不同，因此請讓使用者能夠透過特定方式刪除離線內容。

常見問題

以下各節提供 Android Automotive OS 常見問題的解答。

使用第三方 SDK 和程式庫是否有任何限制或建議？

我們並未針對第三方 SDK 和程式庫制定具體的使用規範。如果選擇使用第三方 SDK 和程式庫，您仍須遵守所有汽車應用程式品質規定。

如何透過 Google Play 管理中心發布 Android Automotive OS 應用程式？

應用程式發布程序與手機應用程式的發布程序很類似，但須使用不同的板型規格。如要讓應用程式採用 Android Automotive OS 版本類型，請按照下列步驟操作：

1. 開啟 Play 管理中心。
2. 選取應用程式。
3. 在左選單中依序選取「發布」>「設定」>「進階設定」>「板型規格」。
4. 依序選取「新增板型規格」>「Android Automotive OS」，然後按照 Play 管理中心的指示操作。

疑難排解

請參閱下文，瞭解常見的 Android Automotive OS 疑難排解情境。

• 即使已從系統設定解除安裝 Car App Library 應用程式，嘗試安裝新的版本時仍收到錯誤訊息。

  如要確保應用程式已解除安裝，請使用 adb uninstall app.package.name 指令。