adb-1.0.41 命令整理

无线连接（需要借助 USB 线）

除了可以通过 USB 连接设备与电脑来使用 adb，也可以通过无线连接——虽然连接过程中也有需要使用 USB 的步骤，但是连接成功之后你的设备就可以在一定范围内摆脱 USB 连接线的限制啦！

操作步骤：

将 Android 设备与要运行 adb 的电脑连接到同一个局域网，比如连到同一个 WiFi。

将设备与电脑通过 USB 线连接。

应确保连接成功（可运行 adb devices 看是否能列出该设备）。

让设备在 5555 端口监听 TCP/IP 连接：

adb tcpip 5555

断开 USB 连接。

找到设备的 IP 地址。

一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到，也可以使用下文里 查看设备信息 - IP 地址 一节里的方法用 adb 命令来查看。

通过 IP 地址连接设备。

adb connect <device-ip-address>

这里的 `` 就是上一步中找到的设备 IP 地址。

确认连接状态。

adb devices

如果能看到

<device-ip-address>:5555 device

说明连接成功。

如果连接不了，请确认 Android 设备与电脑是连接到了同一个 WiFi，然后再次执行 adb connect 那一步；

如果还是不行的话，通过 adb kill-server 重新启动 adb 然后从头再来一次试试。

断开无线连接

命令：

adb disconnect <device-ip-address>

无线连接（无需借助 USB 线）

注：需要 root 权限。

上一节「无线连接（需要借助 USB 线）」是官方文档里介绍的方法，需要借助于 USB 数据线来实现无线连接。

既然我们想要实现无线连接，那能不能所有步骤下来都是无线的呢？答案是能的。

在 Android 设备上安装一个终端模拟器。

已经安装过的设备可以跳过此步。我使用的终端模拟器下载地址是：Terminal Emulator for Android Downloads

将 Android 设备与要运行 adb 的电脑连接到同一个局域网，比如连到同一个 WiFi。

打开 Android 设备上的终端模拟器，在里面依次运行命令：

su setprop service.adb.tcp.port 5555

找到 Android 设备的 IP 地址。

一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到，也可以使用下文里 查看设备信息 - IP 地址 一节里的方法用 adb 命令来查看。

在电脑上通过 adb 和 IP 地址连接 Android 设备。

adb connect <device-ip-address>

这里的 `` 就是上一步中找到的设备 IP 地址。

如果能看到 connected to :5555 这样的输出则表示连接成功。

节注一：

有的设备，比如小米 5S + MIUI 8.0 + Android 6.0.1 MXB48T，可能在第 5 步之前需要重启 adbd 服务，在设备的终端模拟器上运行：

restart adbd

如果 restart 无效，尝试以下命令：

stop adbd start adbd

adb常用命令

adb devices , 获取设备列表及设备状态

[xuxu:~]$ adb devices List of devices attached 44c826a0 device 192.168.2.100:5555 device emulator-5554 device

adb get-state , 获取设备的状态

[xuxu:~]$ adb get-state device

设备的状态有 3 钟，device , offline , unknown

device：设备正常连接

offline：连接出现异常，设备无响应

unknown：没有连接设备

adb kill-server , adb start-server , 结束 adb 服务， 启动 adb 服务，通常两个命令一起用

一般在连接出现异常，使用 adb devices 未正常列出设备， 设备状态异常时使用 kill-server，然后运行 start-server 进行重启服务

adb logcat , 打印 Android 的系统日志，这个可以单独拿出来讲

adb bugreport , 打印dumpsys、dumpstate、logcat的输出，也是用于分析错误

输出比较多，建议重定向到一个文件中

adb bugreport > d:\bugreport.log

adb install , 安装应用，覆盖安装是使用 -r 选项

windows 下如果需要安装含有中文名的 apk ，需要对 adb 进行修改，百度可以找到做出修改的adb , 支持中文命令的 apk，请自行搜索

adb uninstall , 卸载应用，后面跟的参数是应用的包名，请区别于 apk 文件名

‘-k’ means keep the data and cache directories , -k 选项，卸载时保存数据和缓存目录

adb pull , 将 Android 设备上的文件或者文件夹复制到本地

例如复制 Sdcard 下的 pull.txt 文件到 D 盘：

adb pull sdcard/pull.txt d:\

如果需要重命名为 rename.txt：

adb pull sdcard/pull.txt d:\rename.txt

注意权限，复制系统权限的目录下的文件，需要 root ，并且一般的 Android 机 root 之后并不能使用命令去复制，而需要在手机上使用类似于 RE 的文件浏览器，先对系统的文件系统进行挂载为可读写后，才能在手机上复制移动系统文件，这里推荐使用小米手机的开发版本，IUNI 也是不错滴~~

adb push , 推送本地文件至 Android 设备

例如推送 D 盘下的 push.txt 至 Sdcard：

adb push d:\push.txt sdcard/

sdcard 后面的斜杠不能少，否则会出现下面的错误：

[xuxu:~]$ adb push push.txt sdcard failed to copy 'push.txt' to 'sdcard': Is a directory

权限问题同 pull 命令

adb root , adb remount, 只针对类似小米开发版的手机有用，可以直接已这两个命令获取 root 权限，并挂载系统文件系统为可读写状态

adb reboot , 重启 Android 设备

bootloader , 重启设备，进入 fastboot 模式，同 adb reboot-bootloader 命令

recovery , 重启设备，进入 recovery 模式，经常刷机的同学比较熟悉这个模式

adb forward , 将 宿主机上的某个端口重定向到设备的某个端口

adb forward tcp:1314 tcp :8888

执行该命令后所有发往宿主机 1314 端口的消息、数据都会转发到 Android 设备的 8888 端口上，因此可以通过远程的方式控制 Android 设备。

adb connect 远程连接 Android 设备

手机、PC处于相同的网络下，手机 root ，安装应用 adbWireless ，启动应用后点击界面中间的按钮：

接着运行 adb connect 192.168.1.102 , 即可通过无线的方式连接手机，缺点是速度比较慢

adb shell 命令

有人问过我，为什么会知道这么多的命令，答案就是我比较爱折腾，这里大家先要了解我为什么要区分 adb 命令和 adb shell 命令 。 简单点讲，adb 命令是 adb 这个程序自带的一些命令，而 adb shell 则是调用的 Android 系统中的命令，这些 Android 特有的命令都放在了 Android 设备的 system/bin 目录下，例如我再命令行中敲这样一个命令：

[xuxu:~]$ adb shell hehe /system/bin/sh: hehe: not found

很明显，在 bin 目录下并不存在这个命令。 自己爱折腾，想看看有哪些命令，也不想去找文档，于是就启动模拟器，将整个 system/bin 目录复制了出来，然后一个一个的去试。。囧~~

打开这些文件就可以发现，里面有些命令其实是一个 shell 脚本，例如打开 monkey 文件：

# Script to start "monkey" on the device, which has a very rudimentary # shell. # base=/system export CLASSPATH=$base/framework/monkey.jar trap "" HUP exec app_process $base/bin com.android.commands.monkey.Monkey $*

再比如打开 am：

#!/system/bin/sh # # Script to start "am" on the device, which has a very rudimentary # shell. # base=/system export CLASSPATH=$base/framework/am.jar exec app_process $base/bin com.android.commands.am.Am "$@"

还有 SDK sources/android-20/com/android/commands 目录下：

[xuxu:...oid-20/com/android/commands]$ pwd /Users/xuxu/utils/android/android-sdk-macosx/sources/android-20/com/android/commands [xuxu:...oid-20/com/android/commands]$ ll total 0 drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 am drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 bmgr drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 bu drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 content drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 ime drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 input drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 media drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 pm drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 requestsync drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 settings drwxr-xr-x 7 xuxu staff 238B 4 2 10:57 svc drwxr-xr-x 6 xuxu staff 204B 4 2 10:57 uiautomator drwxr-xr-x 3 xuxu staff 102B 4 2 10:57 wm

有没有熟悉的命令？ am 、pm、uiautomator …

下面介绍一些常用的 adb shell 命令 （其中pm、am 命令比较庞大，使用四级标题）

pm

Package Manager , 可以用获取到一些安装在 Android 设备上得应用信息

直接运行 adb shell pm 可以获取到该命令的帮助信息

pm list package 列出安装在设备上的应用

不带任何选项：列出所有的应用的包名（不知道怎么找应用的包名的同学看这里）

adb shell pm list package

-s：列出系统应用

adb shell pm list package -s

-3：列出第三方应用

adb shell pm list package -3

-f：列出应用包名及对应的apk名及存放位置

adb shell pm list package -f

-i：列出应用包名及其安装来源，结果显示例子：

package:com.zhihu.android installer=com.xiaomi.market

adb shell pm list package -i

命令最后增加 FILTER：过滤关键字，可以很方便地查找自己想要的应用

参数组合使用，例如，查找三方应用中知乎的包名、apk存放位置、安装来源：

[xuxu:~]$ adb shell pm list package -f -3 -i zhihu package:/data/app/com.zhihu.android-1.apk=com.zhihu.android installer=com.xiaomi.market

pm path 列出对应包名的 .apk 位置

[xuxu:~]$ adb shell pm path com.tencent.mobileqq package:/data/app/com.tencent.mobileqq-1.apk

pm list instrumentation , 列出含有单元测试 case 的应用，后面可跟参数 -f （与 pm list package 中一样），以及 [TARGET-PACKAGE]

pm dump , 后跟包名，列出指定应用的 dump 信息，里面有各种信息，自行查看

adb shell pm dump com.tencent.mobileqq

Packages: Package [com.tencent.mobileqq] (4397f810): userId=10091 gids=[3003, 3002, 3001, 1028, 1015] pkg=Package{43851660 com.tencent.mobileqq} codePath=/data/app/com.tencent.mobileqq-1.apk resourcePath=/data/app/com.tencent.mobileqq-1.apk nativeLibraryPath=/data/app-lib/com.tencent.mobileqq-1 versionCode=242 targetSdk=9 versionName=5.6.0 applicationInfo=ApplicationInfo{43842cc8 com.tencent.mobileqq} flags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ] dataDir=/data/data/com.tencent.mobileqq supportsScreens=[small, medium, large, xlarge, resizeable, anyDensity] usesOptionalLibraries: com.google.android.media.effects com.motorola.hardware.frontcamera timeStamp=2015-05-13 14:04:24 firstInstallTime=2015-04-03 20:50:07 lastUpdateTime=2015-05-13 14:05:02 installerPackageName=com.xiaomi.market signatures=PackageSignatures{4397f8d8 [43980488]} permissionsFixed=true haveGids=true installStatus=1 pkgFlags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ] User 0: installed=true blocked=false stopped=false notLaunched=false enabled=0 grantedPermissions: android.permission.CHANGE_WIFI_MULTICAST_STATE com.tencent.qav.permission.broadcast com.tencent.photos.permission.DATA com.tencent.wifisdk.permission.disconnect

pm install , 安装应用

目标 apk 存放于 PC 端，请用 adb install 安装

目标 apk 存放于 Android 设备上，请用 pm install 安装

pm uninstall , 卸载应用，同 adb uninstall , 后面跟的参数都是应用的包名

pm clear , 清除应用数据

pm set-install-location , pm get-install-location , 设置应用安装位置，获取应用安装位置

[0/auto]：默认为自动

[1/internal]：默认为安装在手机内部

[2/external]：默认安装在外部存储

am

又是一个庞大的命令。。。

am 源码

am start , 启动一个 Activity，已启动系统相机应用为例

启动相机

[xuxu:~]$ adb shell am start -n com.android.camera/.Camera Starting: Intent { cmp=com.android.camera/.Camera }

先停止目标应用，再启动

[xuxu:~]$ adb shell am start -S com.android.camera/.Camera Stopping: com.android.camera Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.android.camera/.Camera }

等待应用完成启动

[xuxu:~]$ adb shell am start -W com.android.camera/.Camera Starting: Intent { act=android.intent.action.MAIN cat=[android.intent.category.LAUNCHER] cmp=com.android.camera/.Camera } Status: ok Activity: com.android.camera/.Camera ThisTime: 500 TotalTime: 500 Complete

启动默认浏览器打开一个网页

[xuxu:~]$ adb shell am start -a android.intent.action.VIEW -d http://testerhome.com Starting: Intent { act=android.intent.action.VIEW dat=http://testerhome.com }

启动拨号器拨打 10086

[xuxu:~]$ adb shell am start -a android.intent.action.CALL -d tel:10086 Starting: Intent { act=android.intent.action.CALL dat=tel:xxxxx }

am instrument , 启动一个 instrumentation , 单元测试或者 Robotium 会用到

am monitor , 监控 crash 与 ANR

[xuxu:~]$ adb shell am monitor Monitoring activity manager... available commands: (q)uit: finish monitoring ** Activity starting: com.android.camera

am force-stop , 后跟包名，结束应用

am startservice , 启动一个服务

am broadcast , 发送一个广播

还有很多的选项，自己多多发掘~~

input

这个命令可以向 Android 设备发送按键事件

input text , 发送文本内容，不能发送中文

adb shell input text test123456

前提先将键盘设置为英文键盘

input keyevent , 发送按键事件

adb shell input keyevent KEYCODE_HOME

模拟按下 Home 键 ，源码里面有定义：

public static final int KEYCODE_HOME = 3;

因此可以将命令中的 KEYCODE_HOME 替换为 3

input tap , 对屏幕发送一个触摸事件

adb shell input tap 500 500

点击屏幕上坐标为 500 500 的位置

input swipe , 滑动事件

adb shell input swipe 900 500 100 500

从右往左滑动屏幕

如果版本不低于 4.4 , 可以模拟长按事件

adb shell input swipe 500 500 501 501 2000

其实就是在小的距离内，在较长的持续时间内进行滑动，最后表现出来的结果就是长按动作

到这里会发现，MonkeyRunner 能做到的事情，通过 adb 命令都可以做得到，如果进行封装，会比 MR 做得更好。

screencap

截图命令

adb shell screencap -p /sdcard/screen.png

截屏，保存至 sdcard 目录

screenrecord

4.4 新增的录制命令

adb shell screenrecord sdcard/record.mp4

执行命令后操作手机，ctrl + c 结束录制，录制结果保存至 sdcard

uiautomator

执行 UI automation tests ， 获取当前界面的控件信息

runtest：executes UI automation tests

dump：获取控件信息，

[xuxu:~]$ adb shell uiautomator dump UI hierchary dumped to: /storage/emulated/legacy/window_dump.xml

不加 [file] 选项时，默认存放在 sdcard 下

ime

[xuxu:~]$ adb shell ime list -s com.google.android.inputmethod.pinyin/.PinyinIME com.baidu.input_mi/.ImeService

列出设备上的输入法

[xuxu:~]$ adb shell ime set com.baidu.input_mi/.ImeService Input method com.baidu.input_mi/.ImeService selected

选择输入法

wm

[xuxu:~]$ adb shell wm size Physical size: 1080x1920

获取设备分辨率

参考文献

Android 常用 adb 命令总结 ADB命令大全-Github