命令 | 说明 |
| start [options] intent | 启动由 intent 指定的 Activity。 选项如下: - -D:启用调试功能。
- -W:等待启动完成。
- --start-profiler file:启动分析器并将结果发送至 file。
- -P file:类似于 --start-profiler,但当应用进入空闲状态时分析停止。
- -R count:重复启动 Activity count 次。在每次重复前,将完成顶层 Activity。
- -S:在启动 Activity 前,强行停止目标应用。
- --opengl-trace:启用 OpenGL 函数的跟踪。
- --user user_id | current:指定要作为哪个用户运行;如果未指定,则作为当前用户运行。
|
| startservice [options] intent | 启动由 intent 指定的 Service。 选项如下: - --user user_id | current:指定要作为哪个用户运行;如果未指定,则作为当前用户运行。
|
| force-stop package | 强行停止与 package(应用的软件包名称)关联的所有进程。 |
| kill [options] package | 终止与 package(应用的软件包名称)关联的所有进程。此命令仅终止可安全终止且不会影响用户体验的进程。 选项如下: - --user user_id | all | current:指定要终止哪个用户的进程;如果未指定,则终止所有用户的进程。
|
| kill-all | 终止所有后台进程。 |
| broadcast [options] intent | 发出广播 intent。 选项如下: - [--user user_id | all | current]:指定要发送给哪个用户;如果未指定,则发送给所有用户。
|
| instrument [options] component | 使用 Instrumentation 实例启动监控。通常情况下,目标 component 采用 test_package/runner_class 格式。 选项如下: - -r:输出原始结果(否则,对 report_key_streamresult 进行解码)。与 [-e perf true] 结合使用以生成性能测量值的原始输出。
- -e name value:将参数 name 设为 value。对于测试运行程序,通用格式为 -e testrunner_flag value[,value...]。
- -p file:将分析数据写入 file。
- -w:先等待插桩完成,然后再返回。测试运行程序需要使用此选项。
- --no-window-animation:运行时关闭窗口动画。
- --user user_id | current:指定以哪个用户身份运行插桩;如果未指定,则以当前用户身份运行。
|
| profile start process file | 启动 process 的分析器,将结果写入 file。 |
| profile stop process | 停止 process 的分析器。 |
| dumpheap [options] process file | 转储 process 的堆,写入 file。 选项如下: - --user [user_id | current]:提供进程名称时,指定要转储的进程的用户;如果未指定,则使用当前用户。
- -n:转储原生堆,而非托管堆。
|
| set-debug-app [options] package | 设置要调试的应用 package。 选项如下: - -w:应用启动时等待调试程序。
- --persistent:保留此值。
|
| clear-debug-app | 清除之前使用 set-debug-app 设置的待调试软件包。 |
| monitor [options] | 开始监控崩溃或 ANR。 选项如下: - --gdb:在崩溃/ANR 时,在给定的端口上启动 gdbserv。
|
| screen-compat {on | off} package | 控制 package 的屏幕兼容性模式。 |
| display-size [reset | widthxheight] | 替换设备显示尺寸。此命令支持使用大屏设备模仿小屏幕分辨率(反之亦然),对于在不同尺寸的屏幕上测试应用非常有用。 示例:
am display-size 1280x800 |
| display-density dpi | 替换设备显示密度。此命令支持使用低密度屏幕模仿高密度屏幕环境(反之亦然),对于在不同密度的屏幕上测试应用非常有用。 示例:
am display-density 480 |
| to-uri intent | 以 URI 的形式输出给定的 intent 规范。 |
| to-intent-uri intent | 以 intent: URI 的形式输出给定的 intent 规范。 |