android基础知识12：android自动化测试06—Instrumentation 06 adb shell am

[adb shell am instrument]
注意：-e选项需要放在-w选项之前
-w <test_package_name>/<runner_class>  （<test_package_name>和<runner_class>在测试工程的AndroidManifest.xml中查找）
作用：保持adb shell打开直至测试完成
举例：-w com.android.phone.tests/com.android.phone.runners.FunctionalTestRunner
-e <key> <value>
作用：提供了以键值对形式存在的测试选项。Android中提供了多种键值对，具体参见下表。
举例：-e class com.android.phone.FIncomingCallTests#testRejectCall （value为完全限定的类名）
-r

作用：以原始形式输出测试结果。该选项通常是在性能测试时与-e perf true一起使用。

<key> <value>参考表

Typical Usage

1. Write TestCases that perform unit, functional, or performance tests against the classes in your package. Typically these are subclassed from:
   • ActivityInstrumentationTestCase2
   • ActivityUnitTestCase
   • AndroidTestCase
   • ApplicationTestCase
   • InstrumentationTestCase
   • ProviderTestCase
   • ServiceTestCase
   • SingleLaunchActivityTestCase
2. In an appropriate AndroidManifest.xml, define the this instrumentation with the appropriate android:targetPackage set.
3. Run the instrumentation using "adb shell am instrument -w", with no optional arguments, to run all tests (except performance tests).
4. Run the instrumentation using "adb shell am instrument -w", with the argument '-e func true' to run all functional tests. These are tests that derive fromInstrumentationTestCase.
5. Run the instrumentation using "adb shell am instrument -w", with the argument '-e unit true' to run all unit tests. These are tests thatdo notderive fromInstrumentationTestCase (and are not performance tests).
6. Run the instrumentation using "adb shell am instrument -w", with the argument '-e class' set to run an individualTestCase.

Running all tests: adb shell am instrument -w com.android.foo/android.test.InstrumentationTestRunner

Running all small tests: adb shell am instrument -w -e size small com.android.foo/android.test.InstrumentationTestRunner

Running all medium tests: adb shell am instrument -w -e size medium com.android.foo/android.test.InstrumentationTestRunner

Running all large tests: adb shell am instrument -w -e size large com.android.foo/android.test.InstrumentationTestRunner

Filter test run to tests with given annotation: adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner

If used with other options, the resulting test run will contain the union of the two options. e.g. "-e size large -e annotation com.android.foo.MyAnnotation" will run only tests with both theLargeTest and "com.android.foo.MyAnnotation" annotations.

Filter test run to tests without given annotation: adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.test.InstrumentationTestRunner

Running a single testcase: adb shell am instrument -w -e class com.android.foo.FooTest com.android.foo/android.test.InstrumentationTestRunner

Running a single test: adb shell am instrument -w -e class com.android.foo.FooTest#testFoo com.android.foo/android.test.InstrumentationTestRunner

Running multiple tests: adb shell am instrument -w -e class com.android.foo.FooTest,com.android.foo.TooTest com.android.foo/android.test.InstrumentationTestRunner

Running all tests in a java package: adb shell am instrument -w -e package com.android.foo.subpkg com.android.foo/android.test.InstrumentationTestRunner

Including performance tests: adb shell am instrument -w -e perf true com.android.foo/android.test.InstrumentationTestRunner

To debug your tests, set a break point in your code and pass: -e debug true

To run in 'log only' mode -e log true This option will load and iterate through all test classes and methods, but will bypass actual test execution. Useful for quickly obtaining info on the tests to be executed by an instrumentation command.

To generate EMMA code coverage: -e coverage true Note: this requires an emma instrumented build. By default, the code coverage results file will be saved in a /data//coverage.ec file, unless overridden by coverageFile flag (see below)

To specify EMMA code coverage results file path: -e coverageFile /sdcard/myFile.ec
in addition to the other arguments.

    经过验证，貌似无法一次运行所有的small和medium 的case，-e size 只能指定一种标签。对于smoke标签，貌似需要使用 -e annotation android.test.suitebuilder.annotation.Smoke命令。

[adb shell am start]
-n <package_name>/.<activity_class_name>
作用：启动一个activity
举例：adb shell am start -n com.lt.am/.MyAMActivity


[adb shell am startservice]
-n <package_name>/.<service_class_name>
作用：启动一个service
举例：adb shell am startservice -n com.lt.am/.MyAMService


[adb shell am broadcast]
-a <action_name>
作用：发送一个广播
举例：adb shell am broadcast -a "action_finish" （发送一个广播去关闭一个activity）
作用：恢复出厂设置的方法，会清除内存所有内容
举例：adb shell am broadcast -a android.intent.action.MASTER_CLEAR 

参考文档：android-sdks\docs\tools\testing\testing_otheride.html

参考资料：

《adb shell am的使用》