adb shell am 命令

adb shell am

使用此命令可以从cmd控制台启动 activity, services；发送 broadcast等等：

 

C:\Users\Administrator>adb shell am
usage: am [subcommand] [options]

    start an Activity: am start [-D] [-W] <INTENT>
        -D: enable debugging
        -W: wait for launch to complete

    start a Service: am startservice <INTENT>

    send a broadcast Intent: am broadcast <INTENT>

    start an Instrumentation: am instrument [flags] <COMPONENT>
        -r: print raw results (otherwise decode REPORT_KEY_STREAMRESULT)
        -e <NAME> <VALUE>: set argument <NAME> to <VALUE>
        -p <FILE>: write profiling data to <FILE>
        -w: wait for instrumentation to finish before returning

    start profiling: am profile <PROCESS> start <FILE>
    stop profiling: am profile <PROCESS> stop

    start monitoring: am monitor [--gdb <port>]
        --gdb: start gdbserv on the given port at crash/ANR

    <INTENT> specifications include these flags:
        [-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]
        [-c <CATEGORY> [-c <CATEGORY>] ...]
        [-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]
        [--esn <EXTRA_KEY> ...]
        [--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]
        [-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]
        [-n <COMPONENT>] [-f <FLAGS>]
        [--grant-read-uri-permission] [--grant-write-uri-permission]
        [--debug-log-resolution]
        [--activity-brought-to-front] [--activity-clear-top]
        [--activity-clear-when-task-reset] [--activity-exclude-from-recents]
        [--activity-launched-from-history] [--activity-multiple-task]
        [--activity-no-animation] [--activity-no-history]
        [--activity-no-user-action] [--activity-previous-is-top]
        [--activity-reorder-to-front] [--activity-reset-task-if-needed]
        [--activity-single-top]
        [--receiver-registered-only] [--receiver-replace-pending]
        [<URI>]

使用实例：

如启动一个 Activity：

 

格式：

adb shell am start -n 包名/包名＋类名（-n 类名,-a action,-d date,-m MIME-TYPE,-c category,-e 扩展数据,等）。

 

实例1： 

C:\Users\Administrator>adb shell am start -n com.android.camera/.Camera
Starting: Intent { cmp=com.android.camera/.Camera }

 

实例2：（带extra 的 intent）

C:\Users\Administrator>adb shell am start -n com.android.camera/.Camera -e abc hello
Starting: Intent { cmp=com.android.camera/.Camera (has extras) }

其中 extra 的 key 为 abc ,value 为字串 "hello"

 

 

 

 

adb shell am instrument [options] <COMPONENT>

作用：启动对instrument实例的监视。

参数[options]：

-e <key> <value> // -e选项需要放在-w选项之前

作用：提供了以键值对形式存在的测试选项。Android中提供了多种键值对，具体参见下表。
举例：-e class com.android.phone.FIncomingCallTests#testRejectCall

-r

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

参数 <COMPONENT>：

-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

<key> <value>参考表

Key	Value	Description
package	<Java_package_name>	The fully-qualified Java package name for one of the packages in the test application. Any test case class that uses this package name is executed. Notice that this is not an Androidpackage name; a test package has a single Android package name but may have several Java packages within it.
class	<class_name>	The fully-qualified Java class name for one of the test case classes. Only this test case class is executed.
	<class_name>#method name	A fully-qualified test case class name, and one of its methods. Only this method is executed. Note the hash mark (#) between the class name and the method name.
func	true	Runs all test classes that extendInstrumentationTestCase.
unit	true	Runs all test classes that do not extend eitherInstrumentationTestCase orPerformanceTestCase.
size	[small | medium | large]	Runs a test method annotated by size. The annotations are @SmallTest, @MediumTest, and@LargeTest.
perf	true	Runs all test classes that implementPerformanceTestCase. When you use this option, also specify the -r flag for am instrument, so that the output is kept in raw format and not re-formatted as test results.
debug	true	Runs tests in debug mode.
log	true	Loads and logs all specified tests, but does not run them. The test information appears inSTDOUT. Use this to verify combinations of other filters and test specifications.
emma	true	Runs an EMMA code coverage analysis and writes the output to /data//coverage.ec on the device. To override the file location, use thecoverageFile key that is described in the following entry. Note: This option requires an EMMA-instrumented build of the test application, which you can generate with the coverage target.
coverageFile	<filename>	Overrides the default location of the EMMA coverage file on the device. Specify this value as a path and filename in UNIX format. The default filename is described in the entry for theemma key

adb shell am start [options] <INTENT>

作用：启动一个activity

举例：adb shell am start -a com.lt.test.action.SECOND

举例：adb shell am start -n com.lt.test/.MyActivity

说明：[options]与<INTENT>参见 http://developer.android.com/tools/help/adb.html#am

adb shell am startservice [options] <INTENT>

作用：启动一个service

举例：adb shell am startservice -a com.lt.test.action.ONESERVICE
举例：adb shell am startservice -n com.lt.test/.MyService

 

adb shell am force-stop <PACKAGE>
作用：强制关闭一个应用程序

举例：adb shell am force-stop com.lt.test

 

adb shell am broadcast [options] <INTENT>

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

举例：adb shell am broadcast -n com.lt.test/.MyBroadcast