L'outil harmonyostestrunner

Introduction

L'outil harmonyostestrunner exécute un test automatique Qt unique sur un appareil ou un émulateur HarmonyOS et renvoie le résultat sur l'hôte. Lorsque vous lancez un test avec ` ctest`, le wrapper de test CMake s'en charge généralement pour vous. Lancez-le directement lorsque le HAP de test est compilé sur une machine mais que l'appareil est connecté à une autre, ou lorsque vous disposez d'un HAP de test mais pas d'arborescence de compilation CMake à portée de main.

Cet outil ne compile ni n’installe le paquet de test. À la place, harmonydeployqt regroupe les binaires de test dans un seul HAP de test (via son option « --test-bundle »). Vous devez au préalable compiler, signer et installer ce HAP sur l’appareil :

hdc install <path/to/autotests-signed.hap>

Fonctionnement

1. Il vérifie que le paquet HAP de test est bien installé sur l’appareil cible.
2. Il arrête de force toute instance en cours d’exécution du bundle, puis lance la fonctionnalité à l’aide de ` aa start`, en indiquant à la plateforme quelle bibliothèque partagée de test charger et où rediriger la sortie standard et le code de sortie du test au sein du bac à sable de l’application.
3. Il transmet en continu la sortie standard du test vers l’hôte pendant l’exécution de celui-ci.
4. Il attend la fin du test, qu’il détecte lorsque le fichier de code de sortie devient accessible en lecture. Un contrôle d’activité détecte les processus qui se sont bloqués, et un chien de garde optionnel « no-progress » arrête de force un test qui cesse de produire des résultats via ` PASS ` ou ` FAIL `.
5. Si le test déclare des boîtes de dialogue système bloquantes et que la sortie du test s’interrompt, il effectue une capture d’écran de la disposition de l’écran à l’aide de uitest et clique sur le bouton attendu.
6. Il renvoie le code de sortie du test comme son propre code de sortie.

Mode d’emploi

La syntaxe de base est la suivante :

harmonyostestrunner [OPTIONS] <test-binary> [TESTARGS]

L'argument « <test-binary> » correspond au chemin d'accès à la bibliothèque partagée de test, par exemple libtst_qobject.so. Le nom du fichier permet de sélectionner le test à exécuter au sein du bundle. Tout ce qui suit, comme les noms des fonctions de test ou « -v2 », est transmis par l'outil au test.

Options

Le tableau suivant répertorie les options de ligne de commande de ` harmonyostestrunner`. Vous pouvez définir chaque option via la variable d’environnement indiquée entre parenthèses. La valeur de la ligne de commande prévaut.

Exemple d'utilisation

Exécutez le test « tst_qobject » sur un appareil spécifique, en exécutant uniquement le scénario de test « signalsBlocked » :

harmonyostestrunner --device 127.0.0.1:5555 libtst_qobject.so signalsBlocked

Pour plus d’informations sur le framework « Qt Test », consultez la présentation de «Qt Test ».