OS Manuals

/usr/lib/qt6/bin/harmonyostestrunner

qt

From qt6-qtbase 6.12.0-r1 (os), captured 2026-11-05 by running harmonyostestrunner --help (exit 0). permalink

Detected locale "C" with character encoding "ANSI_X3.4-1968", which is not UTF-8.
Qt depends on a UTF-8 locale, and has switched to "C.UTF-8" instead.
If this causes problems, reconfigure your locale. See the locale(1) manual
for more information.
Usage: /usr/lib/qt6/bin/harmonyostestrunner [options] test-binary
Runs a single Qt auto test from an installed HarmonyOS test bundle HAP.

Options:
  -h, --help                       Displays help on commandline options.
  --help-all                       Displays help, including generic Qt options.
  -v, --version                    Displays version information.
  --bundle-name <name>             HarmonyOS bundle name of the installed test
                                   HAP (env: QT_HARMONYOS_BUNDLE_NAME)
  --ability-name <name>            HarmonyOS ability name inside the test HAP
                                   (env: QT_HARMONYOS_ABILITY_NAME)
  --hdc <path>                     Path to the hdc tool (env: QT_HARMONYOS_HDC)
  --timeout <seconds>              Seconds to wait for a test to complete
                                   before aborting (env:
                                   QT_HARMONYOS_TEST_TIMEOUT)
  --no-progress-timeout <seconds>  Seconds without a PASS/FAIL test case result
                                   before declaring the test hung (env:
                                   QT_HARMONYOS_NO_PROGRESS_TIMEOUT, 0 =
                                   disabled)
  --device <key>                   hdc connect key (-t) for the target device —
                                   required when multiple devices are attached
                                   (env: QT_HARMONYOS_DEVICE)
  --test-config <path>             Generated test bundle deployment settings,
                                   read for the system dialogs the runner has to
                                   answer (env: QT_HARMONYOS_TEST_CONFIG)
  --test-env <vars>                Semicolon-separated NAME=VALUE pairs to set
                                   in the test environment (env:
                                   QT_HARMONYOS_TEST_ENV)

Arguments:
  test-binary                      Path to the test shared library (e.g.
                                   /path/to/libtst_qobject.so)
Options (11)
OptionDescriptionSource
-h, --helpDisplays help on commandline options.help
--help-allDisplays help, including generic Qt options.help
-v, --versionDisplays version information.help
--bundle-name nameHarmonyOS bundle name of the installed test HAP (env: QT_HARMONYOS_BUNDLE_NAME)help
--ability-name nameHarmonyOS ability name inside the test HAP (env: QT_HARMONYOS_ABILITY_NAME)help
--hdc pathPath to the hdc tool (env: QT_HARMONYOS_HDC)help
--timeout secondsSeconds to wait for a test to complete before aborting (env: QT_HARMONYOS_TEST_TIMEOUT)help
--no-progress-timeout secondsSeconds without a PASS/FAIL test case result before declaring the test hung (env: QT_HARMONYOS_NO_PROGRESS_TIMEOUT, 0 = disabled)help
--device keyhdc connect key (-t) for the target device — required when multiple devices are attached (env: QT_HARMONYOS_DEVICE)help
--test-config pathGenerated test bundle deployment settings, read for the system dialogs the runner has to answer (env: QT_HARMONYOS_TEST_CONFIG)help
--test-env varsSemicolon-separated NAME=VALUE pairs to set in the test environment (env: QT_HARMONYOS_TEST_ENV)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.