Contrôles automobiles dans une boîte

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Complete Automotive Tests in a Box (CATBox) est un package Open Source qui fournit les frameworks et les outils nécessaires pour simplifier et exécuter des tests automobiles avec une configuration minimale. CATBox est évolutif et compatible avec les outils, l'infrastructure et les tests que vous utilisez pour tester et valider vos implémentations de l'OS Android Automotive (AAOS). Vous pouvez ainsi proposer des produits de haute qualité sur la place de marché.

Conception et implémentation de CATBox

La suite de tests CATBox fournit les outils, les frameworks et les tests nécessaires pour exécuter des tests fonctionnels et de performances sur un appareil cible automobile et lors de l'utilisation d'un appareil compagnon.

L'image suivante illustre une conception de haut niveau d'un package CATBox.

Figure 1 : Package CATBox

Tradefed

Tradefed est un framework de test continu Open Source utilisé pour exécuter des tests sur des appareils Android. Pour en savoir plus, consultez la section Présentation de la fédération de commerce.

Framework de test pour l'automobile

CATBox est basé sur un framework de test automobile appelé Spectatio, qui fournit des API pour tester diverses applications sur des appareils automobiles. Il est basé sur UI Automator, un framework de test Open Source qui fournit un ensemble d'API permettant de créer des tests d'interface utilisateur qui interagissent avec les applications utilisateur et système.

Téléchargements de la suite de tests CATBox

Android 14

Android Automotive 14 est la version du jalon de développement portant le nom de code U. Utilisez les liens suivants pour télécharger les suites de test CATBox pour Android 14:

• Android 14 (arm64)
• Android 14 (x86_64)

Android 12

Android 12 est la version du jalon de développement portant le nom de code S. Utilisez les liens suivants pour télécharger les suites de test CATBox pour Android 12:

• Android 12 (arm64)
• Android 12 (x86_64)

Android 11

Android 11 est la version du jalon de développement portant le nom de code R. Utilisez les liens suivants pour télécharger les suites de test CATBox pour Android 11:

• Android 11 (arm64)
• Android 11 (x86_64)

Créer CATBox

Utilisez la commande de compilation catbox une fois que le code AOSP Android est disponible sur la station de travail locale.

Pour créer le package CATBox en local:

1. Sélectionnez la cible d'appareil en fonction de l'architecture de l'appareil, puis exécutez la commande suivante:

   lunch <target>

2. Pour compiler CATBox, exécutez la commande suivante:

   make catbox

   Cette commande crée le fichier android-catbox.zip dans le répertoire /out/host/linux-x86/catbox, qui peut ensuite être utilisé pour exécuter des tests.

Configurer l'environnement

La configuration de l'environnement requise pour exécuter les tests CATBox est semblable à la configuration de CTS. Pour configurer l'environnement, procédez comme suit:

• Installez ADB et AAPT.

• Installez le JDK. Consultez la page Kit de développement Java pour Ubuntu.

• Augmentez la limite de mémoire. Consultez les conditions requises en termes de stockage.

Configurer et exécuter CATBox

Utilisez le framework de test Tradefed pour exécuter les tests sur des appareils Android. Avant de configurer CATBox, consultez la présentation de la Trade Federation.

Pour configurer et exécuter CATBox, consultez les sections ci-dessous.

Configurer l'appareil

Avant d'exécuter un plan de test, configurez votre appareil en procédant comme suit:

1. Assurez-vous d'avoir installé les versions récentes de Android Debug Bridge (adb) et de Android Asset Packaging Tool (AAPT), et d'avoir ajouté l'emplacement de ces outils au chemin d'accès système de votre machine. Pour en savoir plus, consultez ADB et AAPT.

2. Connectez au moins un appareil et préparez l'appareil testé comme suit:

   1. Pour rétablir la configuration d'usine de l'appareil automobile, accédez à Paramètres > Système > Options de réinitialisation > Effacer toutes les données.

   2. Attendez que l'appareil redémarre automatiquement.

   3. Assurez-vous qu'adb est activé. Pour vérifier que l'appareil est disponible, exécutez la commande suivante:

      adb devices

   4. Pour activer l'utilisateur racine, exécutez la commande suivante:

      adb -s DEVICE_SERIAL root

      Remplacez DEVICE_SERIAL par l'ID de série de l'appareil automobile.

   5. Connectez-vous à un réseau Wi-Fi.

Extraire le package CATBox

Après avoir configuré l'appareil, décompressez le package CATBox et accédez au dossier extrait:

unzip android-catbox.zip
cd android-catbox

Exécuter des tests dans CATBox

Pour exécuter CATBox avec les plans de test du package CATBox:

./tools/catbox-tradefed run commandAndExit TEST_PLAN_NAME --serial DEVICE_SERIAL

Remplacez DEVICE_SERIAL par l'ID de série de l'appareil automobile. Si plusieurs appareils sont connectés à la machine hôte, utilisez DEVICE_SERIAL pour les distinguer. Remplacez TEST_PLAN_NAME par le nom du plan de test que vous souhaitez exécuter.

Pour obtenir la liste la plus complète des forfaits disponibles, utilisez la ligne de commande:

./tools/catbox-tradefed list plans | grep -i catbox

Types de plans de test

Le tableau suivant présente les plans de test fonctionnels disponibles.

Le tableau suivant répertorie les plans de test de performances de CATBox.

Exécuter le test côté hôte multi-appareil

L'exécution des tests côté hôte multi-appareils utilise CATBox pour exécuter le test en une seule session. Par exemple, BTDiscoveryTest:

make catbox
./tools/catbox-tradefed run commandAndExit catbox-functional-bluetooth-tests --{phone}serial <serial> --{auto}serial <serial> --mobly-host:mobly-par-file-name BTDiscoveryTest

CATBox installe le apk, puis le test est exécuté dans l'environnement d'exécution Python approprié.

Examiner les résultats du test CATBox

Les résultats des cycles de test fonctionnels et de performances sont enregistrés dans android-catbox/results/latest.