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 整合到汽車目標中。
檢視程式碼
若要查看未捆綁的程式碼:
- 執行以下指令:
repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master repo sync -j4
要了解有關使用 AOSP 原始程式碼的更多信息,請參閱初始化 Repo 用戶端。
- 安裝Android Studio 。
創建 AOSP 主機 APK
- 查看
ub-automotive
,然後開啟packages/apps/Car/Templates/Host
下的 Gradle 專案。 - 若要使用 Android SDK 設定項目,請設定專案的
local.properties
檔案。您可以在 Android Studio 的 Android SDK 設定下找到路徑。sdk.dir=${path_to_android_sdk_location}
- 建立主機 APK 作為典型的 Gradle 專案。例如,執行
gradle
指令:./gradlew :app:assembleDebug
APK檔案位於:
packages/apps/Car/Templates/Host/app/build/outputs/apk/debug/app-debug.apk
嵌入 AOSP 主機
- 建立一個新的
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)
- 將
app-debug.apk
重新命名為AOSPHost.apk
並將 APK 放在與Android.mk
相同的資料夾中。 - 將
CarAOSPHost
模組新增至您的目標作為PRODUCT_PACKAGES
:PRODUCT_PACKAGES += \ CarAOSPHost \
新增權限配置
- 建立一個名為
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>
- 在您的目標中,將設定檔新增至您的目標:
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 。