Android中AM、PM、dumpsys命令使用总结

在平时开发中,通过命令行有时候能够快速的帮我们实现一些功能,这里对常用的命令做一些总结。

1、AM命令用法

1.1、简单介绍

am指令是 activity manager的缩写,可以启动Service、Broadcast,杀进程,监控等功能,这些功能都非常便捷调试程序。

可以通过adb shell 进入Android 的Linux命令界面,输入am -help查看详细命令,先介绍几个简单用法,

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

//使用Action方式打开网站https://amberweather.com
am start -a android.intent.action.VIEW -d  https://amberweather.com

//打开拨号界面,并传递一个DATA_URI数据给拨号界面
am start -a android.intent.action.CALL -d tel:10086

1.2、AM命令

命令格式如下

am [command] [options]

命令列表:

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

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

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

1.3、 Options

1.3.1 启动Activity

主要是启动Activity命令am start [options] <INTENT>使用options参数,接下来列举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,如果不输入,则使用当前用户执行

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

1.3.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

1.3.3 其他

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

例如:启动id=10001的用户的指定service。

am startservice --user 10010 [Intent]

1.4 Intent

Intent的参数和flags较多,为了方便,这里分为3种类型参数,常用参数,Extra参数,Flags参数

1.4.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 mobi.infolife.ezweather.locker.locker_2/.LockerActivity
am start -d content://contacts/people/1
am start -t image/png
am start -c android.intent.category.APP_CONTACTS

1.4.2 Extra参数

(1). 基本类型

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

参数es是Extra String首字母简称,实例:

am start -n com.cnr.tlive/.MainActivity -es test

(2). 数组类型

参数 -esa -eia -ela -efa
数组类型 <span class="Apple-tab-span" style="white-space:pre"></span>String[] int[] long[] float[]

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

am start -n com.cnr.tlive/com.cnr.tlive.activity.MainActivity -ela day 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.cnr.tlive.activity.MainActivity-efal nums 1.2,2.2

2、PM命令用法

2.1、简单介绍

pm工具为包管理(package manager)的简称,可以使用pm工具来执行应用的安装和查询应用宝的信息、系统权限、控制应用,pm工具是Android开发与测试过程中必不可少的工具,shell命令格式如下:

pm <command>
命令 功能 实现方法
list packages 列举app包信息 PMS.getInstalledPackages
install [options] <PATH> 安装应用 PMS.installPackageAsUser
uninstall [options]<package> 卸载应用 IPackageInstaller.uninstall
enable <包名或组件名> enable PMS.setEnabledSetting
disable <包名或组件名> disable PMS.setEnabledSetting
hide <package> 隐藏应用 PMS.setApplicationHiddenSettingAsUser
unhide <package> 显示应用 PMS.setApplicationHiddenSettingAsUser
get-install-location 获取安装位置 PMS.getInstallLocation
set-install-location 设置安装位置 PMS.setInstallLocation
path <package> 查看App路径 PMS.getPackageInfo
clear <package> 清空App数据 AMS.clearApplicationUserData
get-max-users 最大用户数 UserManager.getMaxSupportedUsers
force-dex-opt <package> dex优化 PMS.forceDexOpt
dump <package> dump信息 AM.dumpPackageStateStatic
trim-caches <目标size> 紧缩cache目标大小 PMS.freeStorageAndNotify

原理分析:pm命令实的实现方式在Pm.java,最后大多数都是调用PackageManagerService相应的方法来完成的。disbale之后,在桌面和应用程序列表里边都看到不该app。

2.2、详细参数

2.2.1 list packages

查看所有的package,

list packages [options] <FILTER>

[options]参数:

-f: 显示包名所关联的文件;
-d: 只显示disabled包名;
-e: 只显示enabled包名;
-s: 只显示系统包名;
-3: 只显示第3方应用的包名;
-i: 包名所相应的installer;
-u: 包含uninstalled包名.

disabled + enabled = 总应用个数; 系统 + 第三方 = 总应用个数。

查看第3方应用:

pm list packages -3

查看已经被禁用的包名

pm list packages -d

<FILTER>参数
当FILTER为不为空时,则只会输出包名带有FILTER字段的应用;当FILTER为空时,则默认显示所有满足条件的应用。

例如,查看包名带有weather字段的包名

pm list packages weather

2.2.3 pm Install

pm install [options] <PATH>

[options]参数:

-r: 覆盖安装已存在Apk,并保持原有数据;
-d: 运行安装低版本Apk;
-t: 运行安装测试Apk
-i : 指定Apk的安装器;
-s: 安装apk到共享快存储,比如sdcard;
-f: 安装apk到内部系统内存;
-l: 安装过程,持有转发锁
-g: 准许Apk manifest中的所有权限;

<PATH>参数: 指的是需要安装的apk所在的路径

2.2.4其他参数

pm list users //查看当前手机用户
pm list libraries //查看当前设备所支持的库
pm list features //查看系统所有的features
pm list instrumentation //所有测试包的信息
pm list permission-groups //查看所有的权限组
pm list permissions [options] <group> 查看权限
    -g: 以组形式组织;
    -f: 打印所有信息;
    -s: 简要信息;
    -d: 只列举危险权限;
    -u: 只列举用户可见的权限。

3、dumpsys

3.1 dumpsys原理简介

dumpsys是Android自带的强大debug工具,从名字就可以看出,主要是用于dump 当前android system的一些信息,是一项分析手机问题,运行状态,使用情况等十分有效的手段。

实现原理
dumpsys的源码结构其实很简单,只有一个dumpsys.cpp
/frameworks/native/cmds/dumpsys/dumpsys.cpp

int main(int argc, char* const argv[])
{
    ...
    //获取defaultServiceManager
    sp<IServiceManager> sm = defaultServiceManager();
    ...
    Vector<String16> services;
    ...
    services = sm->listServices();
    ...
    const size_t N = services.size();

    for (size_t i=0; i<N; i++) {
        sp<IBinder> service = sm->checkService(services[i]);
        ...
        int err = service->dump(STDOUT_FILENO, args);
        ...
    }

    return 0;
}

先通过defaultServiceManager()函数获得ServiceManager对象,然后根据dumpsys传进来的参数通过函数checkService来找到具体的service, 并执行该service的dump方法,达到dump service的目的。

3.2 dumpsy命令

3.2.1 服务列表

不同的Android系统版本支持的命令有所不同,可通过下面命令查看当前手机所支持的dump服务,先进入adb shell,再执行如下命令:dumpsys -l。 这些服务名可能并看不出其调用的哪个服务,可以通过下面指令:service list。

服务列表有很多,这里简单介绍几种

服务名 类名 功能
activity ActivityManagerService AMS相关信息
package PackageManagerService PMS相关信息
window WindowManagerService WMS相关信息
input InputManagerService IMS相关信息
power PowerManagerService PMS相关信息
battery BatteryService 电池信息
dropbox DropboxManagerService <div>调试相关</div>
cpuinfo CpuBinder CPU
meminfo MemBinder 内存
dbinfo DbBinder 数据库

3.2.2 查询服务

通过下面命令可打印具体某一项服务:dumpsys <service>,其中service便是前面表格中的服务名

dumpsys cpuinfo //打印一段时间进程的CPU使用百分比排行榜
dumpsys meminfo -h  //查看dump内存的帮助信息
dumpsys package <packagename> //查看指定包的信息

接下来主要说下dumpsys activity 用法

3.3 Activity

命令

dumpsys activity [options] [cmd]

options可选值

-a:dump所有;
-c:dump客户端;
-p [package]:dump指定的包名;
-h:输出帮助信息;

dumpsys activity等价于依次输出下面7条指令:

dumpsys activity intents
dumpsys activity broadcasts
dumpsys activity providers
dumpsys activity services
dumpsys activity recents
dumpsys activity activities
dumpsys activity processes

cmd可选值

cmd 说明 缩写
activities activity状态 a
broadcasts 广播<span class="Apple-tab-span" style="white-space:pre"></span> b
intents pending intent状态 i
processes 进程 p
oom 内存溢出 o
services Service状态 s
providers ContentProvider状态<span class="Apple-tab-span" style="white-space:pre"></span> prov
provider ContentProvider状态(Client端)
package package相关信息
all 所有的activities信息
recents recent activity状态
top top activity信息

注:
cmd:上表加粗项是指直接跟包名,另外services和providers还可以跟组件名;
缩写:基本都是cmd首字母或者前几个字母,用cmd和缩写是等效: dumpsys activity broadcasts 和 dumpsys activity b 等效

3.4 dumpsys meminfo

命令

dumpsys meminfo

返回结果

Total PSS by process://以process来划分
   122677 kB: com.android.browser (pid 5807 / activities)
    96473 kB: system (pid 661)
    93999 kB: com.android.systemui (pid 745)
    90564 kB: mobi.infolife.ezweather.locker.locker_2 (pid 1115 / activities)
    56021 kB: mobi.infolife.ezweather.widget.soccer_season (pid 1745)
    50044 kB: mobi.infolife.ezweather.widget.gcolour (pid 5147)
    40171 kB: com.android.launcher3 (pid 887 / activities)
    ...
    
Total PSS by OOM adjustment: //以oom来划分.
   112247 kB: Native
               34819 kB: local_opengl (pid 231)
               24076 kB: zygote (pid 342)
               17226 kB: mediaserver (pid 340)
                9041 kB: genybaseband (pid 138)
                3881 kB: logd (pid 115)
                2071 kB: wpa_supplicant (pid 872)
                1976 kB: genyd (pid 132)
                1678 kB: drmserver (pid 238)
                1648 kB: surfaceflinger (pid 339)
                1444 kB: vold (pid 122)
                1330 kB: sdcard (pid 736)
                1118 kB: netd (pid 338)
                 864 kB: adbd (pid 136)
                 768 kB: debuggerd (pid 236)
                 763 kB: keystore (pid 241)
                 724 kB: /init (pid 1)

Total PSS by category:// 以category划分
   216031 kB: Native
   169950 kB: Dalvik
   121137 kB: .dex mmap
    73616 kB: Ashmem
    68426 kB: Unknown
    64952 kB: .apk mmap
    63304 kB: .so mmap
    53932 kB: .oat mmap
    27704 kB: .art mmap
    15919 kB: Other mmap
    14777 kB: Dalvik Other
     9222 kB: .ttf mmap
     8548 kB: Stack
      148 kB: Other dev
        0 kB: Cursor
        0 kB: Gfx dev
        0 kB: .jar mmap
        0 kB: EGL mtrack
        0 kB: GL mtrack
        0 kB: Other mtrack
        
Total RAM: 4049068 kB (status normal)//整体情况
 Free RAM: 3105215 kB (65839 cached pss + 503700 cached kernel + 2535676 free)
 Used RAM: 1020031 kB (841827 used pss + 178204 kernel)
 Lost RAM: -76178 kB
   Tuning: 96 (large 256), oom 184320 kB, restore limit 61440 kB (high-end-gfx)

上面的输出结果可以分为以下四个部分

PSS- Proportional Size 实际使用的物理内存(比例分配共享库占用的内存)

按比例包含共享库所占用的内存,比如有9k的共享库被3个进程使用,那个当前进程所占用的大小被计算为9/3k,也就是3k

-序列 划分类型 排序 解释
1 process PSS 以进程的PSS从大到小依次排序显示,每行显示一个进程;
2 OOM adj PSS Native/System/Persistent/Foreground/Visible/Perceptible/A Services/Home/B Services/Cached,分别显示每类的进程情况
3 category PSS 以Dalvik/Native/.art mmap/.dex map等划分的各类进程的总PSS情况
4 total - 总内存、剩余内存、可用内存、其他内存

也可以只输出某个pid或package的进程信息:

dumpsys meminfo <pid> // 输出指定pid的某一进程
dumpsys meminfo --package <packagename> // 输出指定包名的进程,可能包含多个进程

3.4 使用场景

下面以AmberLocker作为实例进行分析

场景1:查询某个App所有的Service状态

dumpsys activity s mobi.infolife.ezweather.locker.locker_2

解读:Service类名为com.amber.lockscreen.LockerHeartService,包名为mobi.infolife.ezweather.locker.locker_2,baseDir(apk路径)为/data/app/mobi.infolife.ezweather.locker.locker_2-2/base.apk,dataDir((apk数据路径)
运行在进程pid=1115,进程名为进程名为mobi.infolife.ezweather.locker.locker_2,,uid=10060,还有创建时间等信息

场景2:查询某个App所有的广播状态

dumpsys activity b mobi.infolife.ezweather.locker.locker_2

场景3:查询某个App所有的Activity状态

dumpsys activity a mobi.infolife.ezweather.locker.locker_2

场景4:查询某个App的进程状态

dumpsys activity p mobi.infolife.ezweather.locker.locker_2

格式:ProcessRecord{Hashcode pid:进程名/uid},进程pid=941,进程名为mobi.infolife.ezweather.locker.locker_2:live,uid=10060.
该进程中还有Services,Connections, Providers, Receivers,

场景5:查询栈顶Activity

dumpsys activity |  grep mFocusedActivity

dumpsys 的命令还有很多,这里就不一一列举了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,905评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,140评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,791评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,483评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,476评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,516评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,905评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,560评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,778评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,557评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,635评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,338评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,925评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,898评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,142评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,818评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,347评论 2 342

推荐阅读更多精彩内容

  • Android开发中我们有时候需要借助一些命令帮助更好的高效率定位解决问题,本文就来介绍一些可能有些隐藏的而却非常...
    passiontim阅读 1,410评论 0 4
  • 为了面试,为了高工资,废话不多说,不定期更新。 1. Activity正常和异常情况下的生命周期分析。 Activ...
    24K男阅读 826评论 0 0
  • 一个个的小短篇故事,没有什么故事情节和大片叙述。几句话就能说完的故事经历,但书中用了大段文字来描写主人公心理,以及...
    晨熙小太阳阅读 367评论 0 1
  • 世俗韵弃或知闲,风往云淡。叶落翩然,何必待花复明年。 鸡鸣乌啼自知起,不等三竿;他日重见,才知当时竟必然。
    世游人阅读 329评论 0 0
  • 文/雨在水面写诗 网友小鹿在我的公众号后台留言,她和男朋友大齐从学生时代开始,已经开启了长达7年的恋爱长跑,就在快...
    安芮娴阅读 441评论 1 1