Руководство по интеграции хоста AOSP

Хост автомобильных приложений Android Open Source Project (AOSP) — это часть библиотеки автомобильных приложений, используемая сторонними (3P) разработчиками для включения приложений для Android Automotive. App Host — это системное приложение, которое позволяет 3P-приложениям для автомобилей отображать компоненты пользовательского интерфейса (UI) в OEM-стиле от его имени.

Для запуска 3P-приложений необходимо установить как приложение 3P, так и хост приложений AOSP Automotive:

  • Automotive App Host предоставляет 3P-приложениям набор шаблонов пользовательского интерфейса и компонентов, оптимизированных для транспортных средств, включая такие возможности, как удобство использования и безопасность.
  • OEM-производители могут стилизовать эти шаблоны и компоненты пользовательского интерфейса.
  • Результат? Приложения 3P визуально хорошо интегрированы в информационно-развлекательную систему OEM-производителя.

На этой странице объясняется, как создать хост автомобильных приложений AOSP из проекта Gradle в ветке ub-automotive , а затем как интегрировать хост автомобильных приложений AOSP в автомобильные цели.

Проверьте код

Чтобы проверить несвязанный код:

  1. Выполните следующую команду:
    repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
    repo sync -j4
  2. Дополнительные сведения о работе с исходным кодом AOSP см. в разделе Инициализация клиента репо .

  3. Установите Андроид Студию .

Создайте APK-файл хоста AOSP.

  1. Проверьте ub-automotive , а затем откройте проект Gradle в packages/apps/Car/Templates/Host .
  2. Чтобы настроить проект с помощью Android SDK, настройте файл local.properties вашего проекта. Путь можно найти в настройках Android SDK в Android Studio.
    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 .