ADB 操作命令及用法_adb 点击

ADB 操作命令及用法

一、ADB是什么？

adb 称之为：

Android 调试桥 （Android Debug Bridge ）是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具，可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。

可以在Android SDK/platform-tools中找到 adb 工具或下载 ADB Kits 。

注意：

有部分命令的支持情况可能与 Android 系统版本及定制 ROM 的实现有关。

二、ADB有什么作用？

ADB 是 Android SDK 里的一个工具, 用这个工具可以直接操作管理Android模拟器或者真实的Android设备。

主要功能有:

• 在设备上运行Shell命令；
• 将本地APK软件安装至模拟器或Android设备；
• 管理设备或手机模拟器上的预定端口；
• 在设备或手机模拟器上复制或粘贴文件。

ADB 是一个客户端-服务器程序程序，包括三个组件：

• 客户端：该组件发送命令。客户端在开发计算机上运行。可以通过发出 adb 命令从命令行终端调用客户端。
• 后台程序：该组件在设备上运行命令。后台程序在每个模拟器或设备实例上作为后台进程运行。
• 服务器：该组件管理客户端和后台程序之间的通信。服务器在开发计算机上作为后台进程运行。

三、ADB命令语法

adb 命令的基本语法如下：

adb [-d|-e|-s <serial-number>] <command>
1

单一设备/模拟器连接

若仅一个设备/模拟器连接时，可以省略掉 [-d|-e|-s <serial-number>] 这一部分，直接使用 adb <command>。

多个设备/模拟器连接

若有多个设备/模拟器连接，则需要为命令指定目标设备，下表是指定目标设备的命令选项：

在多个设备/模拟器连接的情况下较常用的是 -s <serial-number> 参数，serial-number是指设备的设备序列号，可以通过 adb devices 命令获取。

4.1 基本命令

4.1.1 查看adb的版本信息

adb version
1

4.1.2 启动adb

adb start-server
1

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

4.1.3 停止adb

adb kill-server
1

4.1.4 以 root 权限运行 adbd

adb root
1

4.1.5 指定 adb server 的网络端口

adb -P <port> start-server
1

注意：

ADB的默认端口为 5037。

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

adb devices
1

4.2 应用管理

4.2.1 查看应用列表

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

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

adb shell pm list packages 后面可以跟一些可选参数进行过滤查看不同的列表，

可用参数及含义如下：

4.2.1.1 查看所有应用

adb shell pm list packages
1

4.2.1.2 查看系统应用

adb shell pm list packages -s
1

4.2.1.3 查看第三方应用

adb shell pm list packages -3
1

4.2.1.4 查看已禁用应用

adb shell pm list packages -d
1

4.2.1.5 查看已启用应用

adb shell pm list packages -e
1

4.2.1.6 查看应用及其安装信息（安装来源）

adb shell pm list packages -i
1

4.2.1.7 查看应用及其未安装信息（安装来源）

adb shell pm list packages -u
1

4.2.1.8 查看应用及其相关联的文件

adb shell pm list packages -f
1

4.2.1.9 包名包含某字符串的应用

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

adb shell pm list packages <package>
1

4.2.2 安装应用

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

adb install [-l] [-r] [-t] [-s] [-d] [-g] <apk-file>
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.2.3 卸载应用

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

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

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

4.2.4 清理应用数据与缓存

adb shell pm clear <package-name>
1

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

4.2.5 查看前台 Activity

adb shell dumpsys activity activities | grep mFocusedActivity
1

4.2.6 查看正在运行的 Services

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

<package-name> 参数不是必须的，指定 <package-name> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。

<package-name> 不一定要给出完整的包名，可以仅给一部分，那么所给包名相关的 Services 都会列出来。

4.2.7 查看应用详细信息

adb shell dumpsys package <package-name>
1

<package-name> 表示应用包名。

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

4.2.7 查看应用安装路径

adb shell pm path <package-name>
1

4.3 与应用交互

与应用交互主要是使用 am <command> 命令，常用的 <command> 如下：

<intent> 参数很灵活，和写 Android 程序时代码里的 Intent 相对应。

用于决定 intent 对象的选项如下：

<intent> 里还能带数据，就像写代码时的 Bundle 一样：

4.3.1 启动应用/ 调起 Activity

adb shell am start [options] <intent>
1

例如：

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        # 打开短信会话列表
1
2
3

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

4.3.2 调起 Service

adb shell am startservice [options] <intent>
1

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

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

4.3.3 停止 Service

adb shell am stopservice [options] <intent>
1

4.3.4 强制停止应用

adb shell am force-stop <packagename>
1

4.4 文件管理

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

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

adb pull <remote> [local]
1

参数说明：

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

例如，将 /sdcard/<package>.apk 下载到当前目录：

adb pull /sdcard/<package>.apk
1

将 /sdcard/<package>.apk 下载到相应目录(目录需存在)：

adb pull /sdcard/<package>.apk D:\Download
1

提示：

该操作可结合上文所描述的查看应用安装路径的操作以达到导出相应的应用软件的目的。

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

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

adb push <local> <remote>
1

参数说明：

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

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

adb push D:\Download\ /sdcard/music/
1

4.4.4 列出指定目录的内容

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

adb shell ls [options] <directory>
1

<directory> 表示指定目录，可以省略，表示列出根目录下的所有文件和目录。

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

4.4.5 切换到目标目录

adb shell cd <directory>
1

第一步：执行adb shell命令；

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

4.4.6 删除文件或目录

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

第一步：执行adb shell命令；

第二步：执行rm [options] <files or directory>命令删除文件或目录。

rm 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

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

4.4.7 创建目录

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

第一步：执行adb shell命令；

第二步：执行mkdir [options] <directory-name>命令创建目录。

mkdir 后面可以跟一些可选参数进行不同的操作，可用参数及含义如下：

4.4.8 创建空文件或改变文件时间戳

adb shell touch [options] <file>
1

第一步：执行adb shell命令；

第二步：执行touch [options] <file>命令创建空文件或改变文件时间戳。

可通过ls -n <directory> 命令查看文件的时间。

4.4.9 输出当前目录路径

adb shell pwd
1

第一步：执行adb shell命令；

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

4.4.10 复制文件和目录

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

第一步：执行adb shell命令；

第二步：执行cp [options] <source> <dest>命令复制文件和目录。

参数说明：

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

4.4.11 移动或重命名文件

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

第一步：执行adb shell命令；

第二步：执行mv [options] <source> <dest>命令移动或重命名文件。

参数说明：

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

4.5 网络管理

4.5.1 查看网络统计信息

adb shell netstat
1

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

adb shell netstat > <file-path>
1

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

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

ping 命令的格式如下：

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
1
2
3
4

例如，ping一个域名：

adb shell ping <域名>
1

不结束的话会一直ping下去，可以按 Ctrl + C 停止ping操作。

也可以指定ping的次数：

adb shell ping -c 4 <域名>
1

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

netcfg 命令的格式如下：

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

输出示例：

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
复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

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

ip 命令的格式如下：

adb shell ip [ options ] object
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]}
  1

• object := { link | addr | addrlabel | route | rule | neigh | ntable |tunnel | tuntap | maddr | mroute | mrule | monitor | xfrm |netns | l2tp }
  1

options 是一些修改ip行为或者改变其输出的选项。

所有的选项都是以-字符开头，分为长、短两种形式，支持的可选参数及含义如下：

object 是要管理或者获取信息的对象。

目前ip认识的对象包括：

例如，查看 WiFi IP 地址：

adb shell ip -f inet addr show wlan0
1

4.6 模拟按键/输入

在 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)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

比如使用 adb shell input keyevent <keycode> 命令，不同的 keycode 能实现不同的功能，完整的 keycode 列表详见 KeyEvent，摘引部分觉得有意思的如下：

下面是 input 命令的一些用法举例。

4.6.1 电源键

adb shell input keyevent 26
1

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

4.6.2 菜单键

adb shell input keyevent 82
1

4.6.3 HOME 键

adb shell input keyevent 3
1

4.6.4 返回键

adb shell input keyevent 4
1

4.6.5 音量控制

• 增加音量：

adb shell input keyevent 24
1

• 降低音量：

adb shell input keyevent 25
1

• 静音：

adb shell input keyevent 16
1

4.6.6 媒体控制

• 播放/暂停：

adb shell input keyevent 85
1

• 停止播放：

adb shell input keyevent 86
1

• 播放下一首：

adb shell input keyevent 87
1

• 播放上一首：

adb shell input keyevent 88
1

• 恢复播放：

adb shell input keyevent 126
1

• 暂停播放：

adb shell input keyevent 127
1

4.6.7 点亮/熄灭屏幕

• 点亮屏幕：

adb shell input keyevent 224
1

• 熄灭屏幕：

adb shell input keyevent 223
1

4.6.8 滑动解锁

若锁屏没有密码，是通过滑动手势解锁，那么可以通过 input swipe 来解锁。

命令（向上滑动手势解锁举例）：

adb shell input swipe 300 1000 300 500
1

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

4.6.9 输入文本

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

adb shell input text hello
1

4.7 日志打印

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

4.7.1 Android 日志

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

adb logcat [option] [filter-specs]
1

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

4.7.1.1 按级别过滤日志

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

adb logcat [filter-specs]
1

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