adb之am命令用法

---

前言

作为一名开发者，相信对adb指令一定不会陌生。那么在手机连接adb后，可通过am命令做很多操作：

(1) 拨打电话10086

adb shell am start -a android.intent.action.CALL -d tel:10086

(2) 打开网站www.baidu.com

adb shell am start -a android.intent.action.VIEW -d http://www.baidu.com

(3) 启动Activity： 启动包名为com.example.hxplay，主Activity为.MainActivity，且extra数据以”henry”为key, “666”为value。通过java代码要完成该功能虽然不复杂，但至少需要一个android环境，而通过adb的方式，只需要在adb窗口，输入如下命令便可完成:

adb shell am start -n com.example.hxplay/.MainActivity -es henry 666

am命令还可以启动Service、Broadcast，杀进程，监控等功能，这些功能都非常便捷调试程序，接下来讲述关于am更多更详细的功能。

一、Am命令

命令格式：

am [subcommand] [options]

命令列表：

命令	功能	实现方法
am start [options] < INTENT>	启动Activity	startActivityAsUser
am startservice < INTENT>	启动Service	startService
am stopservice < INTENT>	停止Service	stopService
am broadcast < INTENT>	发送广播	broadcastIntent
am kill < PACKAGE>	杀指定后台进程	killBackgroundProcesses
am kill-all	杀所有后台进程	killAllBackgroundProcesses
am force-stop < PACKAGE>	强杀进程	forceStopPackage
am hang	系统卡住	hang
am restart	重启	restart
am bug-report	创建bugreport	requestBugReport
am dumpheap < pid> < file>	进程pid的堆信息输出到file	dumpheap
am send-trim-memory < pid> < level>	收紧进程的内存	setProcessMemoryTrimLevel
am monitor	监控	MyActivityController.run

am命令实的实现方式在Am.java，最终几乎都是调用ActivityManagerService相应的方法来完成的，am monitor除外。比如前面概述中介绍的命令adb shell am start -a android.intent.action.VIEW -d http://www.baidu.com， 启动Acitivty最终调用的是ActivityManagerService类的startActivityAsUser()方法来完成的。再比如am kill-all命令，最终的实现工作是由ActivityManagerService的killBackgroundProcesses()方法完成的。

接下来，说说[options]和 < INTENT>参数的意义以及如何正确取值。

---

二、Options

2.1 启动Activity

主要是启动Activity命令am start [options] < INTENT>使用options参数，接下来列举Activity命令的[options]参数：

• -D: 允许调试功能
• -W: 等待app启动完成
• -R < COUNT>: 重复启动Activity COUNT次
• -S: 启动activity之前，先调用forceStopPackage()方法强制停止app.
• -opengl-trace: 运行获取OpenGL函数的trace
• -user < USER_ID> | current: 指定用户来运行App,默认为当前用户。
• -start-profiler < FILE>: 启动profiler，并将结果发送到 < FILE>;
• -P < FILE>: 类似 –start-profiler，不同的是当app进入idle状态，则停止profiling
• -sampling INTERVAL: 设置profiler 取样时间间隔，单位ms;

启动Activity的实现原理： 存在-W参数则调用startActivityAndWait()方法来运行，否则startActivityAsUser()。

2.2 收紧内存

通过向特定进程发送适当级别的内存收紧请求，可以促使应用程序在系统内存紧张的情况下主动减少内存使用，以降低系统的内存压力并提高整体性能。

命令

am send-trim-memory  <pid> <level>

例如： 向pid=12345的进程，发出level=RUNNING_LOW的收紧内存命令

am send-trim-memory 12345 RUNNING_LOW

level取值范围为：

HIDDEN：隐藏状态。用于指示应用程序的进程已被隐藏，可以清理掉一些缓存。
RUNNING_MODERATE：运行 - 适度。用于通知应用程序系统内存较低，应该减少内存使用。
BACKGROUND：后台。用于指示应用程序进入后台，需要释放一些内存。
RUNNING_LOW：运行 - 低。用于通知应用程序系统内存非常低，需要紧急减少内存使用。
MODERATE：适度。用于通知应用程序系统内存较低，建议减少内存占用。
RUNNING_CRITICAL：运行 - 临界。用于通知应用程序系统内存非常紧张，需要尽快减少内存使用。
COMPLETE：完全。用于通知应用程序清理所有可以释放的内存，以应对系统内存不足的情况。

2.3 其他

对于am的子命令，startservice, stopservice, broadcast, kill, profile start, profile stop, dumpheap的可选参数都允许设置–user <USER_ID>。目前市面上的绝大多数手机还是单用户模式，故可以忽略该参数，默认为当前用户。

例如：启动id=10010的用户的指定service。

am startservice --user 10010

三、 Intent

Intent的参数和flags较多，本文为方便起见，分为3种类型参数，常用参数，Extra参数，Flags参数。

3.1 常用参数

• -a < ACTION>: 指定Intent action， 实现原理Intent.setAction()；
• -n < COMPONENT>: 指定组件名，格式为{包名}/.{主Activity名}，实现原理Intent.setComponent(）；
• -d < DATA_URI>: 指定Intent data URI
• -t < MIME_TYPE>: 指定Intent MIME Type
• -c < CATEGORY> [-c < CATEGORY>] …]:指定Intent category，实现原理Intent.addCategory()
• -p < PACKAGE>: 指定包名，实现原理Intent.setPackage();
• -f < FLAGS>: 添加flags，实现原理Intent.setFlags(int )，紧接着的参数必须是int型；

实例

am start -a android.intent.action.VIEW
am start -n com.example.hxplay/.MainActivity
am start -d content://contacts/people/1
am start -t image/png
am start -c android.intent.category.APP_CONTACTS

3.2 Extra参数

(1) 基本类型

参数	-e/-es	-esn	-ez	-ei	-el	-ef	-eu	-ecn
类型	String	(String)null	boolean	int	long	float	uri	component

比如参数es是Extra String首字母简称，实例：

am start -n com.example.hxplay/.MainActivity -es henry 666

此处-es henry 666，等价于Intent.putExtra(“henry ”, “666”);

(2) 数组类型

参数	-esa	-eia	-ela	-efa
数组类型	String[ ]	int[ ]	long[ ]	float[ ]

比如参数eia，是Extra int array首字母简称，多个value值之间以逗号隔开，实例：

am start -n com.example.hxplay/.MainActivity -ela weekday 1,2,3,4,5

此处-ela weekday 1,2,3,4,5，等价于Intent.putExtra(“weekday”, new int[]{1,2,3,4,5});

(3) ArrayList类型

参数	-esal	-eial	-elal	-efal
List类型	String	int	long	float

比如参数efal，是Extra float Array List首字母简称，多个value值之间以逗号隔开，实例：

am start -n com.example.hxplay/.MainActivity -efal nums 1.2,2.2

此处-efal nums 1.2,2.2，等价于先构造ArrayList变量，再通过putExtra放入第二个参数。

3.3 Flags参数

在常用参数中，提到有-f < FLAGS>，是通过Intent.setFlags(int )方法，来设置Intent的flags.本小节也是关于flags，是通过Intent.addFlags(int )方法。如下所示，所有的flags参数。

[--grant-read-uri-permission] [--grant-write-uri-permission]
[--grant-persistable-uri-permission] [--grant-prefix-uri-permission]
[--debug-log-resolution]
[--exclude-stopped-packages] [--include-stopped-packages]
[--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] [--activity-clear-task]
[--activity-task-on-home]
[--receiver-registered-only] [--receiver-replace-pending]

例如，发送action=”broadcast.demo”的广播，并且对于forceStopPackage()的应用不允许接收该广播，命令如下：

am broadcast -a broadcast.demo --exclude-stopped-packages