Guide d'intégration de l'hôte AOSP

L'hôte d'applications automobiles du projet Android Open Source (AOSP) fait partie de la bibliothèque d'applications automobiles utilisée par des développeurs tiers (3P) pour activer des applications pour Android Automotive. L'App Host est une application système qui permet aux applications de voiture 3P de restituer en son nom des composants d'interface utilisateur (UI) de style OEM.

Pour exécuter des applications 3P, l'application 3P et l'AOSP Automotive App Host doivent être installés :

  • Automotive App Host fournit des applications 3P avec un ensemble de modèles et de composants d'interface utilisateur optimisés pour les véhicules, y compris des fonctionnalités telles que la convivialité et la sécurité.
  • Les OEM peuvent styliser ces modèles et composants d’interface utilisateur.
  • Le résultat? Les applications 3P sont visuellement bien intégrées au système d'infodivertissement du constructeur OEM.

Cette page explique comment générer l'AOSP Automotive App Host à partir du projet Gradle dans la branche ub-automotive , puis comment intégrer l'AOSP Automotive App Host dans les cibles automobiles.

Consultez le code

Pour consulter le code dé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 un client Repo .

  3. Installez Android Studio .

Créer l'APK hôte AOSP

  1. Découvrez 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 pouvez trouver le chemin 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 typique. Par exemple, exécutez la commande gradle :
    ./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 nouveau 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 appelé com.android.car.templates.host.xml pour contenir 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

Construire 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 .