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

2019年4月17日 327次阅读来源: 吾若成疯

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

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

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

解读：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

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

格式：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

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

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

    原文作者：吾若成疯
    原文地址: https://www.jianshu.com/p/2802683923e0
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。