Tests de téléphonie ACTS

La suite Android Comms Test Suite (ACTS) effectue des tests automatisés des piles de connectivité, telles que le Wi-Fi, le Bluetooth et les services mobiles. L'outil de test nécessite adb et Python. Cet outil se trouve dans tools/test/connectivity/acts.

Cette page explique comment exécuter les tests de téléphonie de base disponibles dans le projet Android Open Source (AOSP) pour un utilisateur disposant de deux téléphones.

Conditions préalables

Pour exécuter des tests de téléphonie ACTS, vous devez avoir accès à un dépôt Android complet et installer les versions userdebug sur les appareils que vous souhaitez tester.

Télécharger un dépôt Android

Suivez les instructions de la section Télécharger la source pour télécharger un dépôt Android sur une machine disposant d'une connexion USB sur les appareils que vous souhaitez tester.

  • AOSP est un codebase de plusieurs gigaoctets qui continue de croître. Ajustez vos attentes en termes de temps de téléchargement en conséquence.
    • Si la taille d'une machine est limitée, ajoutez --depth=1 à la commande repo init.
  • Pour obtenir les futures mises à jour sur les outils ACTS, accédez au répertoire racine Android :
    • Utiliser "repo sync tools/test/connectivity"
    • et repo sync external/sl4a

Vérifier les compilations userdebug sur les appareils

Installez une version userdebug d'Android sur vos appareils de test.

  • Créez le dépôt en suivant les instructions de la section Compiler Android.
  • Flashez l'appareil comme décrit dans la section Flasher un appareil.
    • La commande adb shell getprop ro.build.type doit renvoyer userdebug.
    • Si ro.build.type n'est pas disponible, une version userdebug permet d'exécuter l'interface système adb en tant que racine (terminal #).

Compiler et installer SL4A

Pour créer et installer une couche de script pour Android (SL4A), suivez les instructions de la section Couche de script pour Android. La section Ajouter des builds SL4A aux builds Android par défaut est facultative.

Après avoir créé le SLA4, le dernier message de journal contient l'emplacement du fichier sl4a.apk, que vous devez installer sur TOUS les appareils. Voici un exemple de message de journal:

Copy: out/target/path/to/sl4a.apk

Configurer les appareils à tester

Configurez les appareils selon ces exigences de compilation et d'outil ACTS:

  • Si les clés de fournisseur ADB ne sont pas disponibles, appuyez sur le pop-up Indiquer que cet ordinateur est fiable sur l'appareil testé. Si des clés de fournisseur ADB sont disponibles:

    • Les clés et pilotes de fournisseur ADB doivent être uniques à l'appareil testé.
    • Pour activer systématiquement le débogage USB, les clés de fournisseur ADB de votre arborescence source doivent être ajoutées à ~/.bashrc (ou équivalent) à l'aide de export ADB_VENDOR_KEYS=/path/to/directory/with/vendor/keys, où /path/to/directory est votre chemin d'accès complet sur l'hôte. Pour résoudre les problèmes liés à ADB, consultez Exécuter des applications sur un appareil matériel.

  • Autoriser le débogage USB: lorsque les pilotes adb sont installés, les appareils adb peuvent déclencher une invite sur l'appareil pour autoriser le débogage USB.

  • Installer sl4a.apk avec $ adb install -r <ANDROID_ROOT>/path/to/sl4a.apk

  • Assurez-vous que les téléphones utilisent une connexion USB 2.0 vers le serveur de test.

  • Ces tests dépendent des réseaux mobiles actifs. Par conséquent, placez des cartes SIM dans les téléphones et maintenez-les dans un endroit où le réseau mobile est de bonne qualité.

  • Ajoutez toutes les cartes SIM à un fichier JSON, comme décrit dans la section Écrire un fichier de configuration.

Configurer l'environnement

Avant de configurer l'environnement, vérifiez que Python 3.4 ou version ultérieure est installé.

Exécutez la commande suivante:

sudo apt-get install python3-setuptools
sudo apt-get install python3-pip
sudo pip3 install --upgrade pip setuptools
sudo apt-get install protobuf-compiler

Installer ACTS

Exécutez la commande suivante:

cd <ANDROID_ROOT>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -

Pour vérifier l'installation, exécutez act.py -h, qui affiche la liste des commandes disponibles.

Écrire un fichier de configuration

Pour exécuter des tests, vous devez créer un fichier contenant les informations de configuration. Voici un exemple de fichier .config. Un fichier similaire est disponible dans le dépôt Android sous tools/test/connectivity/acts/framework/sample_config.json. Remplacez XXXXXXX par les numéros de série des appareils pour fournir les informations minimales dont ACTS a besoin pour effectuer un test téléphonique.

{
  "_description": "Minimum Telephony Config",
  "testbed":
  [
      {
          "_description": "A testbed listing two AndroidDevices for adb.",
          "name": "ExampleTestBed",
          "AndroidDevice": [{"serial": "XXXXXXX", "adb_logcat_param": "-b all"},
                            {"serial": "XXXXXXX", "adb_logcat_param": "-b all"}]
      }
  ],
  "logpath": "/path/to/logs",
  "testpaths": "/path/to/android/repo/tools/test/connectivity",
  "sim_conf_file": "/path/to/simcard_list.json"
}

Utilisez les clés du tableau pour configurer les paramètres de test. Pour plus d'options, consultez la section Options de configuration supplémentaires.

Clé Valeur
_description Commenter le contenu de l'intégralité du fichier de configuration
testbed Spécification d'un environnement dans lequel les tests peuvent s'exécuter
(testbed) _description Commenter chaque environnement de test, car les outils ACTS peuvent cibler des zones de test individuelles
(testbed) name Nom du testbed pour l'appel depuis la ligne de commande
(testbed) AndroidDevice Liste des appareils spécifiques ciblés par le test
Remarque:Plusieurs appareils peuvent être répertoriés. Un test qui exécute des appels de téléphones entre eux s'attend à ce qu'il y ait deux appareils et échoue s'il y en a moins. Si deux appareils sont répertoriés et que le test n'en attend qu'un, il est exécuté sur le premier.
(testbed)(Appareil Android) serial Numéro de série de l'appareil (imprimé depuis adb devices)
(testbed)(Appareil Android) adb_logcat_param Paramètres transmis lorsque adb logcat est appelé lors des tests
logpath L'emplacement où les journaux sont enregistrés sur le serveur de test
testpaths Emplacement du code du scénario de test
sim_conf_file Emplacement du fichier .json qui répertorie les cartes SIM disponibles
La liste des cartes SIM inclut l'ID de la carte, les caractéristiques de la carte, l'opérateur et le numéro de téléphone. 
{
    "sim-card-ID-here": {
        "capability": [
            "voice",
            "ims",
            "volte",
            "vt",
            "sms",
            "tethering",
            "data"
        ],
        "operator": "tmo",
        "phone_num": "12345678901"
    },
...
}

Vous pouvez extraire le numéro de téléphone de l'appareil sous Système > À propos du téléphone. L'ID de la carte SIM est généralement imprimé sur la carte SIM ou disponible sur l'appareil sous Système > À propos du téléphone > État de la carte SIM. La chaîne d'opérateur est définie à l'emplacement tools/test/connectivity/acts_tests/acts_contrib/test_utils/tel/tel_defines.py, puis recherchez CARRIER_.

Options de configuration supplémentaires

Le fichier entries.py situé à l'emplacement tools/test/connectivity/acts/framework/acts/config/entries.py du dépôt Android contient les définitions des principales options de configuration de ligne de commande.

Vous pouvez également trouver des paramètres spécifiques aux tests dans le code en recherchant self.user_params.get.

Exécuter des tests

Exécutez les tests à partir de la ligne de commande une fois le fichier de configuration écrit. Bien qu'il existe de nombreuses options, la plus simple consiste à utiliser -c filename.config -tc TestCase:name. Cet exemple utilise un fichier de configuration nommé minimum.config:

act.py -c minimum.config -tc TelLiveVoiceTest:test_call_mo_voice_general

Si l'exécution du test réussit, un message de sortie final semblable à celui-ci doit s'afficher:

INFO Summary for test run ExampleTestBed@yyyy-mm-dd_15-23-43-614: Requested 1,
Executed 1, Passed 1, Failed 0, Skipped 0, Error 0

Exécuter plusieurs tests

Pour exécuter des scénarios de test spécifiques sur plusieurs fichiers, créez un fichier de test et transmettez-le avec l'option -tf , comme illustré dans l'exemple de suite de tests de régression:

TelLiveVoiceTest:
test_call_mo_voice_general,
test_call_volte_to_volte,
test_call_3g_to_3g

TelLiveDataTest:
test_airplane_mode,
test_4g,
test_3g

TelLiveSmsTest:
test_sms_mo_4g,
test_sms_mt_4g,
test_sms_mo_3g,
test_sms_mt_3g,
test_mms_mo_4g,
test_mms_mt_4g

Cet exemple de commande suppose que le fichier s'appelle regression_suite.

act.py -c minimum.config -tf regression_suite

Exécuter des tests plusieurs fois

Pour exécuter un scénario de test (-tc) ou un fichier de test (-tf) plusieurs fois, ajoutez -ti # (itérations de test) à la commande.