adb shell am命令

am这个指令是 activity manager的缩写。这个命令可以启动Activity、打开或关闭进程、发送广播等操作。

am命令格式如下

adb shell am <command>
  • 1

1、start [options] <INTENT>

根据Intent 启动Activity

options参数如下:

-D:开启debug模式
-W:等待启动完成
--start-profiler<FILE>:将profiler中的结果输出到指定文件中
-P:和--start-profiler一样,区别在于,在app进入idle状态时profiler结束
-R <Count>: 重复启动Activity,但每次重复启动都会关闭掉最上面的Activity
-S:关闭Activity所属的App进程后再启动Activity
--opengl-trace:开启OpenGL tracing
--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

INTENT参数参见附录1:

命令样例:

//使用Action方式打开系统设置-输入法设置
adb shell am start -a android.settings.INPUT_METHOD_SETTINGS

//使用组件名方式启动照相机功能
adb shell am start -n com.android.camera/.Camera

//打开拨号界面,并传递一个DATA_URI数据给拨号界面
am start -a android.intent.action.CALL -d tel:10086
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

2、startservice [options] <INTENT>

根据Intent 启动Service 
options参数如下:

--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
  • 1

INTENT参数参见附录1: 
命令样例:

//使用ComponentName 方式启动一个Service
adb shell am startservice com.some.package.name/.YourServiceSubClassName
  • 1
  • 2

3、force-stop <PACKAGE>

关闭指定包名的应用程序 
命令样例:

adb shell am force-stop com.some.package
  • 1

4、kill [options] <PACKAGE>

杀死与应用程序的包名称相关联的所有进程。该命令只会杀死安全的进程,不会影响用户体验。 
options参数如下:

--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
  • 1

命令样例:

adb shell am kill com.some.package
  • 1

5、kill-all

杀死全部的后台进程 
命令样例:

adb shell am kill-all
  • 1

6、broadcast [options] <INTENT>

发送一个广播 
options参数如下:

--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
  • 1

命令样例:

//恢复出厂设置的方法,会清除内存所有内容(慎重测试!!!!)
adb shell am broadcast -a android.intent.action.MASTER_CLEAR
  • 1
  • 2

7、instrument [options] <COMPONENT>

启动对instrument实例的监视 
options参数如下:

-r: 以原始形式输出测试结果。该选项通常是在性能测试时与-e perf true一起使用。
-e <NAME> <VALUE>: 提供了以键值对形式存在的测试选项。格式一般为 -e <testrunner_flag> <value>[,<value>...].
-p <FILE>: 将profiling数据写入制定的文件
-w: 保持adb shell打开直至测试完成
--no-window-animation:关闭运行时window动画
--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

命令样例:

adb shell am instrument -w com.android.phone.tests/com.android.phone.runners.FunctionalTestRunner
  • 1

8、profile start <PROCESS> <FILE>

开始收集目标进程运行过程中的函数调用关系 
其中PROCESS是所要收集的进程,直接用进程号即可, FILE是收集后trace所在的文件,一般直接放在/sdcard 目录下,所以直接用/sdcard/文件名 即可。 
命令样例:

adb shell am profile start 17495 /mnt/sdcard/profile.txt
  • 1

9、profile stop <PROCESS>

其中PROCESS是所要收集的进程,直接用进程号即可 
停止收集目标进程运行过程中的函数调用关系 
命令样例:

adb shell am profile stop 17495
  • 1

10、dumpheap [options] <PROCESS> <FILE>

将指定进程号的堆信息输出到指定的文件中 
options参数如下:

--user <USER_ID> :使用指定的用户来启动activity,如果不输入,则使用当前用户执行
-n: 直接存储原始堆信息,而不是系统管理后的堆信息
  • 1
  • 2

命令样例:

adb shell am dumpheap -n 17495 /mnt/sdcard/dumpheap.txt
  • 1

11、set-debug-app [options] <PACKAGE>

设置特定包名的应用程序开启debug 
options参数如下:

-w: 等待应用程序启动
--persistent: 持久化
  • 1
  • 2

命令样例:

adb shell am set-debug-app -w com.some.package
  • 1

12、clear-debug-app

取消设置debug状态的应用程序 
命令样例:

adb shell am clear-debug-app
  • 1

13、monitor [options]

监视Crash 或者ANR错误 
options参数如下:

--gdb: 在给定的端口上启动gdbserv监控crash/ANR错误. 
  • 1

命令样例:

adb shell am monitor
  • 1

14、screen-compat [on|off] <PACKAGE>

开启或关闭指定package的屏幕兼容模式 
命令样例:

adb shell am screen-compat on com.some.package
  • 1

15、display-size [reset|<WxH>]

重写模拟器/设备显示大小。这个命令是有帮助的测试你的应用程序在不同的屏幕大小,通过模仿一个小屏幕分辨率,使用一个大屏幕的设备,反之亦然。 
命令样例:

adb shell am display-size 1280x800
  • 1

16、display-density <dpi>

重写模拟器/设备显示密度。该命令有助于测试你的应用程序在不同的屏幕密度对高密度屏幕环境,使用低密度屏幕,反之亦然。 
命令样例:

adb shell am display-density 480
  • 1

17、to-uri <INTENT>

将intent转换为Uri 
命令样例:

adb shell am to-uri -a android.settings.INPUT_METHOD_SETTINGS
  • 1

18、to-intent-uri <INTENT>

将intent转换为intent:Uri 
命令样例:

adb shell am to-intent-uri -a android.settings.INPUT_METHOD_SETTINGS
  • 1

附录1:

-a <ACTION>
    intent action, 例如 "android.intent.action.VIEW". 
-d <DATA_URI>
    intent data URI, 例如 "content://contacts/people/1". 
-t <MIME_TYPE>
    intent MIME type, 例如 "image/png". 
-c <CATEGORY>
    intent category, 例如 "android.intent.category.APP_CONTACTS". 
-n <COMPONENT>
    指定组件名称以包名称前缀来创建一个Intent, 例如 "com.example.app/.ExampleActivity". 
-f <FLAGS>
    在intent 中添加 flags, Java代码中对应的是 Intent.setFlags(). 
--esn <EXTRA_KEY>
    添加 a null extra.  这个参数不支持 URI intents.
-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE>
    添加一个 string 数据,数据结构是键值对 
--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>
    添加一个 boolean 数据,数据结构是键值对 
--ei <EXTRA_KEY> <EXTRA_INT_VALUE>
    添加一个 int 数据,数据结构是键值对 
--el <EXTRA_KEY> <EXTRA_LONG_VALUE>
    添加一个 long 数据,数据结构是键值对 
--ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE>
    添加一个 float 数据,数据结构是键值对 
--eu <EXTRA_KEY> <EXTRA_URI_VALUE>
    添加一个 URI data 数据,数据结构是键值对 
--ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE>
    添加一个组件的名称, 这个属性将会被转换成 ComponentName 对象进行传递. 
--eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]
    添加一个int数组
--ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]
    添加一个long数组
--efa <EXTRA_KEY> <EXTRA_FLOAT_VALUE>[,<EXTRA_FLOAT_VALUE...]
    添加一个floats数组
--grant-read-uri-permission
    包含 flag值 FLAG_GRANT_READ_URI_PERMISSION. 
--grant-write-uri-permission
    包含 flag值 FLAG_GRANT_WRITE_URI_PERMISSION. 
--debug-log-resolution
    包含 flag值 FLAG_DEBUG_LOG_RESOLUTION. 
--exclude-stopped-packages
    包含 flag值 FLAG_EXCLUDE_STOPPED_PACKAGES. 
--include-stopped-packages
    包含 flag值 FLAG_INCLUDE_STOPPED_PACKAGES. 
--activity-brought-to-front
    包含 flag值 FLAG_ACTIVITY_BROUGHT_TO_FRONT. 
--activity-clear-top
    包含 flag值 FLAG_ACTIVITY_CLEAR_TOP. 
--activity-clear-when-task-reset
    包含 flag值  FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET. 
--activity-exclude-from-recents
    包含 flag值  FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS. 
--activity-launched-from-history
    包含 flag值  FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY. 
--activity-multiple-task
    包含 flag值  FLAG_ACTIVITY_MULTIPLE_TASK. 
--activity-no-animation
    包含 flag值  FLAG_ACTIVITY_NO_ANIMATION. 
--activity-no-history
    包含 flag值  FLAG_ACTIVITY_NO_HISTORY. 
--activity-no-user-action
    包含 flag值  FLAG_ACTIVITY_NO_USER_ACTION. 
--activity-previous-is-top
    包含 flag值  FLAG_ACTIVITY_PREVIOUS_IS_TOP. 
--activity-reorder-to-front
    包含 flag值  FLAG_ACTIVITY_REORDER_TO_FRONT. 
--activity-reset-task-if-needed
    包含 flag值  FLAG_ACTIVITY_RESET_TASK_IF_NEEDED. 
--activity-single-top
    包含 flag值  FLAG_ACTIVITY_SINGLE_TOP. 
--activity-clear-task
    包含 flag值  flag FLAG_ACTIVITY_CLEAR_TASK. 
--activity-task-on-home
    包含 flag值  FLAG_ACTIVITY_TASK_ON_HOME. 
--receiver-registered-only
    包含 flag值  FLAG_RECEIVER_REGISTERED_ONLY. 
--receiver-replace-pending
    包含 flag值  FLAG_RECEIVER_REPLACE_PENDING. 
--selector
    必须使用 -d 和 -t 参数 来设置intent 数据和类型. 
<URI> <COMPONENT> <PACKAGE>
    直接指定URI、组件名、包名方式启动Activity是无法使用上述选项的,当参数不合法时,am命令默认的识别方式是,URI方式需要包含":";组件名方式是包含"/";其他的格式,am命令默认识别为包名方式。
<think>我们被要求使用adb shell am start命令,特别是带-w选项来启动一个Android应用组件并等待其完成。 根据引用[1]:adb启动程序命令adb shell am start。但没有详细说明-w选项。 我们需要更详细的信息:-w选项用于等待启动完成,并打印启动时间。 实际上,am start命令的完整用法如下(通过adb shell am start -h可以查看): start [options] <INTENT> options包括: -D: 启用调试 -W: 等待启动完成 --start-profiler <FILE>: 启动分析器并将结果发送到<FILE> -P <FILE>: 类似--start-profiler,但分析器在应用进入空闲状态时停止 -R <COUNT>: 重复执行活动启动<COUNT>次 -S: 在启动Activity前强行停止目标应用 --opengl-trace: 启用OpenGL函数的跟踪 --user <USER_ID> | current: 指定要作为哪个用户运行;如果未指定,则作为当前用户运行 因此,-W选项就是用来等待启动完成的。 示例:启动包名为com.example.app的应用的主Activity,并等待其完成: adb shell am start -W com.example.app/.MainActivity 输出会包含: Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.example.app/.MainActivity } Status: ok Activity: com.example.app/.MainActivity ThisTime: 100 TotalTime: 100 WaitTime: 150 Complete 其中,ThisTime: 最后一个Activity启动耗时; TotalTime: 所有Activity启动耗时; WaitTime: AMS启动Activity的总耗时。 注意:Intent可以通过组件名指定,也可以通过Action和Category等指定。 例如,通过Action和Category启动: adb shell am start -W -a android.intent.action.MAIN -c android.intent.category.LAUNCHER -n com.example.app/.MainActivity 但是,如果应用已经启动,可能不会等待到界面完全绘制(因为Activity已经存在,只是被带到前台)。为了确保启动新的实例,可以添加标志FLAG_ACTIVITY_NEW_TASK和FLAG_ACTIVITY_CLEAR_TOP等,但通常am start会默认添加FLAG_ACTIVITY_NEW_TASK。 另外,如果应用尚未安装或组件不存在,命令会报错。 因此,针对用户的问题,我们给出使用-W选项的示例,并解释输出。 注意:如果启动的Activity是应用的主Activity,通常我们使用包名/主Activity的完整类名(如com.example.app/.MainActivity),其中MainActivity前面的点表示包名后面的类名。 如果不知道主Activity,可以通过以下方式获取: adb shell dumpsys package <package_name> | grep -A 1 "android.intent.action.MAIN" 但这不是必须的,因为通常开发者知道主Activity。 另外,引用[3]中提到了input命令,但这里不相关。 根据引用[2]中dumpsys的用法,可以用于获取网络状态等信息,但和启动应用无关。 因此,我们聚焦在am start -w的使用。 下面我们给出具体步骤和示例。</think>### 启动Android应用组件并等待完成的adb命令详解 `adb shell am start -w`命令用于启动Android应用组件并等待其完全启动完成。其中`-w`参数是关键,它会强制命令等待直到Activity完全启动并显示在屏幕上才返回结果[^1]。 #### 命令基本格式 ```bash adb shell am start -W [选项] <组件名> ``` #### 核心参数说明 1. **`-W`(必选)** 等待启动完成,并输出启动耗时统计: ```bash adb shell am start -W com.example.app/.MainActivity ``` 输出示例: ``` Status: ok Activity: com.example.app/.MainActivity ThisTime: 250 # 当前Activity启动耗时 TotalTime: 400 # 包括依赖资源的整体耗时 WaitTime: 600 # AMS(Activity Manager Service)总处理时间 ``` 2. **组件名格式** `<包名>/<完整Activity类名>` 例如:`com.tencent.mm/.ui.LauncherUI` 3. **常用附加选项** - `-n`:显式指定组件名 ```bash adb shell am start -W -n com.example.app/.MainActivity ``` - `-a`:指定Action(如主屏启动) ```bash adb shell am start -W -a android.intent.action.MAIN ``` - `-c`:添加Category ```bash adb shell am start -W -c android.intent.category.LAUNCHER ``` - `-f`:设置Intent Flags ```bash adb shell am start -W -f 0x10200000 ``` #### 典型使用场景 1. **冷启动性能测试** ```bash # 先强制停止应用 adb shell am force-stop com.example.app # 冷启动并测量时间 adb shell am start -W -n com.example.app/.MainActivity ``` 2. **带参数启动Activity** ```bash adb shell am start -W -a android.intent.action.VIEW \ -d "https://example.com" com.example.app/.WebViewActivity ``` 3. **调试模式启动** ```bash adb shell am start -W -D -n com.example.app/.DebugActivity ``` #### 注意事项 1. 确保设备已开启USB调试(`adb devices`验证连接) 2. 组件名必须完全匹配(可通过`adb shell dumpsys package <包名>`查询) 3. 当出现`Error: Activity not started`时,检查: - 组件名是否拼写错误 - Activity是否在AndroidManifest.xml中导出 - 是否缺少必要权限[^3] > 通过`-w`参数获取的启动时间(`TotalTime`)是性能优化的重要指标,常用于自动化测试脚本中[^1]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值