AOSP主機整合指南

Android 開源專案 (AOSP) 汽車應用程式主機是汽車應用程式庫的一部分,第三方 (3P) 開發人員使用該程式庫來為 Android Automotive 啟用應用程式。 App Host 是一個系統應用程序,允許 3P 汽車應用程式代表其呈現 OEM 風格的使用者介面 (UI) 元件。

要運行 3P 應用程序,必須安裝 3P 應用程式和 AOSP Automotive App Host:

  • Automotive App Host 為 3P 應用程式提供了一組針對車輛最佳化的 UI 模板和元件,包括可用性和安全性等功能。
  • OEM 可以設計這些 UI 模板和元件的樣式。
  • 結果? 3P 應用程式在視覺上很好地整合到 OEM 的資訊娛樂系統中。

本頁介紹如何從ub-automotive分支中的 Gradle 專案產生 AOSP Automotive App Host,以及如何將 AOSP Automotive App Host 整合到汽車目標中。

檢視程式碼

若要查看未捆綁的程式碼:

  1. 執行以下指令:
    repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
    repo sync -j4
    
  2. 要了解有關使用 AOSP 原始程式碼的更多信息,請參閱初始化 Repo 用戶端

  3. 安裝Android Studio

創建 AOSP 主機 APK

  1. 查看ub-automotive ,然後開啟packages/apps/Car/Templates/Host下的 Gradle 專案。
  2. 若要使用 Android SDK 設定項目,請設定專案的local.properties檔案。您可以在 Android Studio 的 Android SDK 設定下找到路徑。
    sdk.dir=${path_to_android_sdk_location}
    
  3. 建立主機 APK 作為典型的 Gradle 專案。例如,執行gradle指令:
    ./gradlew :app:assembleDebug
    

    APK檔案位於:

    packages/apps/Car/Templates/Host/app/build/outputs/apk/debug/app-debug.apk

嵌入 AOSP 主機

  1. 建立一個新的Android.mk檔案以包含以下內容:
    LOCAL_PATH := $(my-dir)
    ################## Start of AOSPHost target ##################
    include $(CLEAR_VARS)
    LOCAL_MODULE := CarAOSPHost
    LOCAL_LICENSE_KINDS := legacy_notice
    LOCAL_LICENSE_CONDITIONS := notice
    LOCAL_MODULE_OWNER := google
    LOCAL_SRC_FILES := AOSPHost.apk
    LOCAL_MODULE_CLASS := APPS
    LOCAL_MODULE_TAGS := optional
    LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
    LOCAL_BUILT_MODULE_STEM := package.apk
    LOCAL_CERTIFICATE := PRESIGNED
    LOCAL_PRIVILEGED_MODULE := true
    LOCAL_PRODUCT_MODULE := true
    LOCAL_DEX_PREOPT := false
    include $(BUILD_PREBUILT)
    
  2. app-debug.apk重新命名為AOSPHost.apk並將 APK 放在與Android.mk相同的資料夾中。
  3. CarAOSPHost模組新增至您的目標作為PRODUCT_PACKAGES
    PRODUCT_PACKAGES += \
       CarAOSPHost \
    

新增權限配置

  1. 建立一個名為com.android.car.templates.host.xml的檔案以包含以下內容:
    <permissions>
        <!-- Rename the package to com.android.car.templates.host -->
        <privapp-permissions package="com.android.car.templates.host">
            <!-- To be able to display activities in the cluster -->
            <permission name="android.car.permission.CAR_DISPLAY_IN_CLUSTER" />
    
            <!-- To be able to show navigation state (turn by turn directions) in the cluster.-->
            <permission name="android.car.permission.CAR_NAVIGATION_MANAGER" />
    
            <!-- To be considered a system-approved host -->
            <permission name="android.car.permission.TEMPLATE_RENDERER" />
        </privapp-permissions>
    
        <!-- Declare support for templated applications. -->
        <feature name="android.software.car.templates_host" />
    </permissions>
    
  2. 在您的目標中,將設定檔新增至您的目標:
    PRODUCT_COPY_FILES += \
        <the file root>/com.android.car.templates.host.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/com.android.car.templates.host.xml
    

建立目標

當您建置目標時,將安裝主機並授予權限:

      …
      android.car.permission.CAR_NAVIGATION_MANAGER: granted=true
      android.car.permission.CAR_DISPLAY_IN_CLUSTER: granted=true
      android.car.permission.TEMPLATE_RENDERER: granted=true
      …

測試集成

若要建置和安裝範例,請參閱此 GitHub 專案car-samples/car_app_library