android CTS 命令

> h //help

Host:
  help: show this message
  help all: show the complete tradefed help
  exit: gracefully exit the cts console, waiting till all invocations are complete
Run:

run cts -t
  run cts --plan test_plan_name: run a test plan
  run cts --package/-p : run a CTS test package
  run cts --class/-c [--method/-m] : run a specific test class and/ormethod
  run cts --continue-session session_ID: run all not executed tests from a previous CTS session
  run cts [options] --serial/-s device_ID: run CTS on specified device
  run cts [options] --shards number_of_shards: shard a CTS run into given number of independent chunks, to run on multiple devices inparallel
  run cts --help/--help-all: get more help on running CTS
List:
  l/list d/devices: list connected devices and their state
  l/list packages: list CTS test packages
  l/list p/plans: list CTS test plans
  l/list i/invocations: list invocations aka CTS test runs currentlyin progress  当前CTS的运行状态
  l/list c/commands: list commands: aka CTS test run commands currently in the queue waiting to be allocated devices  展示出用户输入过的命令
  l/list r/results: list CTS results currently present in the repository
Add:
  add derivedplan --plan plane_name --session/-s session_id -r [pass/fail/notExecuted/timeout]: derive a plan from the given session
Dump:
  d/dump l/logs: dump the tradefed logs for all running invocations
Options:
  --disable-reboot : Do not reboot device after running some amount of tests.

-------------------------------------------------------------------------------------------------

run cts --help：

test options:
    --plan               the test plan to run.
    -p, --package        the test packages(s) to run.
    -c, --class          run a specific test class.
    -m, --method         run a specific test method, from given --class.
    -t, --test           run a specific test
    --continue-session   continue a previous test session.
    --force-abi          The abi to use, can be either 32 or 64.

'file' logger options:
    -l, --log-level-display       the minimum log level to display on stdout. Default: WARN. Valid values: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT]

run cts --help-all:

cmd_options options:
    --[no-]help          display the help text for the most important/critical options. Default: false.
    --[no-]help-all      display the full help text for all options. Default: false.
    --[no-]json-help     display the full help in json format. Default: false.
    --[no-]dry-run       build but don't actually run the command.  Intended as a quick check to ensure that a command is runnable. Default: false.
    --[no-]noisy-dry-run build but don't actually run the command.  This version prints the command to the console.  Intended for cmdfile debugging. Default: false.

--min-loop-time      the minimum invocation time in ms when in loop mode. Default: 600000.
    --max-random-loop-time
                         the maximum time to wait between invocation attempts when in loop mode. when set, the actual value will be a random number between min-loop-time and this number.
    --[no-]loop          keep running continuously. Default: false.

实例： run cts -c android.media.cts.MediaScannerConnectionTest -s 9A915A3E  --loop --min-loop-time 120000

--[no-]all-devices   fork this command to run on all connected devices. Default: false.
    --[no-]bugreport-on-invocation-ended      take a bugreport when the test invocation has ended Default: false.

device_requirements options:
    -s, --serial            run this test on a specific device with given serial number(s).
    --exclude-serial     run this test on any device except those with this serial number(s).
    --product-type      run this test on device with this product type(s).  May also filter by variant using product:variant.
    --property            run this test on device with this property value. Expected format --property <propertyname> <propertyvalue>.
    -e, --[no-]emulator  force this test to run on emulator. Default: false.
    -d, --[no-]device    force this test to run on a physical device, not an emulator. Default: false.
    --[no-]new-emulator  allocate a placeholder emulator. Should be used when config intends to launch an emulator Default: false.
    -n, --[no-]null-device   do not allocate a device for this test. Default: false.
    --[no-]tcp-device    start a placeholder for a tcp device that will be connected later. Default: false.
    --min-battery        only run this test on a device whose battery level is at least the given amount. Scale: 0-100
    --max-battery        only run this test on a device whose battery level is strictly less than the given amount. Scale: 0-100
    --[no-]require-battery-check      _If_ --min-battery and/or --max-battery is specified, skip devices that have an unknown battery level.  Note that this may leave restart-looping devices    in  limbo indefinitely without manual intervention. Default: true.
    --min-sdk-level      Only run this test on devices that support this Android SDK/API level
    --max-sdk-level      Only run this test on devices that are running this or lower Android SDK/API level

device_options options:
    --[no-]enable-root   enable adb root on boot. Default: false.
    --[no-]disable-keyguard   attempt to disable keyguard once boot is complete. Default: true.
    --disable-keyguard-cmd     shell command to disable keyguard. Default: input keyevent 82.
    --[no-]enable-logcat Enable background logcat capture when invocation is running. Default: true.
    --max-tmp-logcat-file
                         The maximum size of tmp logcat data to retain, in bytes. Only used if --enable-logcat is set Default: 20971520.
    --logcat-options     Options to be passed down to logcat command, if unspecified, "-v threadtime" will be used. Only used if --enable-logcat is set
    --fastboot-timeout   time in ms to wait for a device to boot into fastboot. Default: 60000.
    --adb-recovery-timeout
                         time in ms to wait for a device to boot into recovery. Default: 60000.
    --reboot-timeout     time in ms to wait for a device to reboot to full system. Default: 120000.
    --[no-]use-fastboot-erase
                         use fastboot erase instead of fastboot format to wipe partitions Default: false.
    --unencrypt-reboot-timeout
                         time in ms to wait for the device to format the filesystem and reboot after unencryption Default: 0.
    --online-timeout     default time in ms to wait for the device to be visible on adb. Default: 60000.
    --available-timeout  default time in ms to wait for the device to be available aka fully boot. Default: 360000.
    --ping-ip-or-host    default ip or host to ping during connectivity checks; [deprecated] use --ping-url instead. Default: www.google.com.
    --conn-check-url     default URL to be used for connectivity checks. Default: http://www.google.com.
    --wifi-attempts      default number of attempts to connect to wifi network. Default: 5.
    --wifi-retry-wait-time
                         the base wait time in ms between wifi connect retries. The actual wait time would be a multiple of this value. Default: 60000.
    --[no-]wifi-exponential-retry
                         Change the wifi connection retry strategy from a linear wait time into a binary exponential back-offs when retrying. Default: true.
    --post-boot-command  shell command to run after reboots during invocation
    --[no-]disable-reboot
                         disables device reboots globally, making them no-ops Default: false.
    --cutoff-battery     the minimum battery level required to continue the invocation. Scale: 0-100

'file-system-log-saver' log_saver options:
    --log-file-path      root file system path to store log files. Default: /tmp.
    --log-file-url       root http url of log files. Assumes files placed in log-file-path are visible via this url.
    --log-retention-days the number of days to keep saved log files.
    --[no-]compress-files
                         whether to compress files which are not already compressed Default: true.

build_provider options:
    --cts-install-path   the path to the cts installation to use Default: ./../...
    --branch             build branch name to supply.

device_recovery options:
    --online-wait-time   maximum time in ms to wait for device to come online. Default: 60000.
    --device-wait-time   maximum time in ms to wait for a single device recovery command. Default: 240000.
    --bootloader-wait-time
                         maximum time in ms to wait for device to be in fastboot. Default: 30000.
    --shell-wait-time    maximum time in ms to wait for device shell to be responsive. Default: 30000.
    --fastboot-wait-time maximum time in ms to wait for a fastboot command result. Default: 30000.
    --min-battery-after-recovery
                         require a min battery level after successful recovery, default to 0 for ignoring. Default: 0.
    --[no-]disable-unresponsive-reboot
                         If this is set, we will not attempt to reboot an unresponsive devicethat is in userspace.  Note that this will have no effect if the device is in fastboot or is expected to be in fastboot. Default: false.

test options:
    --plan               the test plan to run.
    -p, --package        the test packages(s) to run.
    --exclude-package    the test packages(s) to exclude from the run.
    -c, --class          run a specific test class.
    -m, --method         run a specific test method, from given --class.
    -t, --test           run a specific test
    --continue-session   continue a previous test session.
    -d, --[no-]skip-device-info
                         flag to control whether to collect info from device. Providing this flag will speed up test execution for short test runs but will result in required data being omitted from the test report. Default: false.
    --[no-]resume        flag to attempt to automatically resume aborted test run on another connected device.  Default: false.
    --shards             shard the tests to run into separately runnable chunks to execute on multiple devices concurrently. Default: 1.
    --[no-]screenshot    flag for taking a screenshot of the device when test execution is complete. Default: false.
    -b, --[no-]bugreport take a bugreport after each failed test. Warning: can potentially use a lot of disk space. Default: false.
    -k, --[no-]run-known-failures
                         run tests including known failures Default: false.
    --[no-]disable-reboot
                         Do not reboot device after running some amount of tests. Default behavior is to reboot. Default: false.
    --reboot-wait-time   Additional wait time in ms after boot complete. Default: 120000.
    --reboot-interval    Interval between each reboot in min. Default: 30.
    --[no-]screenshot-on-failure
                         take a screenshot on every test failure. Default: false.
    --[no-]logcat-on-failure
                         take a logcat snapshot on every test failure. Unlike --bugreport, this can capturelogs even if connection with device has been lost, as well as being much more performant. Default: false.
    --force-abi          The abi to use, can be either 32 or 64.
    --logcat-on-failure-size
                         The max number of logcat data in bytes to capture when --logcat-on-failure is on. Should be an amount that can comfortably fit in memory. Default: 512000.
    --[no-]collect-deqp-logs
                         Collect dEQP logs from the device. Default: false.
    --include            Positive filters to pass to tests.
    --exclude            Negative filters to pass to tests.
    --min-pre-reboot-package-count
                         The minimum number of packages to require a pre test reboot Default: 2.
    --[no-]skip-connectivity-check
                         Don't verify device connectivity between module execution. Default: false.

'file' logger options:
    --log-level          the minimum log level to log. Default: DEBUG. Valid values: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT]
    -l, --log-level-display
                         the minimum log level to display on stdout. Default: WARN. Valid values: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT]
    --log-tag-display    Always display given tags logs on stdout
    --max-log-size       maximum allowable size of tmp log data in mB. Default: 20.

result_reporter options:
    --[no-]quiet-output  Mute display of test results. Default: false.
    --output-file-path   root file system path to directory to store xml test results and associated logs. If not specified, results will be stored at <cts root>/repository/results
    --plan               the test plan to run. Default: NA.
    --continue-session   the test result session to continue.
    --result-server      Server to publish test results.
    --[no-]include-test-log-tags
                         Include test log tags in XML report. Default: false.
    --[no-]use-log-saver Also saves generated result XML with log saver Default: false.

result_reporter options:
    --[no-]quiet-output  Mute display of test results. Default: false.

result_reporter options:
    --issue-server       Server url to post test failures to.