L'outil androidtestrunner

Introduction

L'outil androidtestrunner permet d'exécuter des tests Qt Test sur des appareils et émulateurs Android. Il automatise les étapes nécessaires à l'exécution des tests, y compris la gestion de l'installation de l'APK, l'exécution des tests et la récupération des résultats.

Avant d'utiliser l'outil androidtestrunner, assurez-vous d'avoir configuré votre projet de test Qt Test avec CMake ou qmake.

Fonctionnement

  1. Tout d'abord, il commence par exécuter la commande APK build pour générer l'APK requis pour le test.
  2. Ensuite, il installe l'application de test sur l'appareil cible et démarre l'application de test, lançant ainsi le processus de test.
  3. Les résultats des tests sont écrits dans le répertoire de données de l'application sur l'appareil, ce qui permet de s'assurer que tous les résultats des tests sont capturés.
  4. Une fois les tests terminés, le programme d'exécution écrit un fichier de code de sortie à côté des fichiers de résultats.
  5. À ce stade, le site androidtestrunner récupère ces fichiers de résultats sur l'appareil, en examinant le code de sortie à la recherche d'échecs.
  6. Si des problèmes sont détectés, il imprime immédiatement les journaux logcat de l'application, y compris toute trace de pile de crash potentielle, qui est embellie pour révéler les noms de fichiers et les numéros de lignes pour chaque image. En outre, il capture et rapporte les journaux de l'application qui ne répond pas (ANR) si de tels événements se produisent au cours de l'exécution du test.

Pour améliorer l'expérience d'intégration, le test runner propage les variables d'environnement QT ou QTEST de l'environnement hôte du processus de test runner à l'application, assurant ainsi la cohérence et un flux de travail de test transparent.

Exécution de tests avec l'enveloppe de test

Voici un exemple qui exécute le test tst_android sur une instance d'émulateur spécifique, en passant une variable d'environnement et en exécutant uniquement le cas de test testAssets:

ANDROID_SERIAL=emulator-5554 QT_DEBUG_PLUGINS=1 ./tst_android testAssets

Récupération des résultats

Par défaut, et si la sortie de test stdout n'est pas explicitement désactivée, les résultats du test sont imprimés sur l'hôte au fur et à mesure de l'exécution du test. Après l'exécution des tests, tous les fichiers de test explicitement demandés sont extraits dans le chemin de sortie spécifié avec leurs formats respectifs.

Pour plus de détails sur le cadre Qt Test, voir Qt Test Overview.

Comment l'utiliser

La syntaxe de base pour exécuter le site androidtestrunner est la suivante :

androidtestrunner [ARGUMENTS] -- [TESTARGS]

Pour exécuter le test sur un appareil/émulateur spécifique, utilisez la variable d'environnement adb ANDROID_SERIAL ou ANDROID_DEVICE_SERIAL.

Arguments obligatoires

Le programme d'exécution des tests s'attend toujours à ce que les arguments suivants soient transmis :

  • --path <build-path>: Le chemin où le paquetage Android Gradle est construit, généralement sous android-build-testname.
  • --make <build-command>: La commande utilisée pour construire l'APK de test, par exemple, cmake --build <build-dir> --target <target>_make_apk.

    Note : Passez cet argument entre guillemets afin qu'il ne soit pas traité comme plusieurs arguments du programme de test mais comme la valeur de l'argument --make.

  • --apk <apk-path>: Le chemin d'accès à l'APK de test généré par la commande de compilation et installé sur l'appareil.

Arguments optionnels

Vous pouvez également passer les arguments optionnels suivants :

  • --adb <adb-path>: Spécifie un chemin de commande ADB personnalisé. Par défaut, il s'agit du chemin adb trouvé dans le système $PATH.
  • --activity <activity-name>: Spécifie une activité personnalisée à exécuter. Par défaut, il s'agit de la première activité définie dans le fichier AndroidManifest.xml.
  • --timeout <seconds>: Définit le délai d'exécution du test. La valeur par défaut est de 600 secondes (10 minutes).
  • --skip-install-root: Évite d'ajouter INSTALL_ROOT à la commande make et est principalement utile lors de l'utilisation de qmake.
  • --show-logcat: Imprime la sortie logcat sur stdout indépendamment de l'échec du test. Les journaux sont imprimés en cas d'échec et peuvent inclure des traces de piles de crash ou des événements ANR.
  • --ndk-stack <command-path>: Spécifie le chemin d'accès à l'outil ndk-stack pour symboliser les traces de piles de crash. Par défaut, le chemin d'accès à l'outil se trouve à l'adresse $ANDROID_NDK_ROOT.
  • --pre-test-adb-command <command>: appelle la <commande> adb après l'installation et avant l'exécution du test.
  • -- <arguments>: Passe tout ce qui se trouve après les tirets comme arguments de test.
  • --verbose: Imprime une sortie verbeuse.
  • --help: Affiche les informations d'aide.

Exemple d'utilisation

Voici un exemple qui exécute le test tst_android, en exécutant uniquement le cas de test testAssets:

androidtestrunner \
    --path ~/tst_android/build/android-build-tst_openssl \
    --make "cmake --build ~/tst_android/build --target apk" \
    --apk ~/tst_android/build/android-build-tst_openssl/tst_openssl.apk \
    --skip-install-root \
    testAssets

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.