Intégrer l'hôte AOSP

L'hôte d'applications Android Open Source Project (AOSP) Automotive fait partie de la bibliothèque d'applications pour voitures utilisée par les développeurs tiers pour activer les applications pour Android Automotive. L'hôte d'applications est une application système qui permet aux applications pour voitures tierces de générer des composants d'interface utilisateur de style OEM en son nom.

Pour exécuter des applications tierces, l'application tierce et l'hôte d'applications AOSP Automotive doivent être installés :

• L'hôte d'applications Automotive fournit aux applications tierces un ensemble de modèles et de composants d'interface utilisateur optimisés pour les véhicules, y compris des fonctionnalités telles que l'ergonomie et la sécurité.
• Les OEM peuvent personnaliser ces modèles et composants d'interface utilisateur.
• Résultat Les applications tierces sont visuellement bien intégrées au système d'infodivertissement de l'OEM.

Cette page explique comment générer l'hôte d'applications AOSP Automotive à partir du projet Gradle dans la branche ub-automotive, puis comment l'intégrer dans des cibles de voiture.

Consulter le code

Pour consulter le code non groupé :

1. Exécutez la commande suivante :

   repo init -u https://android.googlesource.com/platform/manifest -b ub-automotive-master
   repo sync -j4

2. Pour en savoir plus sur l'utilisation du code source AOSP, consultez Initialiser le client Repo.

3. Installez Android Studio.

Créer l'APK hôte AOSP

1. Extrayez ub-automotive, puis ouvrez le projet Gradle sous packages/apps/Car/Templates/Host.
2. Pour configurer le projet avec le SDK Android, configurez le fichier local.properties de votre projet. Vous trouverez le chemin d'accès sous Paramètres du SDK Android dans Android Studio.

   sdk.dir=${path_to_android_sdk_location}

3. Créez l'APK hôte en tant que projet Gradle standard. Par exemple, exécutez la gradle commande :

   ./gradlew :app:assembleDebug

   Le fichier APK se trouve dans :

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

Intégrer l'hôte AOSP

1. Créez un fichier Android.mk pour inclure le contenu suivant :

   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. Renommez app-debug.apk en AOSPHost.apk et placez l'APK dans le même dossier que Android.mk.
3. Ajoutez le module CarAOSPHost à vos cibles en tant que PRODUCT_PACKAGES :

   PRODUCT_PACKAGES += \
      CarAOSPHost \

Ajouter la configuration des autorisations

1. Créez un fichier nommé com.android.car.templates.host.xml contenant les éléments suivants :

   <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. Dans votre cible, ajoutez le fichier de configuration à vos cibles :

   PRODUCT_COPY_FILES += \
       <the file root>/com.android.car.templates.host.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/com.android.car.templates.host.xml

Créer la cible

Lorsque vous créez la cible, l'hôte est installé et l'autorisation est accordée :

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

Tester l'intégration

Pour créer et installer les exemples, consultez ce projet GitHub : car-samples/car_app_library.