ADB命令
Android sdk下载地址:https://www.androiddevtools.cn/
1、用USB线连接手机和电脑,打开手机的USB调试模式,授权
2、打开命令行,输入adb devices,查看是否连接成功
如果出现unauthorized表示手机未授权,需要在弹出的USB调试页面选择确定按钮
如果没有连接成功:如果确定你的网络和端口都没问题,可以尝试重启一下adb服务
连接过程中也有需要使用 USB 线,但是连接成功之后,手机就可以在一定范围内摆脱 USB 连接线的限制。
1、将 Android 设备与要运行 adb 的电脑连接到同一个局域网,比如连到同一个 WiFi。
2、将设备与电脑通过 USB 线连接。应确保连接成功(可运行 adb devices 看是否能列出该设备)。
3、让设备在 5555 端口监听 TCP/IP 连接:adb tcpip 5555
5、找到设备的 IP 地址。一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到,或者进入手机的WIFI连接,进入连接属性,查看手机的ip
6、adb connect <device-ip-address> 。这里的 <device-ip-address> 就是上一步中找到的设备 IP 地址。
<device-ip-address>:5555 device
如果没有连接成功:如果确定你的网络和端口都没问题,可以尝试重启一下adb服务
使用真机进行monkey测试,打开USB调试,USB安装,USB调试(安全设置)
一、ADB是什么?
adb 称之为:Android 调试桥 (Android Debug Bridge )是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具,它可为各种设备操作提供便利,如安装和调试应用,并提供对 Unix shell(可用来在模拟器或连接的设备上运行各种命令)的访问。可以在Android SDK/platform-tools中找到 adb 工具或下载 ADB Kits 。
注: 有部分命令的支持情况可能与 Android 系统版本及定制 ROM 的实现有关。
二、ADB有什么作用?
ADB 是 Android SDK 里的一个工具, 用这个工具可以直接操作管理Android模拟器或者真实的Android设备。它的主要功能有:
客户端:该组件发送命令。客户端在开发计算机上运行。您可以通过发出 adb 命令从命令行终端调用客户端。
后台程序:该组件在设备上运行命令。后台程序在每个模拟器或设备实例上作为后台进程运行。
服务器:该组件管理客户端和后台程序之间的通信。服务器在开发计算机上作为后台进程运行。
三、ADB命令语法
adb [-d|-e|-s <serial-number>] <command>
如果只有一个设备/模拟器连接时,可以省略掉 [-d|-e|-s <serial-number>] 这一部分,直接使用 adb <command>。
如果有多个设备/模拟器连接,则需要为命令指定目标设备,下表是指定目标设备的命令选项:
在多个设备/模拟器连接的情况下较常用的是 -s <serial-number> 参数,serial-number是指设备的设备序列号,可以通过 adb devices 命令获取。
四、ADB命令大全
adb version
adb start-server
一般无需手动执行此命令,在运行 adb 命令时若发现 adb server 没有启动会自动调起。
adb kill-server
adb root
adb -P <port> start-server
adb devices
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
adb shell pm list packages 后面可以跟一些可选参数进行过滤查看不同的列表,可用参数及含义如下:
adb shell pm list packages
adb shell pm list packages -s
adb shell pm list packages -3
adb shell pm list packages huawei
adb install [-l] [-r] [-t] [-s] [-d] [-g] <apk-file>
adb install 后面可以跟一些可选参数来控制安装 APK 的行为,可用参数及含义如下:
允许安装 AndroidManifest.xml 里 application 指定 android:testOnly="true" 的应用 |
|
运行命令后可以看到输出内容,包含安装进度和状态,安装状态如下:
Failure:代表安装失败。 APK 安装失败的情况有很多,Failure状态之后有安装失败输出代码。常见安装失败输出代码、含义及可能的解决办法如下:
|
||
通过 Gradle 的 assembleDebug 或assembleRelease 重新编译,或者 Generate Signed APK |
||
signatures do not match the previously installed version; ignoring! |
-
push apk 文件到 /data/local/tmp。
-
调用 pm install 安装。
-
删除 /data/local/tmp 下的对应 apk 文件。
adb uninstall [-k] <package-name>
<package-name> 表示应用的包名,-k 参数可选,表示卸载应用但保留数据和缓存目录。
adb shell pm clear <package-name>
<package-name> 表示应用名包,这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。
adb shell dumpsys activity activities | grep mFocusedActivity
adb shell dumpsys activity services [<package-name>]
<package-name> 参数不是必须的,指定 <package-name> 表示查看与某个包名相关的 Services,不指定表示查看所有 Services。
<package-name> 不一定要给出完整的包名,可以只给一部分,那么所给包名相关的 Services 都会列出来。
adb shell dumpsys package <package-name>
<package-name> 表示应用包名。运行次命令的输出中包含很多信息,包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。
adb shell pm path <package-name>
与应用交互主要是使用 am <command> 命令,常用的 <command> 如下:
<intent> 参数很灵活,和写 Android 程序时代码里的 Intent 相对应。
<intent> 里还能带数据,就像写代码时的 Bundle 一样:
adb shell am start [options] <intent>
adb shell am start -a android.settings.SETTINGS # 打开系统设置页面
adb shell am start -a android.intent.action.DIAL -d tel:10086 # 打开拨号页面
adb shell am start -n com.android.mms/.ui.ConversationList # 打开短信会话列表
options 是一些改变其行为的选项,支持的可选参数及含义如下:
adb shell am startservice [options] <intent>
一个典型的用例是如果设备上原本应该显示虚拟按键但是没有显示,可以试试这个:
adb shell am startservice -n com.android.systemui/.SystemUIService
adb shell am stopservice [options] <intent>
adb shell am force-stop <packagename>
adb pull <remote> [local]
local: 计算机上的目录,参数可以省略,默认复制到当前目录
例如,将 /sdcard/yibijizhang.apk 下载到计算机的当前目录:
adb pull /sdcard/yibijizhang.apk
将 /sdcard/yibijizhang.apk 下载到计算机的当前目录(目录需存在):
adb pull /sdcard/yibijizhang.apk D:\Download
adb push <local> <remote>
adb push <local> <remote>
adb push D:\Download\
adb push <local> <remote>
/sdcard/music/
adb shell ls [options] <directory>
<directory> 表示指定目录,可以省略,表示列出根目录下的所有文件和目录。 adb shell ls 后面可以跟一些可选参数进行过滤查看不同的列表,可用参数及含义如下:
adb shell cd <directory>
第一步:执行adb shell命令; 第二步:执行cd <directory>命令切换到目标目录。
adb shell rm [options] <files or directory>
第一步:执行adb shell命令; 第二步:执行rm [options] <files or directory>命令删除文件或目录。
rm 后面可以跟一些可选参数进行不同的操作,可用参数及含义如下:
rm -d 等同于 rmdir 命令,有些版本不包含-d 参数。
adb shell mkdir [options] <directory-name>
第一步:执行adb shell命令; 第二步:执行mkdir [options] <directory-name>命令创建目录。 mkdir 后面可以跟一些可选参数进行不同的操作,可用参数及含义如下:
adb shell touch [options] <file>
第一步:执行adb shell命令; 第二步:执行touch [options] <file>命令创建空文件或改变文件时间戳。
可通过ls -n <directory> 命令查看文件的时间。
adb shell pwd
第一步:执行adb shell命令; 第二步:执行pwd命令输出当前目录路径。
adb shell cp [options] <source> <dest>
第一步:执行adb shell命令; 第二步:执行cp [options] <source> <dest>命令复制文件和目录。 参数说明:
adb shell mv [options] <source> <dest>
第一步:执行adb shell命令; 第二步:执行mv [options] <source> <dest>命令移动或重命名文件。 参数说明:
adb shell netstat
adb shell netstat><file-path>
例如,可以通过 adb shell netstat>D:\netstat.log 将日志输出到 D:\netstat.log 中。
adb shell ping [-aAbBdDfhLnOqrRUvV] [-c count] [-i interval] [-I interface]
[-m mark] [-M pmtudisc_option] [-l preload] [-p pattern] [-Q tos]
[-s packetsize] [-S sndbuf] [-t ttl] [-T timestamp_option]
[-w deadline] [-W timeout] [hop1 ...] destination
adb shell ping www.baidu.com
不结束的话会一直ping下去,可以按 Ctrl + C 停止ping操作。
adb shell ping -c 4 www.baidu.com
adb shell netcfg [<interface> {dhcp|up|down}]
rmnet_ims10 DOWN 0.0.0.0/0 0x00001002
rmnet_ims00 DOWN 0.0.0.0/0 0x00001002
rmnet_tun04 DOWN 0.0.0.0/0 0x00001002
rmnet_tun03 DOWN 0.0.0.0/0 0x00001002
rmnet_tun02 DOWN 0.0.0.0/0 0x00001002
rmnet_tun01 DOWN 0.0.0.0/0 0x00001002
rmnet_tun00 DOWN 0.0.0.0/0 0x00001002
rmnet_tun14 DOWN 0.0.0.0/0 0x00001002
rmnet_tun13 DOWN 0.0.0.0/0 0x00001002
rmnet_tun12 DOWN 0.0.0.0/0 0x00001002
rmnet_tun11 DOWN 0.0.0.0/0 0x00001002
rmnet_tun10 DOWN 0.0.0.0/0 0x00001002
rmnet1 DOWN 0.0.0.0/0 0x00001002
rmnet0 DOWN 0.0.0.0/0 0x00001002
rmnet4 DOWN 0.0.0.0/0 0x00001002
rmnet3 DOWN 0.0.0.0/0 0x00001002
rmnet2 DOWN 0.0.0.0/0 0x00001002
rmnet6 DOWN 0.0.0.0/0 0x00001002
rmnet5 DOWN 0.0.0.0/0 0x00001002
dummy0 UP 0.0.0.0/0 0x000000c3
rmnet_r_ims10 DOWN 0.0.0.0/0 0x00001002
rmnet_r_ims00 DOWN 0.0.0.0/0 0x00001002
rmnet_emc0 DOWN 0.0.0.0/0 0x00001002
lo UP 127.0.0.1/8 0x00000049
sit0 DOWN 0.0.0.0/0 0x00000080
wlan0 UP 10.0.38.176/23 0x00001043
adb shell ip [ options ] object
options := { -V[ersion] | -s[tatistics] | -d[etails] | -r[esolve] |-f[amily] { inet | inet6 | ipx | dnet | link } |-l[oops] { maximum-addr-flush-attempts } |-o[neline] | -t[imestamp] | -b[atch] [filename] |-rc[vbuf] [size]}
object := { link | addr | addrlabel | route | rule | neigh | ntable |tunnel | tuntap | maddr | mroute | mrule | monitor | xfrm |netns | l2tp }
options 是一些修改ip行为或者改变其输出的选项。所有的选项都是以-字符开头,分为长、短两种形式,支持的可选参数及含义如下:
object 是你要管理或者获取信息的对象。目前ip认识的对象包括:
adb shell ip -f inet addr show wlan0
在 adb shell 里有个很实用的命令叫 input,通过它可以做一些有趣的事情。 可以执行adb shell input命令查看完整 help 信息如下:
Usage: input [<source>] <command> [<arg>...]
The sources are:
dpad
keyboard
mouse
touchpad
gamepad
touchnavigation
joystick
touchscreen
stylus
trackball
The commands and default sources are:
text <string> (Default: touchscreen)
keyevent [--longpress] <key code number or name> ... (Default: keyboard)
tap <x> <y> (Default: touchscreen)
swipe <x1> <y1> <x2> <y2> [duration(ms)] (Default: touchscreen)
draganddrop <x1> <y1> <x2> <y2> [duration(ms)] (Default: touchscreen)
press (Default: trackball)
roll <dx> <dy> (Default: trackball)
比如使用 adb shell input keyevent <keycode> 命令,不同的 keycode 能实现不同的功能,完整的 keycode 列表详见 KeyEvent,摘引部分我觉得有意思的如下:
adb shell input keyevent 26
adb shell input keyevent 82
adb shell input keyevent 3
adb shell input keyevent 4
adb shell input keyevent 24
adb shell input keyevent 25
adb shell input keyevent 16
adb shell input keyevent 85
adb shell input keyevent 86
adb shell input keyevent 87
adb shell input keyevent 88
adb shell input keyevent 126
adb shell input keyevent 127
adb shell input keyevent 224
adb shell input keyevent 223
如果锁屏没有密码,是通过滑动手势解锁,那么可以通过 input swipe 来解锁。 命令(向上滑动手势解锁举例):
adb shell input swipe 300 1000 300 500
参数 300 1000 300 500 分别表示起始点x坐标 起始点y坐标 结束点x坐标 结束点y坐标。
在焦点处于某文本框时,可以通过 input 命令来输入文本。
adb shell input text hello
Android 系统的日志分为两部分,底层的 Linux 内核日志输出到 /proc/kmsg,Android 的日志输出到 /dev/log。
adb logcat [option] [filter-specs]
如果需要停止 logcat 日志打印,可以按 Ctrl + C 停止日志监控。
adb logcat [filter-specs]
Android 的日志分为如下几个优先级(priority):
adb logcat *:W
会将 Warning、Error、Fatal 和 Silent 日志输出。
(注: 在 macOS 下需要给 *:W 这样以 * 作为 tag 的参数加双引号,如 adb logcat "*:W",不然会报错 no matches found: *:W。)
adb logcat [tag:level] [tag:level] ...
adb logcat ActivityManager:I MyApp:D *:S
表示输出 tag ActivityManager 的 Info 以上级别日志,输出 tag MyApp 的 Debug 以上级别日志,及其它 tag 的 Silent 级别日志(即屏蔽其它 tag 日志)。
可以用 adb logcat -v <format> 选项指定日志输出格式。
日志格式默认为 brief,指定格式可与上面的过滤同时使用。比如:
adb logcat -v long ActivityManager:I *:S
adb logcat -c
adb logcat -d
adb logcat -f <file-path>
adb logcat -b <Buffer>
Android log 输出量巨大,特别是通信系统的log,因此,Android把log输出到不同的缓冲区中,目前定义了四个log缓冲区:
缓冲区主要给系统组件使用,一般的应用不需要关心,应用的log都输出到main缓冲区中。默认log输出(不指定缓冲区的情况下)是输出System和Main缓冲区的log。
adb logcat -g
adb shell dmesg
<6>[14201.684016] PM: noirq resume of devices complete after 0.982 msecs
<6>[14201.685525] PM: early resume of devices complete after 0.838 msecs
<6>[14201.753642] PM: resume of devices complete after 68.106 msecs
<4>[14201.755954] Restarting tasks ... done.
<6>[14201.771229] PM: suspend exit 2016-08-28 13:31:32.679217193 UTC
<6>[14201.872373] PM: suspend entry 2016-08-28 13:31:32.780363596 UTC
<6>[14201.872498] PM: Syncing filesystems ... done.
中括号里的 [14201.684016] 代表内核开始启动后的时间,单位为秒。
通过内核日志我们可以做一些事情,比如衡量内核启动时间,在系统启动完毕后的内核日志里找到 Freeing init memory 那一行前面的时间就是。
adb shell getprop [options]
除了可以查看 Android 设备系统属性之外,还可以设置系统属性,设置系统属性的基本命令格式是:
adb shell setprop <key> <value>
adb shell getprop ro.product.model
huawei mate 40 pro
adb shell dumpsys battery
Current Battery Service state:
AC powered: false
USB powered: true
Wireless powered: false
status: 2
health: 2
present: true
level: 88
scale: 100
voltage: 3872
temperature: 280
technology: Li-poly
其中 scale 代表最大电量,level 代表当前电量。上面的输出表示还剩下 88% 的电量。
adb shell wm size
Physical size: 720x1280
Physical size: 720x1280
Override size: 480x1024
表明设备的屏幕分辨率原本是 720px * 1280px,当前被修改为 480px * 1024px。
adb shell wm density
Physical density: 360
Physical density: 420
Override density: 360
表明设备的屏幕密度原来是 420dpi,当前被修改为 360dpi。
adb shell dumpsys window displays
WINDOW MANAGER DISPLAY CONTENTS (dumpsys window displays)
Display: mDisplayId=0
init=1080x1920 420dpi cur=1080x1920 app=1080x1794 rng=1080x1017-1810x1731
deferred=false layoutNeeded=false
其中 mDisplayId 为 显示屏编号,init 是初始分辨率和屏幕密度,app 的高度比 init 里的要小,表示屏幕底部有虚拟按键,高度为 1920 - 1794 = 126px 合 42dp。
adb shell settings get secure android_id
5a3a3aa2c3042184
在 Android 4.4 及以下版本可通过如下命令获取 IMEI:
adb shell dumpsys iphonesubinfo
Phone Subscriber Info:
Phone Type = GSM
Device ID = 860955027785041
而在 Android 5.0 及以上版本里这个命令输出为空,得通过其它方式获取了(需要 root 权限):
adb shell
su
service call iphonesubinfo 1
把里面的有效内容提取出来就是 IMEI 了,比如这里的是 890956027785041。
参考:adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop
adb shell getprop ro.build.version.release
7.1.2
adb shell ifconfig | grep Mask
在有的设备上这个命令没有输出,如果设备连着 WiFi,可以使用如下命令来查看局域网 IP:
adb shell ifconfig wlan0
如果以上命令仍然不能得到期望的信息,那可以试试以下命令(部分系统版本里可用):
adb shell netcfg
adb shell cat /sys/class/net/wlan0/address
36:0f:a5:9a:c7:7d
这查看的是局域网 Mac 地址,移动网络或其它连接的信息可以通过前面的小节「IP 地址」里提到的 adb shell netcfg 命令来查看。
adb shell cat /proc/cpuinfo
adb shell cat /proc/meminfo
adb shell cat /system/build.prop
这会输出很多信息,包括前面几个小节提到的「型号」和「Android 系统版本」等。
输出里还包括一些其它有用的信息,它们也可通过 adb shell getprop <属性名> 命令单独查看,列举一部分属性如下:
一些小厂定制的 ROM 可能修改过 CPU 支持的 abi 列表的属性名,如果用 ro.product.cpu.abilist 属性名查找不到,可以这样试试:
adb shell cat /system/build.prop | grep ro.product.cpu.abi
ro.product.cpu.abi=armeabi-v7a
ro.product.cpu.abi2=armeabi
注: 修改设置之后,运行恢复命令有可能显示仍然不太正常,可以运行 adb reboot 重启设备,或手动重启。
修改设置的原理主要是通过 settings 命令修改 /data/data/com.android.providers.settings/databases/settings.db 里存放的设置值。
adb shell wm size 480x1024
adb shell wm size reset
adb shell wm density 160
adb shell wm density reset
adb shell wm overscan 0,0,0,200
四个数字分别表示距离左、上、右、下边缘的留白像素,以上命令表示将屏幕底部 200px 留白。
adb shell wm overscan reset
adb shell settings put global adb_enabled 0
用命令恢复不了了,毕竟关闭了 USB 调试 adb 就连接不上 Android 设备了。 去设备上手动恢复:「设置」-「开发者选项」-「Android 调试」
adb shell settings put global hidden_api_policy_pre_p_apps 1
adb shell settings put global hidden_api_policy_p_apps 1
adb shell settings delete global hidden_api_policy_pre_p_apps
adb shell settings delete global hidden_api_policy_p_apps
禁止检测非 SDK 接口的调用。该情况下,日志记录功能被禁用,并且令 strict mode API,即 detectNonSdkApiUsage() 无效。不推荐。 |
|
adb shell settings put global policy_control <key-values>
<key-values> 可由如下几种键及其对应的值组成,格式为 <key1>=<value1>:<key2>=<value2>。
adb shell settings put global policy_control immersive.full=*
adb shell settings put global policy_control immersive.status=com.package1,com.package2:immersive.navigation=apps,-com.package3
表示设置在包名为 com.package1 和 com.package2 的应用里隐藏状态栏,在除了包名为 com.package3 的所有应用里隐藏导航栏。
adb exec-out screencap -p > sc.png
如果 adb 版本较老,无法使用 exec-out 命令,这时候建议更新 adb 版本。无法更新的话可以使用以下麻烦点的办法:
adb shell screencap -p /sdcard/sc.png
adb pull /sdcard/sc.png <pc路径>
可以使用 adb shell screencap -h 查看 screencap 命令的帮助信息,下面是两个有意义的参数及含义:
实测如果指定文件名以 .png 结尾时可以省略 -p 参数;否则需要使用 -p 参数。如果不指定文件名,截图文件的内容将直接输出到 stdout。
另外一种一行命令截图并保存到电脑的方法: Linux 和 Windows
adb shell screencap -p | sed "s/\r$//" > sc.png
adb shell screencap -p | gsed "s/\r$//" > sc.png
这个方法需要用到 gnu sed 命令,在 Linux 下直接就有,在 Windows 下 Git 安装目录的 bin 文件夹下也有。如果确实找不到该命令,可以下载 sed for Windows 并将 sed.exe 所在文件夹添加到 PATH 环境变量里。
sed: RE error: illegal byte sequence
brew install gnu-sed
adb shell screenrecord /sdcard/filename.mp4
需要停止时按 Ctrl-C,默认录制时间和最长录制时间都是 180 秒。
adb pull /sdcard/filename.mp4
可以使用 adb shell screenrecord --help 查看 screenrecord 命令的帮助信息,下面是常见参数及含义:
adb shell
su
cat /data/misc/wifi/*.conf
adb shell
su
date -s 20160823.131500
表示将系统日期和时间更改为 2016 年 08 月 23 日 13 点 15 分 00 秒。
adb reboot
adb shell
su
此时命令行提示符是 $ 则表示没有 root 权限,是 # 则表示已 root。
Monkey 可以生成伪随机用户事件来模拟单击、触摸、手势等操作,可以对正在开发中的程序进行随机压力测试。
adb shell monkey -p <packagename> -v 500
表示向 <packagename> 指定的应用程序发送 500 个伪随机事件。 Monkey 的详细用法参考 官方文档。
adb root
adb shell svc wifi enable
adb root
adb shell svc wifi disable
若执行成功,输出为空;若未取得 root 权限执行此命令,将执行失败,输出 Killed。
adb root
adb shell setenforce 1
adb root
adb shell setenforce 0
adb root
adb enable-verity
adb root
adb disable-verity
Android 系统是基于 Linux 内核的,所以 Linux 里的很多命令在 Android 里也有相同或类似的实现,在 adb shell 里可以调用。本文档前面的部分内容已经用到了 adb shell 命令。
adb shell ps
adb shell top [-m max_procs] [-n iterations] [-d delay] [-s sort_column] [-t] [-h]
adb shell top 后面可以跟一些可选参数进行过滤查看不同的列表,可用参数及含义如下:
adb shell dumpsys package | grep userId= 如:
adb shell dumpsys package org.mazhuang.guanggoo | grep userId=
userId=10394
通过 ps 命令找到对应进程的 pid 之后 adb shell cat /proc/<pid>/status | grep Uid 如:
adb shell
gemini:/ $ ps | grep org.mazhuang.guanggoo
u0_a394 28635 770 1795812 78736 SyS_epoll_ 0000000000 S org.mazhuang.guanggoo</p>
gemini:/ $ cat /proc/28635/status | grep Uid
Uid: 10394 10394 10394 10394
gemini:/ $