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

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

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

• 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. Установите Android-студию .

Создайте 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 .