4.1.1 查看adb的版本信息#

1
adb version
2
1

4.1.2 启动adb#

1
adb start-server
2
1

一般无需手动执行此命令，在运行 adb 命令时若发现 adb server 没有启动会自动调起。

4.1.3 停止adb#

1
adb kill-server
2
1

4.1.4 以 root 权限运行 adbd#

1
adb root
2
1

4.1.5 指定 adb server 的网络端口#

1
adb -P <port> start-server
2
1

ADB的默认端口为 5037。

4.1.6 查询已连接的设备/模拟器列表#

1
adb devices
2
1

4.2.1 USB 连接#

通过 USB 连接来正常使用 adb 需要以下步骤：

1. 确认硬件状态正常(包括 Android 设备处于正常开机状态，USB 连接线和各种接口完好)。
2. Android 设备的开发者选项和 USB 调试模式已开启(可以在「设置」-「开发者选项」-「USB调试」打开USB调试)。
3. 确认设备驱动状态正常(安装ADB驱动程序)。
4. 通过 USB 线连接好电脑和设备后确认状态。
5. 通过 adb devices 命令查看设备连接情况。

4.2.2 WLAN 连接（需要 USB 线）#

借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤： 操作步骤：

1. 将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。
2. 将设备与电脑通过 USB 线连接(可通过 adb devices 命令查看设备连接情况)。
3. 通过 adb tcpip 5555 命令让设备在 5555 端口监听 TCP/IP 连接。
4. 断开 USB 连接。
5. 找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。
6. 通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。
7. 通过 adb devices 命令查看设备连接情况。
8. 使用完毕后可通过 adb disconnect <device-ip-address> 命令断开无线连接。

4.2.3 WLAN 连接（无需借助 USB 线）#

注：需要 root 权限。不借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤：

1. 在 Android 设备上安装一个终端模拟器(可通过Terminal Emulator for Android Downloads下载)。

2. 将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。

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

   su setprop service.adb.tcp.port 5555

4. 找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。

5. 通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。

6. 通过 adb devices 命令查看设备连接情况。

4.2.4 WiFi 连接转为 USB 连接#

通过adb usb命令以USB模式重新启动ADB：

1
adb usb
2
1

4.3.1 查看应用列表#

查看应用列表的基本命令格式是：

1
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
2
1

adb shell pm list packages 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

4.3.1.1 查看所有应用#

1
adb shell pm list packages
2
1

4.3.1.2 查看系统应用#

1
adb shell pm list packages -s
2
1

4.3.1.3 查看第三方应用#

1
adb shell pm list packages -3
2
1

4.3.1.4 包名包含某字符串的应用#

比如要查看包名包含字符串 huawei 的应用列表，命令：

1
adb shell pm list packages huawei
2
1

4.3.2 安装应用#

安装应用的基本命令格式是：

1
adb install [-l] [-r] [-t] [-s] [-d] [-g] <apk-file>
2
1

adb install 后面可以跟一些可选参数来控制安装 APK 的行为，可用参数及含义如下：

运行命令后可以看到输出内容，包含安装进度和状态，安装状态如下：

• Success：代表安装成功。
• Failure：代表安装失败。APK 安装失败的情况有很多，Failure状态之后有安装失败输出代码。常见安装失败输出代码、含义及可能的解决办法如下：

参考：PackageManager.java adb install 实际是分三步完成：

1. push apk 文件到 /data/local/tmp。
2. 调用 pm install 安装。
3. 删除 /data/local/tmp 下的对应 apk 文件。

4.3.3 卸载应用#

卸载应用的基本命令格式是：

1
adb uninstall [-k] <package-name>
2
1

<package-name> 表示应用的包名，-k 参数可选，表示卸载应用但保留数据和缓存目录。

4.3.4 清除应用数据与缓存#

1
adb shell pm clear <package-name>
2
1

<package-name> 表示应用名包，这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。

4.3.5 查看前台 Activity#

1
adb shell dumpsys activity activities | grep mFocusedActivity
2
1

4.3.6 查看正在运行的 Services#

1
adb shell dumpsys activity services [<package-name>]
2
1

<package-name> 参数不是必须的，指定 <package-name> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。<package-name> 不一定要给出完整的包名，可以只给一部分，那么所给包名相关的 Services 都会列出来。

4.3.7 查看应用详细信息#

1
adb shell dumpsys package <package-name>
2
1

<package-name> 表示应用包名。运行次命令的输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。

4.3.7 查看应用安装路径#

1
adb shell pm path <package-name>
2
1

4.4.1 启动应用/ 调起 Activity#

1
adb shell am start [options] <intent>
2
1

例如：

1
adb shell am start -a android.settings.SETTINGS                   # 打开系统设置页面
2
adb shell am start -a android.intent.action.DIAL -d tel:10086     # 打开拨号页面
3
adb shell am start -n com.android.mms/.ui.ConversationList        # 打开短信会话列表
4
123

options 是一些改变其行为的选项，支持的可选参数及含义如下：

4.4.2 调起 Service#

1
adb shell am startservice [options] <intent>
2
1

一个典型的用例是如果设备上原本应该显示虚拟按键但是没有显示，可以试试这个：

1
adb shell am startservice -n com.android.systemui/.SystemUIService
2
1

4.4.3 停止 Service#

1
adb shell am stopservice [options] <intent>
2
1

4.4.4 发送广播#

1
adb shell am broadcast [options] <INTENT>
2
1

可以向所有组件广播，也可以只向指定组件广播。 例如，向所有组件广播 BOOT_COMPLETED：

1
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED
2
1

又例如，只向 com.android.receiver.test/.BootCompletedReceiver 广播 BOOT_COMPLETED：

1
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n com.android.receiver.test/.BootCompletedReceiver
2
1

这类用法在测试的时候很实用，比如某个广播的场景很难制造，可以考虑通过这种方式来发送广播。 既能发送系统预定义的广播，也能发送自定义广播。如下是部分系统预定义广播及正常触发时机：

（以上广播均可使用 adb 触发）

4.4.5 强制停止应用#

1
adb shell am force-stop <packagename>
2
1

4.4.6 收紧内存#

1
adb shell am send-trim-memory  <pid> <level>
2
1

参数说明：

• pid: 进程 ID
• level、RUNNING_MODERATE、BACKGROUND、RUNNING_LOW、MODERATE、RUNNING_CRITICAL、COMPLETE

4.5.1 从模拟器/设备下载指定的文件到计算机#

从模拟器/设备下载指定的文件到计算机的基本命令格式是：

1
adb pull <remote> [local]
2
1

参数说明：

• remote: 模拟器/设备里的文件路径
• local:计算机上的目录，参数可以省略，默认复制到当前目录

例如，将 /sdcard/music.mp4 下载到计算机的当前目录：

1
adb pull /sdcard/music.mp4
2
1

将 /sdcard/music.mp4 下载到计算机的当前目录(目录需存在)：

adb pull /sdcard/music.mp4 D:\Download

4.5.2 将指定的文件从计算机上传到模拟器/设备#

将指定的文件从计算机上传到模拟器/设备的基本命令格式是：

1
adb push <local> <remote>
2
1

参数说明：

• local:计算机上的文件路径
• remote: 模拟器/设备里的目录

例如，将 D:\Download\music.mp4 下载到设备的/sdcard/music/目录：

1
adb push D:\Download\music.mp4 /sdcard/music/
2
1

4.5.4 列出指定目录的内容#

列出模拟器/设备上指定目录的内容的基本命令格式是：

1
adb shell ls [options] <directory>
2
1

<directory> 表示指定目录，可以省略，表示列出根目录下的所有文件和目录。 adb shell ls 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

4.5.5 切换到目标目录#

1
adb shell cd <directory>
2
1

第一步：执行adb shell命令； 第二步：执行cd <directory>命令切换到目标目录。

4.5.6 删除文件或目录#

1
adb shell rm [options] <files or directory>
2
1

第一步：执行adb shell命令； 第二步：执行rm [options] <files or directory>命令删除文件或目录。 rm 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

rm -d 等同于 rmdir 命令，有些版本不包含-d 参数。

4.5.7 创建目录#

1
adb shell mkdir [options] <directory-name>
2
1

第一步：执行adb shell命令； 第二步：执行mkdir [options] <directory-name>命令创建目录。 mkdir 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

4.5.8 创建空文件或改变文件时间戳#

1
adb shell touch [options] <file>
2
1

第一步：执行adb shell命令； 第二步：执行touch [options] <file>命令创建空文件或改变文件时间戳。 可通过ls -n <directory> 命令查看文件的时间。

4.5.9 输出当前目录路径#

1
adb shell pwd
2
1

第一步：执行adb shell命令； 第二步：执行pwd命令输出当前目录路径。

4.5.10 复制文件和目录#

1
adb shell cp [options] <source> <dest>
2
1

第一步：执行adb shell命令； 第二步：执行cp [options] <source> <dest>命令复制文件和目录。 参数说明：

• source:源文件路径
• dest: 目标文件路径

4.5.11 移动或重命名文件#

1
adb shell mv [options] <source> <dest>
2
1

第一步：执行adb shell命令； 第二步：执行mv [options] <source> <dest>命令移动或重命名文件。 参数说明：

• source:源文件路径
• dest: 目标文件路径

4.6.1 查看网络统计信息#

1
adb shell netstat
2
1

也可以将网络统计信息输出到指定文件：

1
adb shell netstat><file-path>
2
1

例如，可以通过 adb shell netstat>D:\netstat.log 将日志输出到 D:\netstat.log 中。

4.6.2 测试两个网络间的连接和延迟#

ping 命令的格式如下：

1
adb shell ping [-aAbBdDfhLnOqrRUvV] [-c count] [-i interval] [-I interface]
2
[-m mark] [-M pmtudisc_option] [-l preload] [-p pattern] [-Q tos]
3
[-s packetsize] [-S sndbuf] [-t ttl] [-T timestamp_option]
4
[-w deadline] [-W timeout] [hop1 ...] destination
5
1234

例如，ping一个域名：

1
adb shell ping www.google.com
2
1

不结束的话会一直ping下去，可以按 Ctrl + C 停止ping操作。 也可以指定ping的次数：

1
adb shell ping -c 4 www.google.com
2
1

4.6.3 通过配置文件配置和管理网络连接#

netcfg 命令的格式如下：

1
adb shell netcfg [<interface> {dhcp|up|down}]
2
1

输出示例：

1
rmnet_ims10 DOWN                                   0.0.0.0/0   0x00001002
2
rmnet_ims00 DOWN                                   0.0.0.0/0   0x00001002
3
rmnet_tun04 DOWN                                   0.0.0.0/0   0x00001002
4
rmnet_tun03 DOWN                                   0.0.0.0/0   0x00001002
5
rmnet_tun02 DOWN                                   0.0.0.0/0   0x00001002
6
rmnet_tun01 DOWN                                   0.0.0.0/0   0x00001002
7
rmnet_tun00 DOWN                                   0.0.0.0/0   0x00001002
8
rmnet_tun14 DOWN                                   0.0.0.0/0   0x00001002
9
rmnet_tun13 DOWN                                   0.0.0.0/0   0x00001002
10
rmnet_tun12 DOWN                                   0.0.0.0/0   0x00001002
11
rmnet_tun11 DOWN                                   0.0.0.0/0   0x00001002
12
rmnet_tun10 DOWN                                   0.0.0.0/0   0x00001002
13
rmnet1   DOWN                                   0.0.0.0/0   0x00001002
14
rmnet0   DOWN                                   0.0.0.0/0   0x00001002
15
rmnet4   DOWN                                   0.0.0.0/0   0x00001002
16
rmnet3   DOWN                                   0.0.0.0/0   0x00001002
17
rmnet2   DOWN                                   0.0.0.0/0   0x00001002
18
rmnet6   DOWN                                   0.0.0.0/0   0x00001002
19
rmnet5   DOWN                                   0.0.0.0/0   0x00001002
20
dummy0   UP                                     0.0.0.0/0   0x000000c3
21
rmnet_r_ims10 DOWN                                   0.0.0.0/0   0x00001002
22
rmnet_r_ims00 DOWN                                   0.0.0.0/0   0x00001002
23
rmnet_emc0 DOWN                                   0.0.0.0/0   0x00001002
24
lo       UP                                   127.0.0.1/8   0x00000049
25
sit0     DOWN                                   0.0.0.0/0   0x00000080
26
wlan0    UP                                 10.0.38.176/23  0x00001043
27
1234567891011121314151617181920212223242526

4.6.4 显示、操作路由、设备、策略路由和隧道#

ip 命令的格式如下：

1
adb shell ip [ options ] object
2
1

• 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认识的对象包括：

例如，查看 WiFi IP 地址：

1
adb shell ip -f inet addr show wlan0
2
1

4.7.1 电源键#

1
adb shell input keyevent 26
2
1

执行效果相当于按电源键。

4.7.2 菜单键#

1
adb shell input keyevent 82
2
1

4.7.3 HOME 键#

1
adb shell input keyevent 3
2
1

4.7.4 返回键#

1
adb shell input keyevent 4
2
1

4.7.5 音量控制#

增加音量：

1
adb shell input keyevent 24
2
1

降低音量：

1
adb shell input keyevent 25
2
1

静音：

1
adb shell input keyevent 164
2
1

4.7.6 媒体控制#

播放/暂停：

1
adb shell input keyevent 85
2
1

停止播放：

1
adb shell input keyevent 86
2
1

播放下一首：

1
adb shell input keyevent 87
2
1

播放上一首：

1
adb shell input keyevent 88
2
1

恢复播放：

1
adb shell input keyevent 126
2
1

暂停播放：

1
adb shell input keyevent 127
2
1

4.7.7 点亮/熄灭屏幕#

点亮屏幕：

1
adb shell input keyevent 224
2
1

熄灭屏幕：

1
adb shell input keyevent 223
2
1

4.7.8 滑动解锁#

如果锁屏没有密码，是通过滑动手势解锁，那么可以通过 input swipe 来解锁。 命令（参数以机型 Nexus 5，向上滑动手势解锁举例）：

1
adb shell input swipe 300 1000 300 500
2
1

参数 300 1000 300 500 分别表示起始点x坐标 起始点y坐标 结束点x坐标 结束点y坐标。

4.7.9 输入文本#

在焦点处于某文本框时，可以通过 input 命令来输入文本。

1
adb shell input text hello
2
1

4.8 日志打印#

Android 系统的日志分为两部分，底层的 Linux 内核日志输出到 /proc/kmsg，Android 的日志输出到 /dev/log。

4.8.1 Android 日志#

查看 Android 设备系统属性的基本命令格式是：

1
adb logcat [option] [filter-specs]
2
1

如果需要停止 logcat 日志打印，可以按 Ctrl + C 停止日志监控。

4.8.1.1 按级别过滤日志#

按级别过滤日志的基本命令格式是：

1
adb logcat [filter-specs]
2
1

Android 的日志分为如下几个优先级（priority）：

按某级别过滤日志则会将该级别及以上的日志输出。 比如，命令：

1
adb logcat *:W
2
1

会将 Warning、Error、Fatal 和 Silent 日志输出。 （注： 在 macOS 下需要给 * 这样以 * 作为 tag 的参数加双引号，如 adb logcat "*:W"，不然会报错 no matches found: *:W。）

4.8.1.2 按 tag 和级别过滤日志#

按 tag 和级别过滤日志的基本命令格式是：

1
adb logcat [tag:level] [tag:level] ...
2
1

比如，命令：

1
adb logcat ActivityManager:I MyApp:D *:S
2
1

表示输出 tag ActivityManager 的 Info 以上级别日志，输出 tag MyApp 的 Debug 以上级别日志，及其它 tag 的 Silent 级别日志（即屏蔽其它 tag 日志）。

4.8.1.3 将日志格式化输出#

可以用 adb logcat -v <format> 选项指定日志输出格式。 日志支持按以下几种 <format>：

日志格式默认为 brief，指定格式可与上面的过滤同时使用。比如：

1
adb logcat -v long ActivityManager:I *:S
2
1

4.8.1.3 清空已存在的日志#

1
adb logcat -c
2
1

4.8.1.4 将日志显示在控制台#

1
adb logcat -d
2
1

4.8.1.5 将日志输出到文件#

1
adb logcat -f <file-path>
2
1

4.8.1.6 加载一个可使用的日志缓冲区供查看#

1
adb logcat -b <Buffer>
2
1

Android log 输出量巨大，特别是通信系统的log，因此，Android把log输出到不同的缓冲区中，目前定义了四个log缓冲区：

缓冲区主要给系统组件使用，一般的应用不需要关心，应用的log都输出到main缓冲区中。默认log输出（不指定缓冲区的情况下）是输出System和Main缓冲区的log。

4.8.1.7 打印指定日志缓冲区的大小#

1
adb logcat -g
2
1

4.8.2 内核日志#

1
adb shell dmesg
2
1

输出示例：

1
<6>[14201.684016] PM: noirq resume of devices complete after 0.982 msecs
2
<6>[14201.685525] PM: early resume of devices complete after 0.838 msecs
3
<6>[14201.753642] PM: resume of devices complete after 68.106 msecs
4
<4>[14201.755954] Restarting tasks ... done.
5
<6>[14201.771229] PM: suspend exit 2016-08-28 13:31:32.679217193 UTC
6
<6>[14201.872373] PM: suspend entry 2016-08-28 13:31:32.780363596 UTC
7
<6>[14201.872498] PM: Syncing filesystems ... done.
8
1234567

中括号里的 [14201.684016] 代表内核开始启动后的时间，单位为秒。 通过内核日志我们可以做一些事情，比如衡量内核启动时间，在系统启动完毕后的内核日志里找到 Freeing init memory 那一行前面的时间就是。

4.9 查看 Android 设备系统属性#

查看 Android 设备系统属性的基本命令格式是：

1
adb shell getprop [options]
2
1

除了可以查看 Android 设备系统属性之外，还可以设置系统属性，设置系统属性的基本命令格式是：

1
adb shell setprop <key> <value>
2
1

4.9.1 查看设备型号#

1
adb shell getprop ro.product.model
2
1

输出示例：

1
Nexus 5
2
1

4.9.2 查看设备电池状况#

1
adb shell dumpsys battery
2
1

输出示例：

1
Current Battery Service state:
2
  AC powered: false
3
  USB powered: true
4
  Wireless powered: false
5
  status: 2
6
  health: 2
7
  present: true
8
  level: 44
9
  scale: 100
10
  voltage: 3872
11
  temperature: 280
12
  technology: Li-poly
13
123456789101112

其中 scale 代表最大电量，level 代表当前电量。上面的输出表示还剩下 44% 的电量。

4.9.3 查看设备屏幕分辨率#

1
adb shell wm size
2
1

输出示例：

1
Physical size: 1080x1920
2
1

该设备屏幕分辨率为 1080px * 1920px。 如果使用命令修改过，那输出可能是：

1
Physical size: 1080x1920
2
Override size: 480x1024
3
12

表明设备的屏幕分辨率原本是 1080px * 1920px，当前被修改为 480px * 1024px。

4.9.4 查看设备屏幕密度#

1
adb shell wm density
2
1

输出示例：

1
Physical density: 420
2
1

该设备屏幕密度为 420dpi。 如果使用命令修改过，那输出可能是：

1
Physical density: 480
2
Override density: 160
3
12

表明设备的屏幕密度原来是 480dpi，当前被修改为 160dpi。

4.9.5 查看设备显示屏参数#

1
adb shell dumpsys window displays
2
1

输出示例：

1
WINDOW MANAGER DISPLAY CONTENTS (dumpsys window displays)
2
  Display: mDisplayId=0
3
    init=1080x1920 420dpi cur=1080x1920 app=1080x1794 rng=1080x1017-1810x1731
4
    deferred=false layoutNeeded=false
5
1234

其中 mDisplayId 为 显示屏编号，init 是初始分辨率和屏幕密度，app 的高度比 init 里的要小，表示屏幕底部有虚拟按键，高度为 1920 - 1794 = 126px 合 42dp。

4.9.6 查看设备 android_id#

1
adb shell settings get secure android_id
2
1

输出示例：

1
51b6be48bac8c569
2
1

4.9.7 查看设备IMEI#

在 Android 4.4 及以下版本可通过如下命令获取 IMEI：

1
adb shell dumpsys iphonesubinfo
2
1

输出示例：

1
Phone Subscriber Info:
2
  Phone Type = GSM
3
  Device ID = 860955027785041
4
123

其中的 Device ID 就是 IMEI。 而在 Android 5.0 及以上版本里这个命令输出为空，得通过其它方式获取了（需要 root 权限）：

1
adb shell
2
su
3
service call iphonesubinfo 1
4
123

把里面的有效内容提取出来就是 IMEI 了，比如这里的是 860955027785041。 参考：adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop

4.9.8 查看设备 Android 系统版本#

1
adb shell getprop ro.build.version.release
2
1

输出示例：

1
5.0.2
2
1

4.9.9 查看设备 IP 地址#

1
adb shell ifconfig | grep Mask
2
1

在有的设备上这个命令没有输出，如果设备连着 WiFi，可以使用如下命令来查看局域网 IP：

1
adb shell ifconfig wlan0
2
1

如果以上命令仍然不能得到期望的信息，那可以试试以下命令（部分系统版本里可用）：

1
adb shell netcfg
2
1

4.9.10 查看设备 Mac 地址#

1
adb shell cat /sys/class/net/wlan0/address
2
1

输出示例：

1
f8:a9:d0:17:42:4d
2
1

这查看的是局域网 Mac 地址，移动网络或其它连接的信息可以通过前面的小节「IP 地址」里提到的 adb shell netcfg 命令来查看。

4.9.11 查看设备 CPU 信息#

1
adb shell cat /proc/cpuinfo
2
1

4.9.12 查看设备内存信息#

1
adb shell cat /proc/meminfo
2
1

4.10 修改设置#

注： 修改设置之后，运行恢复命令有可能显示仍然不太正常，可以运行 adb reboot 重启设备，或手动重启。 修改设置的原理主要是通过 settings 命令修改 /data/data/com.android.providers.settings/databases/settings.db 里存放的设置值。

4.10.1 修改分辨率#

1
adb shell wm size 480x1024
2
1

表示将分辨率修改为 480px * 1024px。 恢复原分辨率命令：

1
adb shell wm size reset
2
1

4.10.2 修改屏幕密度#

1
adb shell wm density 160
2
1

表示将屏幕密度修改为 160dpi。 恢复原屏幕密度命令：

1
adb shell wm density reset
2
1

4.10.3 修改显示区域#

1
adb shell wm overscan 0,0,0,200
2
1

四个数字分别表示距离左、上、右、下边缘的留白像素，以上命令表示将屏幕底部 200px 留白。 恢复原显示区域命令：

1
adb shell wm overscan reset
2
1

4.10.4 修改关闭 USB 调试模式#

1
adb shell settings put global adb_enabled 0
2
1

用命令恢复不了了，毕竟关闭了 USB 调试 adb 就连接不上 Android 设备了。 去设备上手动恢复吧：「设置」-「开发者选项」-「Android 调试」。

4.10.5 修改允许/禁止访问非 SDK API#

允许访问非 SDK API：

1
adb shell settings put global hidden_api_policy_pre_p_apps 1
2
adb shell settings put global hidden_api_policy_p_apps 1
3
12

禁止访问非 SDK API：

1
adb shell settings delete global hidden_api_policy_pre_p_apps
2
adb shell settings delete global hidden_api_policy_p_apps
3
12

不需要设备获得 Root 权限。 命令最后的数字的含义：

4.10.6 修改状态栏和导航栏的显示隐藏#

1
adb shell settings put global policy_control <key-values>
2
1

<key-values> 可由如下几种键及其对应的值组成，格式为 <key1>=<value1>:<key2>=<value2>。

这些键对应的值可则如下值用逗号组合：

例如：

1
adb shell settings put global policy_control immersive.full=*
2
1

表示设置在所有界面下都同时隐藏状态栏和导航栏。

1
adb shell settings put global policy_control immersive.status=com.package1,com.package2:immersive.navigation=apps,-com.package3
2
1

表示设置在包名为 com.package1 和 com.package2 的应用里隐藏状态栏，在除了包名为 com.package3 的所有应用里隐藏导航栏。

4.11.1 屏幕截图#

截图保存到电脑：

1
adb exec-out screencap -p > sc.png
2
1

如果 adb 版本较老，无法使用 exec-out 命令，这时候建议更新 adb 版本。无法更新的话可以使用以下麻烦点的办法： 先截图保存到设备里：

1
adb shell screencap -p /sdcard/sc.png
2
1

然后将 png 文件导出到电脑：

1
adb pull /sdcard/sc.png
2
1

可以使用 adb shell screencap -h 查看 screencap 命令的帮助信息，下面是两个有意义的参数及含义：

实测如果指定文件名以 .png 结尾时可以省略 -p 参数；否则需要使用 -p 参数。如果不指定文件名，截图文件的内容将直接输出到 stdout。 另外一种一行命令截图并保存到电脑的方法： Linux 和 Windows

1
adb shell screencap -p | sed "s/\r$//" > sc.png
2
1

Mac OS X

1
adb shell screencap -p | gsed "s/\r$//" > sc.png
2
1

这个方法需要用到 gnu sed 命令，在 Linux 下直接就有，在 Windows 下 Git 安装目录的 bin 文件夹下也有。如果确实找不到该命令，可以下载 sed for Windows 并将 sed.exe 所在文件夹添加到 PATH 环境变量里。 而在 Mac 下使用系统自带的 sed 命令会报错：

1
sed: RE error: illegal byte sequence
2
1

需要安装 gnu-sed，然后使用 gsed 命令：

1
brew install gnu-sed
2
1

4.11.2 录制屏幕#

录制屏幕以 mp4 格式保存到 /sdcard：

1
adb shell screenrecord /sdcard/filename.mp4
2
1

需要停止时按 Ctrl-C，默认录制时间和最长录制时间都是 180 秒。 如果需要导出到电脑：

1
adb pull /sdcard/filename.mp4
2
1

可以使用 adb shell screenrecord --help 查看 screenrecord 命令的帮助信息，下面是常见参数及含义：

4.11.3 查看连接过的 WiFi 密码#

注：需要 root 权限。

1
adb shell
2
su
3
cat /data/misc/wifi/*.conf
4
123

4.11.4 设置系统日期和时间#

注：需要 root 权限。

1
adb shell
2
su
3
date -s 20160823.131500
4
123

表示将系统日期和时间更改为 2016 年 08 月 23 日 13 点 15 分 00 秒。

4.11.5 重启手机#

1
adb reboot
2
1

4.11.6 检测设备是否已 root#

1
adb shell
2
su
3
12

此时命令行提示符是 $ 则表示没有 root 权限，是 # 则表示已 root。

4.11.7 使用 Monkey 进行压力测试#

Monkey 可以生成伪随机用户事件来模拟单击、触摸、手势等操作，可以对正在开发中的程序进行随机压力测试。 简单用法：

1
adb shell monkey -p <packagename> -v 500
2
1

表示向 <packagename> 指定的应用程序发送 500 个伪随机事件。 Monkey 的详细用法参考 官方文档。

4.11.8 开启/关闭 WiFi#

注：需要 root 权限。 开启 WiFi：

1
adb root
2
adb shell svc wifi enable
3
12

关闭 WiFi：

1
adb root
2
adb shell svc wifi disable
3
12

若执行成功，输出为空；若未取得 root 权限执行此命令，将执行失败，输出 Killed。

4.12.1 重启到 Recovery 模式#

1
adb reboot recovery
2
1

4.12.2 从 Recovery 重启到 Android#

1
adb reboot
2
1

4.12.3 重启到 Fastboot 模式#

1
adb reboot bootloader
2
1

4.12.4 通过 sideload 更新系统#

如果我们下载了 Android 设备对应的系统更新包到电脑上，那么也可以通过 adb 来完成更新。 以 Recovery 模式下更新为例：

1. 重启到 Recovery 模式。

   adb reboot recovery

2. 在设备的 Recovery 界面上操作进入 Apply update-Apply from ADB。注：不同 的 Recovery 菜单可能与此有差异，有的是一级菜单就有 Apply update from ADB。

3. 通过 adb 上传和更新系统。

   adb sideload <path-to-update.zip>

4.13.1 启用/禁用 SELinux#

启用 SELinux

1
adb root
2
adb shell setenforce 1
3
12

禁用 SELinux

1
adb root
2
adb shell setenforce 0
3
12

4.13.2 启用/禁用 dm_verity#

启用 dm_verity

1
adb root
2
adb enable-verity
3
12

禁用 dm_verity

1
adb root
2
adb disable-verity
3
12

4.14 更多 adb shell 命令#

Android 系统是基于 Linux 内核的，所以 Linux 里的很多命令在 Android 里也有相同或类似的实现，在 adb shell 里可以调用。本文档前面的部分内容已经用到了 adb shell 命令。

4.14.1 查看进程状态#

1
adb shell ps
2
1

输出信息各列含义：

4.14.2 查看处理器实时状态#

1
adb shell top [-m max_procs] [-n iterations] [-d delay] [-s sort_column] [-t] [-h]
2
1

adb shell top 后面可以跟一些可选参数进行过滤查看不同的列表，可用参数及含义如下：

输出信息各列含义：

4.14.3 查看进程 UID#

有两种方案：

1. adb shell dumpsys package <packagename> | grep userId= 如：

   adb shell dumpsys package org.mazhuang.guanggoo | grep userId= userId=10394

2. 通过 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 gemini:/$ cat /proc/28635/status | grep Uid Uid: 10394 10394 10394 10394 gemini:/ $