Das Tool „harmonyostestrunner“

Einführung

Das Tool „ harmonyostestrunner “ führt einen einzelnen Qt-Autotest auf einem HarmonyOS-Gerät oder -Emulator aus und meldet das Ergebnis auf dem Host. Wenn Sie einen Test mit „ ctest “ ausführen, ruft der CMake-Test-Wrapper diesen normalerweise für Sie auf. Rufen Sie ihn direkt auf, wenn die Test-HAP auf einem Rechner erstellt wurde, das Gerät jedoch an einen anderen angeschlossen ist, oder wenn Sie eine Test-HAP, aber keinen CMake-Build-Baum zur Hand haben.

Dieses Tool erstellt oder installiert das Testpaket nicht. Stattdessen bündelt `harmonydeployqt ` die Test-Binärdateien zu einem einzigen Test-HAP (über die Option ` --test-bundle `). Sie müssen dieses HAP zuvor erstellen, signieren und auf dem Gerät installieren:

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

So funktioniert es

1. Es wird überprüft, ob das Test-Bundle-HAP auf dem Zielgerät installiert ist.
2. Es beendet alle laufenden Instanzen des Bundles zwangsweise und startet dann die Funktion mit ` aa start`, wobei der Plattform mitgeteilt wird, welche gemeinsame Testbibliothek geladen werden soll und wohin die Standardausgabe sowie der Exit-Code des Tests innerhalb der Anwendungs-Sandbox umgeleitet werden sollen.
3. Es überträgt die Standardausgabe des Tests während der Testausführung an den Host.
4. Es wartet auf den Abschluss des Tests, den es erkennt, sobald die Exit-Code-Datei lesbar wird. Eine Liveness-Prüfung erkennt einen abgestürzten Prozess, und ein optionaler No-Progress-Watchdog beendet zwangsweise einen Test, der keine Ergebnisse mehr über „ PASS “ oder „ FAIL “ liefert.
5. Wenn der Test blockierende Systemdialoge deklariert und die Ausgabe des Tests ausbleibt, speichert er das Bildschirmlayout mit „ uitest “ und klickt auf die erwartete Schaltfläche.
6. Er gibt den Beendigungscode des Tests als seinen eigenen Beendigungscode zurück.

Verwendung

Die grundlegende Syntax lautet:

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

Das Argument „ <test-binary> “ ist der Pfad zur geteilten Testbibliothek, zum Beispiel libtst_qobject.so. Der Dateiname bestimmt, welcher Test innerhalb des Bundles ausgeführt werden soll. Alles, was danach folgt, wie beispielsweise Namen von Testfunktionen oder „ -v2 “, leitet das Tool an den Test weiter.

Optionen

Die folgende Tabelle listet die Befehlszeilenoptionen von ` harmonyostestrunner` auf. Sie können jede Option über die in Klammern angegebene Umgebungsvariable festlegen. Der Wert in der Befehlszeile hat Vorrang.

Anwendungsbeispiel

Führen Sie den Test „ tst_qobject “ auf einem bestimmten Gerät aus und führen Sie dabei ausschließlich den Testfall „ signalsBlocked “ aus:

harmonyostestrunner --device 127.0.0.1:5555 libtst_qobject.so signalsBlocked

Weitere Informationen zum „ Qt Test “-Framework finden Sie unter „Qt Test – Übersicht“.