awesome-adb/README.md

ADB 用法大全

ADB，即 Android Debug Bridge，它是 Android 开发/测试人员不可替代的强大工具，也是 Android 设备玩家的好玩具。

持续更新中，欢迎补充指正。

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

目录

• 基本用法
  • 命令语法
  • 为命令指定目标设备
  • 启动/停止
• 设备连接管理
  • 查询已连接设备/模拟器
  • USB 连接
  • 无线连接
• 应用管理
  • 查看应用列表
    • 所有应用
    • 系统应用
    • 第三方应用
    • 包名包含某字符串的应用
  • 安装 APK
  • 卸载应用
  • 查看前台 Activity
• 与应用交互
  • 调起 Activity
  • 调起 Service
  • 发送广播
  • 强制停止应用
• 文件管理
  • 复制设备里的文件到电脑
  • 复制电脑里的文件到设备
• 调试
  • 查看/过滤日志
• 查看设备信息
  • 型号
  • 电池状况
  • 屏幕分辨率
  • 屏幕密度
  • 显示屏参数
  • android_id
  • IMEI
  • Android 系统版本
  • 更多硬件与系统属性
• 实用功能
  • 屏幕截图
  • 录制屏幕
  • 重新挂载 system 分区为可写
• 其它常用 adb shell 命令
• 参考链接

基本用法

命令语法

adb 命令的基本语法如下：

adb [-d|-e|-s <serialNumber>] <command>

如果只有一个设备/模拟器连接时，可以省略掉 [-d|-e|-s <serialNumber>] 这一部分，直接使用 adb <command>。

为命令指定目标设备

如果有多个设备/模拟器连接，则需要为命令指定目标设备。

参数	含义
-d	指定当前唯一通过 USB 连接的 Android 设备为命令目标
-e	指定当前唯一运行的模拟器为命令目标
-s	指定相应 serialNumber 号的设备/模拟器为命令目标

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

$ adb devices

List of devices attached
cf264b8f	device
emulator-5554	device

输出里的 cf264b8f 和 emulator-5554 即为 serialNumber。比如这时想指定 cf264b8f 这个设备来运行 adb 命令获取屏幕分辨率：

adb -s cf264b8f shell wm size

遇到多设备/模拟器的情况均使用这几个参数为命令指定目标设备，下文中为简化描述，不再重复。

启动/停止

启动 adb server 命令：

adb start-server

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

停止 adb server 命令：

adb kill-server

设备连接管理

查询已连接设备/模拟器

命令：

adb devices

输出示例：

List of devices attached
cf264b8f	device
emulator-5554	device

输出格式为 [serialNumber] [state]，serialNumber 即我们常说的 SN，state 有如下几种：

• offline —— 表示设备未连接成功或无响应。

• device —— 设备已连接。注意这个状态并不能标识 Android 系统已经完全启动和可操作，在设备启动过程中设备实例就可连接到 adb，但启动完毕后系统才处于可操作状态。

• no device —— 没有设备/模拟器连接。

以上输出显示当前已经连接了两台设备/模拟器，cf264b8f 与 emulator-5554 分别是它们的 SN。从 emulator-5554 这个名字可以看出它是一个 Android 模拟器。

常见异常输出：

1. 没有设备/模拟器连接成功。

   List of devices attached
   

2. 设备/模拟器未连接到 adb 或无响应。

   List of devices attached
   cf264b8f	offline
   

USB 连接

// TODO

无线连接

// TODO

应用管理

查看应用列表

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

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

即在 adb shell pm list packages 的基础上可以加一些参数进行过滤查看不同的列表，支持的过滤参数如下：

参数	显示列表
无	所有应用
-f	显示应用关联的 apk 文件
-d	只显示 disabled 的应用
-e	只显示 enabled 的应用
-s	只显示系统应用
-3	只显示第三方应用
-i	显示应用的 installer
-u	包含已卸载应用
FILTER	包名包含 FILTER 字符串

所有应用

命令：

adb shell pm list packages

输出示例：

package:com.android.smoketest
package:com.example.android.livecubes
package:com.android.providers.telephony
package:com.google.android.googlequicksearchbox
package:com.android.providers.calendar
package:com.android.providers.media
package:com.android.protips
package:com.android.documentsui
package:com.android.gallery
package:com.android.externalstorage
...
// other packages here
...

系统应用

命令：

adb shell pm list packages -s

第三方应用

命令：

adb shell pm list packages -3

包名包含某字符串的应用

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

adb shell pm list packages mazhuang

当然也可以使用 grep 来过滤：

adb shell pm list packages | grep mazhuang

安装 APK

命令：

adb install <apk file>

参数：

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

参数	含义
-r	允许覆盖安装。
-s	将应用安装到 sdcard。
-d	允许降级覆盖安装。

完整参数列表及含义可以直接运行 adb 命令然后查看 adb install [-lrtsdg] <file> 一节。

如果见到类似如下输出（状态为 Success）代表安装成功：

12040 KB/s (22205609 bytes in 1.801s)
        pkg: /data/local/tmp/SogouInput_android_v8.3_sweb.apk
Success

而如果状态为 Failure 则表示安装失败。常见安装失败输出代码、含义及可能的解决办法如下：

输出	含义	解决办法
INSTALL_FAILED_ALREADY_EXISTS	应用已经存在	使用 -r 参数
INSTALL_FAILED_INVALID_APK	无效的 APK 文件
INSTALL_FAILED_INVALID_URI	无效的 APK 文件名	确保 APK 文件名里无中文
INSTALL_FAILED_INSUFFICIENT_STORAGE	空间不足	清理空间
INSTALL_FAILED_DUPLICATE_PACKAGE	已经存在同名程序
INSTALL_FAILED_NO_SHARED_USER	请求的共享用户不存在
INSTALL_FAILED_UPDATE_INCOMPATIBLE	已经安装过签名不一样的同名应用，且数据没有移除
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE	请求的共享用户存在但签名不一致
INSTALL_FAILED_MISSING_SHARED_LIBRARY	安装包使用了设备上不可用的共享库
INSTALL_FAILED_REPLACE_COULDNT_DELETE	替换时无法删除
INSTALL_FAILED_DEXOPT	dex 优化验证失败或空间不足
INSTALL_FAILED_OLDER_SDK	设备系统版本低于应用要求
INSTALL_FAILED_CONFLICTING_PROVIDER	设备里已经存在与应用里同名的 content provider
INSTALL_FAILED_NEWER_SDK	设备系统版本高于应用要求
INSTALL_FAILED_TEST_ONLY	应用是 test-only 的，但安装时没有指定 -t 参数
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE	包含不兼容设备 CPU 应用程序二进制接口的 native code
INSTALL_FAILED_MISSING_FEATURE	应用使用了设备不可用的功能
INSTALL_FAILED_CONTAINER_ERROR	sdcard 访问失败	确认 sdcard 可用，或者安装到内置存储
INSTALL_FAILED_INVALID_INSTALL_LOCATION	不能安装到指定位置	切换安装位置，添加或删除 -s 参数
INSTALL_FAILED_MEDIA_UNAVAILABLE	安装位置不可用	一般为 sdcard，确认 sdcard 可用或安装到内置存储
INSTALL_FAILED_VERIFICATION_TIMEOUT	验证安装包超时
INSTALL_FAILED_VERIFICATION_FAILURE	验证安装包失败
INSTALL_FAILED_PACKAGE_CHANGED	应用与调用程序期望的不一致
INSTALL_FAILED_UID_CHANGED	以前安装过该应用，与本次分配的 UID 不一致	清除以前安装过的残留文件
INSTALL_FAILED_VERSION_DOWNGRADE	已经安装了该应用更高版本	使用 -d 参数
INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE	已安装 target SDK 支持运行时权限的同名应用，要安装的版本不支持运行时权限
INSTALL_PARSE_FAILED_NOT_APK	指定路径不是文件，或不是以 .apk 结尾
INSTALL_PARSE_FAILED_BAD_MANIFEST	无法解析的 AndroidManifest.xml 文件
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION	解析器遇到异常
INSTALL_PARSE_FAILED_NO_CERTIFICATES	安装包没有签名
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES	已安装该应用，且签名与 APK 文件不一致	先卸载设备上的该应用，再安装
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING	解析 APK 文件时遇到 CertificateEncodingException
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME	manifest 文件里没有或者使用了无效的包名
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID	manifest 文件里指定了无效的共享用户 ID
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED	解析 manifest 文件时遇到结构性错误
INSTALL_PARSE_FAILED_MANIFEST_EMPTY	在 manifest 文件里找不到找可操作标签（instrumentation 或 application）
INSTALL_FAILED_INTERNAL_ERROR	因系统问题安装失败
INSTALL_FAILED_USER_RESTRICTED	用户被限制安装应用
INSTALL_FAILED_DUPLICATE_PERMISSION	应用尝试定义一个已经存在的权限名称
INSTALL_FAILED_NO_MATCHING_ABIS	应用包含设备的应用程序二进制接口不支持的 native code
INSTALL_CANCELED_BY_USER	应用安装需要在设备上确认，但未操作设备或点了取消	在设备上同意安装
INSTALL_FAILED_ACWF_INCOMPATIBLE	应用程序与设备不兼容
does not contain AndroidManifest.xml	无效的 APK 文件
is not a valid zip file	无效的 APK 文件
Offline	设备未连接成功	先将设备与 adb 连接成功
unauthorized	设备未授权允许调试
error: device not found	没有连接成功的设备	先将设备与 adb 连接成功
protocol failure	设备已断开连接	先将设备与 adb 连接成功
Unknown option: -s	Android 2.2 以下不支持安装到 sdcard	不使用 -s 参数
No space left on devicerm	空间不足	清理空间
Permission denied ... sdcard ...	sdcard 不可用

参考：PackageManager.java

卸载应用

命令：

adb uninstall [-k] <packagename>

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

命令示例：

adb uninstall com.qihoo360.mobilesafe

表示卸载 360 手机卫士。

查看前台 Activity

命令：

adb shell dumpsys activity activities | grep mFocusedActivity

输出示例：

mFocusedActivity: ActivityRecord{8079d7e u0 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher t42}

其中的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher 就是当前处于前台的 Activity。

与应用交互

调起 Activity

// TODO

调起 Service

// TODO

发送广播

// TODO

强制停止应用

命令：

adb shell am force-stop <packagename>

命令示例：

adb shell am force-stop com.qihoo360.mobilesafe

表示停止 360 安全卫士的一切进程与服务。

文件管理

复制设备里的文件到电脑

命令：

adb pull <设备里的文件路径> [电脑上的目录] 

其中 电脑上的目录 参数可以省略，默认复制到当前目录。

例：

adb pull /sdcard/sr.mp4 ~/tmp/

*小技巧：*设备上的文件路径可能需要 root 权限才能访问，如果你的设备已经 root 过，可以先使用 adb shell 和 su 命令在 adb shell 里获取 root 权限后，先 cp /path/on/device /sdcard/filename 将文件复制到 sdcard，然后 adb pull /sdcard/filename /path/on/pc。

复制电脑里的文件到设备

命令：

adb push <电脑上的文件路径> <设备里的目录> 

例：

adb push ~/sr.mp4 /sdcard/

*小技巧：*设备上的文件路径普通权限可能无法直接写入，如果你的设备已经 root 过，可以先 adb push /path/on/pc /sdcard/filename，然后 adb shell 和 su 在 adb shell 里获取 root 权限后，cp /sdcard/filename /path/on/device。

调试

查看/过滤日志

// TODO

查看设备信息

型号

命令：

adb shell getprop ro.product.model

输出示例：

Nexus 5

电池状况

命令：

adb shell dumpsys battery

输入示例：

Current Battery Service state:
  AC powered: false
  USB powered: true
  Wireless powered: false
  status: 2
  health: 2
  present: true
  level: 44
  scale: 100
  voltage: 3872
  temperature: 280
  technology: Li-poly

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

屏幕分辨率

命令：

adb shell wm size

输出示例：

Physical size: 1080x1920

该设备屏幕分辨率为 1080px * 1920px。

屏幕密度

命令：

adb shell wm density

输出示例：

Physical density: 420

该设备屏幕密度为 420dpi。

显示屏参数

命令：

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
  mStacks[0]0
    mStackId=0
    mDeferDetach=false
    {taskId=60 appTokens=[AppWindowToken{973efda token=Token{4ec6585 ActivityRecord{209cafc u0 com.google.android.googlequicksearchbox/com.google.android.launcher.GEL t60}}}] mdr=false}

  Application tokens in top down Z order:
  mStackId=0
    mTaskId=60
    Activity #0 AppWindowToken{973efda token=Token{4ec6585 ActivityRecord{209cafc u0 com.google.android.googlequicksearchbox/com.google.android.launcher.GEL t60}}}:
      windows=[Window{bd0ea61 u0 com.google.android.googlequicksearchbox/com.google.android.launcher.GEL}]
      windowType=2 hidden=false hasVisible=true
      app=true voiceInteraction=false
      allAppWindows=[Window{bd0ea61 u0 com.google.android.googlequicksearchbox/com.google.android.launcher.GEL}]
      task={taskId=60 appTokens=[AppWindowToken{973efda token=Token{4ec6585 ActivityRecord{209cafc u0 com.google.android.googlequicksearchbox/com.google.android.launcher.GEL t60}}}] mdr=false}
       appFullscreen=true requestedOrientation=5
      hiddenRequested=false clientHidden=false willBeHidden=false reportedDrawn=true reportedVisible=true
      numInterestingWindows=1 numDrawnWindows=1 inPendingTransaction=false allDrawn=true (animator=true)
      startingData=null removed=false firstWindowDrawn=true mIsExiting=false

// TODO

android_id

命令：

adb shell settings get secure android_id

输出示例：

51b6be48bac8c569

IMEI

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

adb shell dumpsys iphonesubinfo

输出示例：

Phone Subscriber Info:
  Phone Type = GSM
  Device ID = 860955027785041

其中的 Device ID 就是 IMEI。

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

adb shell
su
service call iphonesubinfo 1

输出示例：

Result: Parcel(
  0x00000000: 00000000 0000000f 00360038 00390030 '........8.6.0.9.'
  0x00000010: 00350035 00320030 00370037 00350038 '5.5.0.2.7.7.8.5.'
  0x00000020: 00340030 00000031                   '0.4.1...        ')

把里面的有效内容提取出来就是 IMEI 了，比如这里的是 860955027785041。

参考：adb shell dumpsys iphonesubinfo not working since Android 5.0 Lollipop

Android 系统版本

命令：

adb shell getprop ro.build.version.release

输出示例：

5.0.2

更多硬件与系统属性

设备的更多硬件与系统属性可以通过如下命令查看：

adb shell cat /system/build.prop

这会输出很多信息，包括前面几个小节提到的「型号」和「Android 系统版本」等。

输出里还包括一些其它有用的信息，它们也可通过 adb shell getprop <属性名> 命令单独查看，列举一部分属性如下：

属性名	含义
ro.build.version.sdk	SDK 版本
ro.build.version.release	Android 系统版本
ro.build.version.security_patch	Android 安全补丁程序级别
ro.product.model	型号
ro.product.brand	品牌
ro.product.name	设备名
ro.product.board	处理器型号
ro.product.cpu.abilist	CPU 支持的 abi 列表
persist.sys.isUsbOtgEnabled	是否支持 OTG
dalvik.vm.heapsize	每个应用程序的内存上限
ro.sf.lcd_density	屏幕密度

实用功能

屏幕截图

命令：

adb shell screencap -p /sdcard/sc.png

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

adb pull /sdcard/sc.png

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

参数	含义
-p	指定保存文件为 png 格式
-d display-id	指定截图的显示屏编号（有多显示屏的情况下）

实测如果指定文件名以 .png 结尾时可以省略 -p 参数；否则需要使用 -p 参数。如果不指定文件名，截图文件的内容将直接输出到 stdout。

录制屏幕

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

adb shell screenrecord /sdcard/filename.mp4

需要停止时按 Ctrl-C，默认录制时间和最长录制时间都是 180 秒。

如果需要导出到电脑：

adb pull /sdcard/filename.mp4

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

参数	含义
--size WIDTHxHEIGHT	视频的尺寸，比如 1280x720，默认是屏幕分辨率。
--bit-rate RATE	视频的比特率，默认是 4Mbps。
--time-limit TIME	录制时长，单位秒。
--verbose	输出更多信息。

重新挂载 system 分区为可写

// TODO

其它常用 adb shell 命令

Android 系统是基于 Linux 内核的，所以 Linux 里的很多命令在 Android 里也有相同或类似的实现，在 adb shell 里可以调用。本文档前面的部分内容已经用到了 adb shell 命令。如下是常用命令的简单描述，前文已经专门讲过的命令不再列举：

命令	功能
cat	显示文件内容
cd	切换目录
chmod	改变文件的存取模式/访问权限
grep	过滤输出
ls	列举目录内容
mount	挂载目录的查看和管理
ps	查看正在运行的进程
top	查看进程的资源占用情况

参考链接

• Android Debug Bridge
• ADB Shell Commands
• logcat Command-line Tool