harmonyostestrunner ツール

はじめに

harmonyostestrunner ツールは、HarmonyOSデバイスまたはエミュレータ上で単一のQt自動テストを実行し、その結果をホストに報告します。ctest を使用してテストを実行する場合、通常はCMakeのテストラッパーが自動的にそれを実行します。 テスト用HAPが1台のマシンでビルドされているが、デバイスが別のマシンに接続されている場合、またはテスト用HAPはあるが手元にCMakeビルドツリーがない場合に、これを直接呼び出してください。

このツールは、テストパッケージをビルドまたはインストールしません。代わりに、harmonydeployqtが（--test-bundle オプションを通じて）テストバイナリを単一のテストHAPにバンドルします。そのHAPを事前にビルド、署名し、デバイスにインストールしておく必要があります：

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

仕組み

1. ターゲットデバイスにテスト用バンドル HAP がインストールされていることを確認します。
2. 実行中のバンドルのインスタンスをすべて強制停止した後、aa start を使用して機能を開始し、どのテスト用共有ライブラリをロードするか、およびアプリケーションサンドボックス内でテストの標準出力と終了コードをどこにリダイレクトするかをプラットフォームに指示します。
3. テストの実行中、テストの標準出力をホストにストリーミングします。
4. テストが終了するのを待ち、exit-code ファイルが読み取り可能になった時点でテストの終了を検知します。ライブネスチェックによりプロセスのクラッシュを検知し、オプションのノープログレス・ウォッチドッグにより、PASS またはFAIL の結果を出力しなくなったテストを強制終了します。
5. テストがブロックするシステムダイアログを宣言しており、テストの出力が途絶えた場合、uitest を使用して画面レイアウトをダンプし、期待されるボタンをクリックします。
6. このウォッチドッグは、テストの終了コードを自身の終了コードとして返します。

使用方法

基本的な構文は次のとおりです：

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

<test-binary> 引数は、テスト用共有ライブラリへのパスです（例：libtst_qobject.so ）。このファイル名によって、バンドル内のどのテストを実行するかが決定されます。その後に続く部分（テスト関数名や-v2 など）は、ツールによってテストに渡しられます。

オプション

次の表は、harmonyostestrunner のコマンドラインオプションの一覧です。各オプションは、括弧内に示された環境変数を通じて設定できます。ただし、コマンドラインで指定された値が優先されます。

使用例

特定のデバイスで「tst_qobject 」テストを実行し、「signalsBlocked 」テストケースのみを実行します：

harmonyostestrunner --device 127.0.0.1:5555 libtst_qobject.so signalsBlocked

Qt Test フレームワークの詳細については、「Qt Test の概要」を参照してください。