ADB 命令详解

ADB，即 Android Debug Bridge，它是 Android 开发/测验人员不行代替的强壮东西，也是 Android 设备玩家的好玩具。

注： 文中有部分指令的支撑状况或许与 Android 体系版别及定制 ROM 的完结有关。

根本用法

指令语法

adb 指令的根本语法如下：

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

假如只要一个设备/模拟器衔接时，能够省掉掉 [-d|-e|-s <serialNumber>] 这一部分，直接运用 adb <command>。

为指令指定目标设备

假如有多个设备/模拟器衔接，则需求为指令指定目标设备。

参数	意义
-d	指定当时唯一经过 USB 衔接的 Android 设备为指令目标
-e	指定当时唯一运转的模拟器为指令目标
-s <serialNumber>	指定相应 serialNumber 号的设备/模拟器为指令目标

在多个设备/模拟器衔接的状况下较常用的是 -s <serialNumber> 参数，serialNumber 能够经过 adb devices 指令获取。如：

$ adb devices
List of devices attached
cf264b8f	device
emulator-5554	device
10.129.164.6:5555	device

输出里的 cf264b8f、emulator-5554 和 10.129.164.6:5555 即为 serialNumber。

比方这时想指定 cf264b8f 这个设备来运转 adb 指令获取屏幕分辨率：

adb -s cf264b8f shell wm size

又如想给 10.129.164.6:5555 这个设备装置运用（这种办法的 serialNumber 格局为 <IP>:<Port>，一般为无线衔接的设备或 Genymotion 等第三方 Android 模拟器）：

adb -s 10.129.164.6:5555 install test.apk

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

发动/中止

发动 adb server 指令：

adb start-server

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

中止 adb server 指令：

adb kill-server

检查 adb 版别

指令：

adb version

示例输出：

Android Debug Bridge version 1.0.36
Revision 8f855a3d9b35-android

以 root 权限运转 adbd

adb 的运转原理是 PC 端的 adb server 与手机端的守护进程 adbd 树立衔接，然后 PC 端的 adb client 经过 adb server 转发指令，adbd 接纳指令后解析运转。

所以假如 adbd 以一般权限履行，有些需求 root 权限才干履行的指令无法直接用 adb xxx 履行。这时能够 adb shell 然后 su 后履行指令，也能够让 adbd 以 root 权限履行，这个就能随意履行高权限指令了。

指令：

adb root

正常输出：

restarting adbd as root

现在再运转 adb shell，看看指令行提示符是不是变成 # 了？

有些手机 root 后也无法经过 adb root 指令让 adbd 以 root 权限履行，比方三星的部分机型，会提示 adbd cannot run as root in production builds，此时能够先装置 adbd Insecure，然后 adb root 试试。

相应地，假如要康复 adbd 为非 root 权限的话，能够运用 adb unroot 指令。

指定 adb server 的网络端口

指令：

adb -P <port> start-server

默许端口为 5037。

设备衔接办理

查询已衔接设备/模拟器

指令：

adb devices

输出示例：

List of devices attached
cf264b8f	device
emulator-5554	device
10.129.164.6:5555	device

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

• offline —— 标明设备未衔接成功或无呼应。

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

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

以上输出显现当时现已衔接了三台设备/模拟器，cf264b8f、emulator-5554 和 10.129.164.6:5555 分别是它们的 SN。从 emulator-5554 这个姓名能够看出它是一个 Android 模拟器，而 10.129.164.6:5555 这种形为 <IP>:<Port> 的 serialNumber 一般是无线衔接的设备或 Genymotion 等第三方 Android 模拟器。

常见异常输出：

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

   List of devices attached
   

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

   List of devices attached
   cf264b8f	offline
   

USB 衔接

经过 USB 衔接来正常运用 adb 需求保证几点：

1. 硬件状况正常。

   包括 Android 设备处于正常开机状况，USB 衔接线和各种接口无缺。

2. Android 设备的开发者选项和 USB 调试形式已敞开。

   能够到「设置」-「开发者选项」-「Android 调试」检查。

   假如在设置里找不到开发者选项，那需求经过一个彩蛋来让它显现出来：在「设置」-「关于手机」接连点击「版别号」7 次。

3. 设备驱动状况正常。

   这一点形似在 Linux 和 Mac OS X 下不必操心，在 Windows 下有或许遇到需求装置驱动的状况，承认这一点能够右键「计算机」-「特点」，到「设备办理器」里检查相关设备上是否有黄色感叹号或问号，假如没有就阐明驱动状况现已好了。不然能够下载一个手机帮手类程序来装置驱动先。

4. 经过 USB 线衔接好电脑和设备后承认状况。

   adb devices
   

   假如能看到

   xxxxxx device
   

   阐明衔接成功。

无线衔接（Android11 及以上）

Android 11 及更高版别支撑运用 Android 调试桥 (adb) 从工作站以无线办法布置和调试运用。例如，您能够将可调试运用布置到多台长途设备，而无需经过 USB 实际衔接设备。这样就能够避免常见的 USB 衔接问题，例如驱动程序装置方面的问题。

官方文档

操作过程：

1. 更新到最新版别的 SDK 渠道东西(至少30.0.0)。

2. 将 Android 设备与要运转 adb 的电脑衔接到同一个局域网，比方连到同一个 WiFi。

3. 在开发者选项中启用无线调试。

4. 在问询要答应在此网络上进行无线调试吗？的对话框中，点击答应。

5. 挑选运用配对码配对设备，运用弹窗中的 IP 地址和端口号。

adb pair ipaddr:port

6. 提示Enter pairing code: 时输入弹窗中的配对码，成功后会显现Successfully paired to ...。

7. 运用无线调试下的 IP 地址和端口。

adb connect ipaddr:port

8. 承认衔接状况。

   adb devices
   

   假如能看到

   ipaddr:port device
   

阐明衔接成功。

无线衔接（需求凭借 USB 线）

除了能够经过 USB 衔接设备与电脑来运用 adb，也能够经过无线衔接——虽然衔接过程中也有需求运用 USB 的过程，可是衔接成功之后你的设备就能够在必定范围内摆脱 USB 衔接线的限制啦！

操作过程：

1. 将 Android 设备与要运转 adb 的电脑衔接到同一个局域网，比方连到同一个 WiFi。

2. 将设备与电脑经过 USB 线衔接。

   应保证衔接成功（可运转 adb devices 看是否能列出该设备）。

3. 让设备在 5555 端口监听 TCP/IP 衔接：

   adb tcpip 5555
   

4. 断开 USB 衔接。

5. 找到设备的 IP 地址。

   一般能在「设置」-「关于手机」-「状况信息」-「IP地址」找到，也能够运用下文里 [检查设备信息 – IP 地址][1] 一节里的办法用 adb 指令来检查。

6. 经过 IP 地址衔接设备。

   adb connect <device-ip-address>
   

   这儿的 <device-ip-address> 便是上一步中找到的设备 IP 地址。

7. 承认衔接状况。

   adb devices
   

   假如能看到

   <device-ip-address>:5555 device
   

   阐明衔接成功。

假如衔接不了，请承认 Android 设备与电脑是衔接到了同一个 WiFi，然后再次履行 adb connect <device-ip-address> 那一步；

假如仍是不行的话，经过 adb kill-server 从头发动 adb 然后从头再来一次试试。

断开无线衔接

指令：

adb disconnect <device-ip-address>

无线衔接（无需凭借 USB 线）

注：需求 root 权限。

上一节「无线衔接（需求凭借 USB 线）」是官方文档里介绍的办法，需求凭借于 USB 数据线来完结无线衔接。

已然咱们想要完结无线衔接，那能不能全部过程下来都是无线的呢？答案是能的。

1. 在 Android 设备上装置一个终端模拟器。

   现已装置过的设备能够跳过此步。我运用的终端模拟器下载地址是：Terminal Emulator for Android Downloads

2. 将 Android 设备与要运转 adb 的电脑衔接到同一个局域网，比方连到同一个 WiFi。

3. 翻开 Android 设备上的终端模拟器，在里边依次运转指令：

   su
   setprop service.adb.tcp.port 5555
   

4. 找到 Android 设备的 IP 地址。

   一般能在「设置」-「关于手机」-「状况信息」-「IP地址」找到，也能够运用下文里 [检查设备信息 – IP 地址][1] 一节里的办法用 adb 指令来检查。

5. 在电脑上经过 adb 和 IP 地址衔接 Android 设备。

   adb connect <device-ip-address>
   

   这儿的 <device-ip-address> 便是上一步中找到的设备 IP 地址。

   假如能看到 connected to <device-ip-address>:5555 这样的输出则标明衔接成功。

节注一：

有的设备，比方小米 5S + MIUI 8.0 + Android 6.0.1 MXB48T，或许在第 5 步之前需求重启 adbd 服务，在设备的终端模拟器上运转：

restart adbd

假如 restart 无效，测验以下指令：

stop adbd
start adbd

运用办理

检查运用列表

检查运用列表的根本指令格局是

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 [-lrtsdg] <path_to_apk>

参数：

adb install 后边能够跟一些可选参数来操控装置 APK 的行为，可用参数及意义如下：

参数	意义
-l	将运用装置到保护目录 /mnt/asec
-r	答应覆盖装置
-t	答应装置 AndroidManifest.xml 里 application 指定 android:testOnly="true" 的运用
-s	将运用装置到 sdcard
-d	答应降级覆盖装置
-g	颁发全部运转时权限
–abi abi-identifier	为特定 ABI 强制装置 apk，abi-identifier 能够是 armeabi-v7a、arm64-v8a、v86、x86_64 等

运转指令后假如见到类似如下输出（状况为 Success）代表装置成功：

[100%] /data/local/tmp/1.apk
	pkg: /data/local/tmp/1.apk
Success

上面是当时最新版 v1.0.36 的 adb 的输出，会显现 push apk 文件到手机的进度百分比。

运用旧版别 adb 的输出则是这样的：

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

而假如状况为 Failure 则标明装置失利，比方：

[100%] /data/local/tmp/map-20160831.apk
        pkg: /data/local/tmp/map-20160831.apk
Failure [INSTALL_FAILED_ALREADY_EXISTS]

常见装置失利输出代码、意义及或许的解决办法如下：

输出	意义	解决办法
INSTALL_FAILED_ALREADY_EXISTS	运用现已存在，或卸载了但没卸载干净	adb install 时运用 -r 参数，或许先 adb uninstall <packagename> 再装置
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	曾经装置过同名运用，但卸载时数据没有移除；或许已装置该运用，但签名不共同	先 adb uninstall <packagename> 再装置
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	1. sdcard 拜访失利; 2. 运用签名与 ROM 签名共同，被当作内置运用。	1. 承认 sdcard 可用，或许装置到内置存储; 2. 打包时不与 ROM 运用相同签名。
INSTALL_FAILED_INVALID_INSTALL_LOCATION	1. 不能装置到指定位置; 2. 运用签名与 ROM 签名共同，被当作内置运用。	1. 切换装置位置，增加或删去 -s 参数; 2. 打包时不与 ROM 运用相同签名。
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	用户被限制装置运用	在开发者选项里将「USB装置」翻开，假如现已翻开了，那先封闭再翻开。
INSTALL_FAILED_DUPLICATE_PERMISSION	运用测验界说一个现已存在的权限称号
INSTALL_FAILED_NO_MATCHING_ABIS	运用包括设备的运用程序二进制接口不支撑的 native code
INSTALL_CANCELED_BY_USER	运用装置需求在设备上承认，但未操作设备或点了取消	在设备上赞同装置
INSTALL_FAILED_ACWF_INCOMPATIBLE	运用程序与设备不兼容
INSTALL_FAILED_TEST_ONLY	APK 文件是运用 Android Studio 直接 RUN 编译出来的文件	经过 Gradle 的 assembleDebug 或 assembleRelease 从头编译，或许 Generate Signed APK
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 device	空间缺乏	整理空间
Permission denied … sdcard …	sdcard 不行用
signatures do not match the previously installed version; ignoring!	已装置该运用且签名不共同	先卸载设备上的该运用，再装置

参阅：PackageManager.java

adb install 内部原理简介

adb install 实际是分三步完结：

1. push apk 文件到 /data/local/tmp。

2. 调用 pm install 装置。

3. 删去 /data/local/tmp 下的对应 apk 文件。

所以，必要的时分也能够依据这个过程，手动分步履行装置过程。

卸载运用

指令：

adb uninstall [-k] <packagename>

<packagename> 标明运用的包名，-k 参数可选，标明卸载运用但保存数据和缓存目录。

指令示例：

adb uninstall com.qihoo360.mobilesafe

标明卸载 360 手机卫士。

铲除运用数据与缓存

指令：

adb shell pm clear <packagename>

<packagename> 标明运用名包，这条指令的作用相当于在设置里的运用信息界面点击了「铲除缓存」和「铲除数据」。

指令示例：

adb shell pm clear com.qihoo360.mobilesafe

标明铲除 360 手机卫士的数据和缓存。

检查前台 Activity

指令：

adb shell dumpsys activity activities | grep mResumedActivity

输出示例：

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

其间的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher 便是当时处于前台的 Activity。

在 Windows 下以上指令或许不行用，能够测验 adb shell dumpsys activity activities | findstr mResumedActivity 或 adb shell "dumpsys activity activities | grep mResumedActivity"。

检查正在运转的 Services

指令：

adb shell dumpsys activity services [<packagename>]

<packagename> 参数不是有必要的，指定 <packagename> 标明检查与某个包名相关的 Services，不指定标明检查全部 Services。

<packagename> 不必定要给出完好的包名，比方运转 adb shell dumpsys activity services org.mazhuang，那么包名 org.mazhuang.demo1、org.mazhuang.demo2 和 org.mazhuang123 等相关的 Services 都会列出来。

检查运用具体信息

指令：

adb shell dumpsys package <packagename>

输出中包括许多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、装置后的文件资源代码等途径、版别信息、权限信息和颁发状况、签名版别信息等。

<packagename> 标明运用包名。

输出示例：

Activity Resolver Table:
  Non-Data Actions:
      android.intent.action.MAIN:
        5b4cba8 org.mazhuang.guanggoo/.SplashActivity filter 5ec9dcc
          Action: "android.intent.action.MAIN"
          Category: "android.intent.category.LAUNCHER"
          AutoVerify=false
Registered ContentProviders:
  org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider:
    Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}
ContentProvider Authorities:
  [org.mazhuang.guanggoo.fileProvider]:
    Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}
      applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}
Key Set Manager:
  [org.mazhuang.guanggoo]
      Signing KeySets: 501
Packages:
  Package [org.mazhuang.guanggoo] (c1d7f):
    userId=10394
    pkg=Package{55f714c org.mazhuang.guanggoo}
    codePath=/data/app/org.mazhuang.guanggoo-2
    resourcePath=/data/app/org.mazhuang.guanggoo-2
    legacyNativeLibraryDir=/data/app/org.mazhuang.guanggoo-2/lib
    primaryCpuAbi=null
    secondaryCpuAbi=null
    versionCode=74 minSdk=15 targetSdk=25
    versionName=1.1.74
    splits=[base]
    apkSigningVersion=2
    applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}
    flags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP ]
    privateFlags=[ RESIZEABLE_ACTIVITIES ]
    dataDir=/data/user/0/org.mazhuang.guanggoo
    supportsScreens=[small, medium, large, xlarge, resizeable, anyDensity]
    timeStamp=2017-10-22 23:50:53
    firstInstallTime=2017-10-22 23:50:25
    lastUpdateTime=2017-10-22 23:50:55
    installerPackageName=com.miui.packageinstaller
    signatures=PackageSignatures{af09595 [53c7caa2]}
    installPermissionsFixed=true installStatus=1
    pkgFlags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP ]
    requested permissions:
      android.permission.READ_PHONE_STATE
      android.permission.INTERNET
      android.permission.ACCESS_NETWORK_STATE
      android.permission.ACCESS_WIFI_STATE
      android.permission.READ_LOGS
      android.permission.WRITE_EXTERNAL_STORAGE
      android.permission.READ_EXTERNAL_STORAGE
    install permissions:
      android.permission.INTERNET: granted=true
      android.permission.ACCESS_NETWORK_STATE: granted=true
      android.permission.ACCESS_WIFI_STATE: granted=true
    User 0: ceDataInode=1155675 installed=true hidden=false suspended=false stopped=true notLaunched=false enabled=0
      gids=[3003]
      runtime permissions:
        android.permission.READ_EXTERNAL_STORAGE: granted=true
        android.permission.READ_PHONE_STATE: granted=true
        android.permission.WRITE_EXTERNAL_STORAGE: granted=true
    User 999: ceDataInode=0 installed=false hidden=false suspended=false stopped=true notLaunched=true enabled=0
      gids=[3003]
      runtime permissions:
Dexopt state:
  [org.mazhuang.guanggoo]
    Instruction Set: arm64
      path: /data/app/org.mazhuang.guanggoo-2/base.apk
      status: /data/app/org.mazhuang.guanggoo-2/oat/arm64/base.odex [compilation_filter=speed-profile, status=kOatUpToDa
      te]

检查运用装置途径

指令:

adb shell pm path <PACKAGE>

输出运用装置途径

输出示例:

adb shell pm path ecarx.weather
package:/data/app/ecarx.weather-1.apk

与运用交互

主要是运用 am <command> 指令，常用的 <command> 如下：

command	用处
start [options] <INTENT>	发动 <INTENT> 指定的 Activity
startservice [options] <INTENT>	发动 <INTENT> 指定的 Service
broadcast [options] <INTENT>	发送 <INTENT> 指定的播送
force-stop <packagename>	中止 <packagename> 相关的进程

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

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

参数	意义
-a <ACTION>	指定 action，比方 android.intent.action.VIEW
-c <CATEGORY>	指定 category，比方 android.intent.category.APP_CONTACTS
-n <COMPONENT>	指定完好 component 名，用于明确指定发动哪个 Activity，如 com.example.app/.ExampleActivity

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

参数	意义
--esn <EXTRA_KEY>	null 值（只要 key 名）
`-e	–es <EXTRA_KEY> <EXTRA_STRING_VALUE>`	string 值
--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE>	boolean 值
--ei <EXTRA_KEY> <EXTRA_INT_VALUE>	integer 值
--el <EXTRA_KEY> <EXTRA_LONG_VALUE>	long 值
--ef <EXTRA_KEY> <EXTRA_FLOAT_VALUE>	float 值
--eu <EXTRA_KEY> <EXTRA_URI_VALUE>	URI
--ecn <EXTRA_KEY> <EXTRA_COMPONENT_NAME_VALUE>	component name
--eia <EXTRA_KEY> <EXTRA_INT_VALUE>[,<EXTRA_INT_VALUE...]	integer 数组
--ela <EXTRA_KEY> <EXTRA_LONG_VALUE>[,<EXTRA_LONG_VALUE...]	long 数组

发动运用/ 调起 Activity

指定Activity称号发动

指令格局：

adb shell am start [options] <INTENT>

例如：

adb shell am start -n com.tencent.mm/.ui.LauncherUI

标明调起微信主界面。

adb shell am start -n org.mazhuang.boottimemeasure/.MainActivity --es "toast" "hello, world"

标明调起 org.mazhuang.boottimemeasure/.MainActivity 并传给它 string 数据键值对 toast - hello, world。

不指定Activity称号发动（发动主Activity）

指令格局：

adb shell monkey -p <packagename> -c android.intent.category.LAUNCHER 1

例如：

adb shell monkey -p com.tencent.mm -c android.intent.category.LAUNCHER 1

标明调起微信主界面。

调起 Service

指令格局：

adb shell am startservice [options] <INTENT>

例如：

adb shell am startservice -n com.tencent.mm/.plugin.accountsync.model.AccountAuthenticatorService

标明调起微信的某 Service。

别的一个典型的用例是假如设备上原本应该显现虚拟按键可是没有显现，能够试试这个：

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

中止 Service

指令格局：

adb shell am stopservice [options] <INTENT>

发送播送

指令格局：

adb shell am broadcast [options] <INTENT>

能够向全部组件播送，也能够只向指定组件播送。

例如，向全部组件播送 BOOT_COMPLETED：

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

又例如，只向 org.mazhuang.boottimemeasure/.BootCompletedReceiver 播送 BOOT_COMPLETED：

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED -n org.mazhuang.boottimemeasure/.BootCompletedReceiver

这类用法在测验的时分很有用，比方某个播送的场景很难制作，能够考虑经过这种办法来发送播送。

既能发送体系预界说的播送，也能发送自界说播送。如下是部分体系预界说播送及正常触发机遇：

action	触发机遇
android.net.conn.CONNECTIVITY_CHANGE	网络衔接发生改变
android.intent.action.SCREEN_ON	屏幕点亮
android.intent.action.SCREEN_OFF	屏幕平息
android.intent.action.BATTERY_LOW	电量低，会弹出电量低提示框
android.intent.action.BATTERY_OKAY	电量康复了
android.intent.action.BOOT_COMPLETED	设备发动完毕
android.intent.action.DEVICE_STORAGE_LOW	存储空间过低
android.intent.action.DEVICE_STORAGE_OK	存储空间康复
android.intent.action.PACKAGE_ADDED	装置了新的运用
android.net.wifi.STATE_CHANGE	WiFi 衔接状况发生改变
android.net.wifi.WIFI_STATE_CHANGED	WiFi 状况变为启用/封闭/正在发动/正在封闭/不知道
android.intent.action.BATTERY_CHANGED	电池电量发生改变
android.intent.action.INPUT_METHOD_CHANGED	体系输入法发生改变
android.intent.action.ACTION_POWER_CONNECTED	外部电源衔接
android.intent.action.ACTION_POWER_DISCONNECTED	外部电源断开衔接
android.intent.action.DREAMING_STARTED	体系开端休眠
android.intent.action.DREAMING_STOPPED	体系中止休眠
android.intent.action.WALLPAPER_CHANGED	壁纸发生改变
android.intent.action.HEADSET_PLUG	插入耳机
android.intent.action.MEDIA_UNMOUNTED	卸载外部介质
android.intent.action.MEDIA_MOUNTED	挂载外部介质
android.os.action.POWER_SAVE_MODE_CHANGED	省电形式敞开

（以上播送均可运用 adb 触发）

强制中止运用

指令：

adb shell am force-stop <packagename>

指令示例：

adb shell am force-stop com.qihoo360.mobilesafe

标明中止 360 安全卫士的全部进程与服务。

收紧内存

指令：

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

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

指令示例：

adb shell am send-trim-memory 12345 RUNNING_LOW

标明向 pid=12345 的进程，发出 level=RUNNING_LOW 的收紧内存指令。

文件办理

复制设备里的文件到电脑

指令：

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。

模拟按键/输入

在 adb shell 里有个很有用的指令叫 input，经过它能够做一些有趣的工作。

input 指令的完好 help 信息如下：

Usage: input [<source>] <command> [<arg>...]
The sources are:
      mouse
      keyboard
      joystick
      touchnavigation
      touchpad
      trackball
      stylus
      dpad
      gesture
      touchscreen
      gamepad
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)
      press (Default: trackball)
      roll <dx> <dy> (Default: trackball)

比方运用 adb shell input keyevent <keycode> 指令，不同的 keycode 能完结不同的功用，完好的 keycode 列表详见 KeyEvent，摘引部分我觉得有意思的如下：

keycode	意义
3	HOME 键
4	回来键
5	翻开拨号运用
6	挂断电话
24	增加音量
25	下降音量
26	电源键
27	摄影（需求在相机运用里）
64	翻开浏览器
82	菜单键
85	播映/暂停
86	中止播映
87	播映下一首
88	播映上一首
122	移动光标到行首或列表顶部
123	移动光标到行末或列表底部
126	康复播映
127	暂停播映
164	静音
176	翻开体系设置
187	切换运用
207	翻开联系人
208	翻开日历
209	翻开音乐
210	翻开计算器
220	下降屏幕亮度
221	提高屏幕亮度
223	体系休眠
224	点亮屏幕
231	翻开语音帮手
276	假如没有 wakelock 则让体系休眠

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

电源键

指令：

adb shell input keyevent 26

履行作用相当于按电源键。

菜单键

指令：

adb shell input keyevent 82

HOME 键

指令：

adb shell input keyevent 3

回来键

指令：

adb shell input keyevent 4

音量操控

增加音量：

adb shell input keyevent 24

下降音量：

adb shell input keyevent 25

静音：

adb shell input keyevent 164

媒体操控

播映/暂停：

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 来解锁。

指令（参数以机型 Nexus 5，向上滑动手势解锁举例）：

adb shell input swipe 300 1000 300 500

参数 300 1000 300 500 分别标明起始点x坐标 起始点y坐标 完毕点x坐标 完毕点y坐标。

输入文本

在焦点处于某文本框时，能够经过 input 指令来输入文本。

指令：

adb shell input text hello

现在 hello 出现在文本框了。

检查日志

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

Android 日志

指令格局：

[adb] logcat [<option>] ... [<filter-spec>] ...

常用用法罗列如下：

按等级过滤日志

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

• V —— Verbose（最低，输出得最多）
• D —— Debug
• I —— Info
• W —— Warning
• E —— Error
• F —— Fatal
• S —— Silent（最高，啥也不输出）

按某等级过滤日志则会将该等级及以上的日志输出。

比方，指令：

adb logcat *:W

会将 Warning、Error、Fatal 和 Silent 日志输出。

（注： 在 macOS 下需求给 *:W 这样以 * 作为 tag 的参数加双引号，如 adb logcat "*:W"，不然会报错 no matches found: *:W。）

按 tag 和等级过滤日志

<filter-spec> 能够由多个 <tag>[:priority] 组成。

比方，指令：

adb logcat ActivityManager:I MyApp:D *:S

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

日志格局

能够用 adb logcat -v <format> 选项指定日志输出格局。

日志支撑按以下几种 <format>：

• brief

  默许格局。格局为：

  <priority>/<tag>(<pid>): <message>
  

  示例：

  D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0
  

• process

  格局为：

  <priority>(<pid>) <message>
  

  示例：

  D( 1785) Disconnected process message: 10, size: 0  (HeadsetStateMachine)
  

• tag

  格局为：

  <priority>/<tag>: <message>
  

  示例：

  D/HeadsetStateMachine: Disconnected process message: 10, size: 0
  

• raw

  格局为：

  <message>
  

  示例：

  Disconnected process message: 10, size: 0
  

• time

  格局为：

  <datetime> <priority>/<tag>(<pid>): <message>
  

  示例：

  08-28 22:39:39.974 D/HeadsetStateMachine( 1785): Disconnected process message: 10, size: 0
  

• threadtime

  格局为：

  <datetime> <pid> <tid> <priority> <tag>: <message>
  

  示例：

  08-28 22:39:39.974  1785  1832 D HeadsetStateMachine: Disconnected process message: 10, size: 0
  

• long

  格局为：

  [ <datetime> <pid>:<tid> <priority>/<tag> ]
  <message>
  

  示例：

  [ 08-28 22:39:39.974  1785: 1832 D/HeadsetStateMachine ]
  Disconnected process message: 10, size: 0
  

指定格局可与上面的过滤一起运用。比方：

adb logcat -v long ActivityManager:I *:S

清空日志

adb logcat -c

内核日志

指令：

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 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。

假如运用指令修正正，那输出或许是：

Physical size: 1080x1920
Override size: 480x1024

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

屏幕密度

指令：

adb shell wm density

输出示例：

Physical density: 420

该设备屏幕密度为 420dpi。

假如运用指令修正正，那输出或许是：

Physical density: 480
Override density: 160

标明设备的屏幕密度原来是 480dpi，当时被修正为 160dpi。

显现屏参数

指令：

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。

android_id

指令：

adb shell settings get secure android_id

输出示例：

51b6be48bac8c569

IMEI

在 Android 4.4 及以下版别可经过如下指令获取 IMEI：

adbshelldumpsysiphonesubinfo

输出示例：

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

IP 地址

每次想知道设备的 IP 地址的时分都得「设置」-「关于手机」-「状况信息」-「IP地址」很烦对不对？经过 adb 能够方便地检查。

指令：

adb shell ifconfig | grep Mask

输出示例：

inet addr:10.130.245.230  Mask:255.255.255.252
inet addr:127.0.0.1  Mask:255.0.0.0

那么 10.130.245.230 便是设备 IP 地址。

在有的设备上这个指令没有输出，假如设备连着 WiFi，能够运用如下指令来检查局域网 IP：

adb shell ifconfig wlan0

输出示例：

wlan0: ip 10.129.160.99 mask 255.255.240.0 flags [up broadcast running multicast]

或

wlan0     Link encap:UNSPEC
          inet addr:10.129.168.57  Bcast:10.129.175.255  Mask:255.255.240.0
          inet6 addr: fe80::66cc:2eff:fe68:b6b6/64 Scope: Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:496520 errors:0 dropped:0 overruns:0 frame:0
          TX packets:68215 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:3000
          RX bytes:116266821 TX bytes:8311736

假如以上指令仍然不能得到希望的信息，那能够试试以下指令（部分体系版别里可用）：

adb shell netcfg

输出示例：

wlan0    UP                               10.129.160.99/20  0x00001043 f8:a9:d0:17:42:4d
lo       UP                                   127.0.0.1/8   0x00000049 00:00:00:00:00:00
p2p0     UP                                     0.0.0.0/0   0x00001003 fa:a9:d0:17:42:4d
sit0     DOWN                                   0.0.0.0/0   0x00000080 00:00:00:00:00:00
rmnet0   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet1   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet3   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet2   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet4   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet6   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet5   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rmnet7   DOWN                                   0.0.0.0/0   0x00000000 00:00:00:00:00:00
rev_rmnet3 DOWN                                   0.0.0.0/0   0x00001002 4e:b7:e4:2e:17:58
rev_rmnet2 DOWN                                   0.0.0.0/0   0x00001002 4e:f0:c8:bf:7a:cf
rev_rmnet4 DOWN                                   0.0.0.0/0   0x00001002 a6:c0:3b:6b:c4:1f
rev_rmnet6 DOWN                                   0.0.0.0/0   0x00001002 66:bb:5d:64:2e:e9
rev_rmnet5 DOWN                                   0.0.0.0/0   0x00001002 0e:1b:eb:b9:23:a0
rev_rmnet7 DOWN                                   0.0.0.0/0   0x00001002 7a:d9:f6:81:40:5a
rev_rmnet8 DOWN                                   0.0.0.0/0   0x00001002 4e:e2:a9:bb:d0:1b
rev_rmnet0 DOWN                                   0.0.0.0/0   0x00001002 fe:65:d0:ca:82:a9
rev_rmnet1 DOWN                                   0.0.0.0/0   0x00001002 da:d8:e8:4f:2e:fe

能够看到网络衔接称号、启用状况、IP 地址和 Mac 地址等信息。

Mac 地址

指令：

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

输出示例：

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

这检查的是局域网 Mac 地址，移动网络或其它衔接的信息能够经过前面的小节「IP 地址」里提到的 adb shell netcfg 指令来检查。

CPU 信息

指令：

adb shell cat /proc/cpuinfo

输出示例：

Processor       : ARMv7 Processor rev 0 (v7l)
processor       : 0
BogoMIPS        : 38.40
processor       : 1
BogoMIPS        : 38.40
processor       : 2
BogoMIPS        : 38.40
processor       : 3
BogoMIPS        : 38.40
Features        : swp half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt
CPU implementer : 0x51
CPU architecture: 7
CPU variant     : 0x2
CPU part        : 0x06f
CPU revision    : 0
Hardware        : Qualcomm MSM 8974 HAMMERHEAD (Flattened Device Tree)
Revision        : 000b
Serial          : 0000000000000000

这是 Nexus 5 的 CPU 信息，咱们从输出里能够看到运用的硬件是 Qualcomm MSM 8974，processor 的编号是 0 到 3，所以它是四核的，采用的架构是 ARMv7 Processor rev 0 (v71)。

内存信息

指令：

adb shell cat /proc/meminfo

输出示例：

MemTotal:        1027424 kB
MemFree:          486564 kB
Buffers:           15224 kB
Cached:            72464 kB
SwapCached:        24152 kB
Active:           110572 kB
Inactive:         259060 kB
Active(anon):      79176 kB
Inactive(anon):   207736 kB
Active(file):      31396 kB
Inactive(file):    51324 kB
Unevictable:        3948 kB
Mlocked:               0 kB
HighTotal:        409600 kB
HighFree:         132612 kB
LowTotal:         617824 kB
LowFree:          353952 kB
SwapTotal:        262140 kB
SwapFree:         207572 kB
Dirty:                 0 kB
Writeback:             0 kB
AnonPages:        265324 kB
Mapped:            47072 kB
Shmem:              1020 kB
Slab:              57372 kB
SReclaimable:       7692 kB
SUnreclaim:        49680 kB
KernelStack:        4512 kB
PageTables:         5912 kB
NFS_Unstable:          0 kB
Bounce:                0 kB
WritebackTmp:          0 kB
CommitLimit:      775852 kB
Committed_AS:   13520632 kB
VmallocTotal:     385024 kB
VmallocUsed:       61004 kB
VmallocChunk:     209668 kB

其间，MemTotal 便是设备的总内存，MemFree 是当时闲暇内存。

更多硬件与体系特点

设备的更多硬件与体系特点能够经过如下指令检查：

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	屏幕密度

节注一：

一些小厂定制的 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

标明将分辨率修正为 480px * 1024px。

康康复分辨率指令：

adb shell wm size reset

屏幕密度

指令：

adb shell wm density 160

标明将屏幕密度修正为 160dpi。

康康复屏幕密度指令：

adb shell wm density reset

显现区域

指令：

adb shell wm overscan 0,0,0,200

四个数字分别标明间隔左、上、右、下边缘的留白像素，以上指令标明将屏幕底部 200px 留白。

康康复显现区域指令：

adb shell wm overscan reset

封闭 USB 调试形式

指令：

adb shell settings put global adb_enabled 0

康复：

用指令康复不了了，究竟封闭了 USB 调试 adb 就衔接不上 Android 设备了。

去设备上手动康复吧：「设置」-「开发者选项」-「Android 调试」。

答应/制止拜访非 SDK API

答应拜访非 SDK API：

adb shell settings put global hidden_api_policy_pre_p_apps 1
adb shell settings put global hidden_api_policy_p_apps 1

制止拜访非 SDK API：

adb shell settings delete global hidden_api_policy_pre_p_apps
adb shell settings delete global hidden_api_policy_p_apps

不需求设备获得 Root 权限。

指令最后的数字的意义：

值	意义
0	制止检测非 SDK 接口的调用。该状况下，日志记录功用被禁用，并且令 strict mode API，即 detectNonSdkApiUsage() 无效。不推荐。
1	仅正告——答应拜访全部非 SDK 接口，但保存日志中的正告信息，可持续运用 strick mode API。
2	制止调用深灰名单和黑名单中的接口。
3	制止调用黑名单中的接口，但答应调用深灰名单中的接口。

状况栏和导航栏的显现躲藏

本节所说的相关设置对应 Cyanogenmod 里的「扩展桌面」。

指令：

adb shell settings put global policy_control <key-values>

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

key	意义
immersive.full	一起躲藏
immersive.status	躲藏状况栏
immersive.navigation	躲藏导航栏
immersive.preconfirms	?

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

value	意义
apps	全部运用
*	全部界面
packagename	指定运用
-packagename	排除指定运用

例如：

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

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

adb pull /sdcard/sc.png

能够运用 adb shell screencap -h 检查 screencap 指令的协助信息，下面是两个有意义的参数及意义：

参数	意义
-p	指定保存文件为 png 格局
-d display-id	指定截图的显现屏编号（有多显现屏的状况下）

实测假如指定文件名以 .png 完毕时能够省掉 -p 参数；不然需求运用 -p 参数。假如不指定文件名，截图文件的内容将直接输出到 stdout。

别的一种一行指令截图并保存到电脑的办法：

Linux 和 Windows

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

Mac OS X

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

这个办法需求用到 gnu sed 指令，在 Linux 下直接就有，在 Windows 下 Git 装置目录的 bin 文件夹下也有。假如确实找不到该指令，能够下载 sed for Windows 并将 sed.exe 所在文件夹增加到 PATH 环境变量里。

而在 Mac 下运用体系自带的 sed 指令会报错：

sed: RE error: illegal byte sequence

需求装置 gnu-sed，然后运用 gsed 指令：

brew install gnu-sed

录制屏幕

录制屏幕以 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 分区为可写

注：需求 root 权限。

/system 分区默许挂载为只读，但有些操作比方给 Android 体系增加指令、删去自带运用等需求对 /system 进行写操作，所以需求从头挂载它为可读写。

过程：

1. 进入 shell 并切换到 root 用户权限。

   指令：

   adb shell
   su
   

2. 检查当时分区挂载状况。

   指令：

   mount
   

   输出示例：

   rootfs / rootfs ro,relatime 0 0
   tmpfs /dev tmpfs rw,seclabel,nosuid,relatime,mode=755 0 0
   devpts /dev/pts devpts rw,seclabel,relatime,mode=600 0 0
   proc /proc proc rw,relatime 0 0
   sysfs /sys sysfs rw,seclabel,relatime 0 0
   selinuxfs /sys/fs/selinux selinuxfs rw,relatime 0 0
   debugfs /sys/kernel/debug debugfs rw,relatime 0 0
   none /var tmpfs rw,seclabel,relatime,mode=770,gid=1000 0 0
   none /acct cgroup rw,relatime,cpuacct 0 0
   none /sys/fs/cgroup tmpfs rw,seclabel,relatime,mode=750,gid=1000 0 0
   none /sys/fs/cgroup/memory cgroup rw,relatime,memory 0 0
   tmpfs /mnt/asec tmpfs rw,seclabel,relatime,mode=755,gid=1000 0 0
   tmpfs /mnt/obb tmpfs rw,seclabel,relatime,mode=755,gid=1000 0 0
   none /dev/memcg cgroup rw,relatime,memory 0 0
   none /dev/cpuctl cgroup rw,relatime,cpu 0 0
   none /sys/fs/cgroup tmpfs rw,seclabel,relatime,mode=750,gid=1000 0 0
   none /sys/fs/cgroup/memory cgroup rw,relatime,memory 0 0
   none /sys/fs/cgroup/freezer cgroup rw,relatime,freezer 0 0
   /dev/block/platform/msm_sdcc.1/by-name/system /system ext4 ro,seclabel,relatime,data=ordered 0 0
   /dev/block/platform/msm_sdcc.1/by-name/userdata /data ext4 rw,seclabel,nosuid,nodev,relatime,noauto_da_alloc,data=ordered 0 0
   /dev/block/platform/msm_sdcc.1/by-name/cache /cache ext4 rw,seclabel,nosuid,nodev,relatime,data=ordered 0 0
   /dev/block/platform/msm_sdcc.1/by-name/persist /persist ext4 rw,seclabel,nosuid,nodev,relatime,data=ordered 0 0
   /dev/block/platform/msm_sdcc.1/by-name/modem /firmware vfat ro,context=u:object_r:firmware_file:s0,relatime,uid=1000,gid=1000,fmask=0337,dmask=0227,codepage=cp437,iocharset=iso8859-1,shortname=lower,errors=remount-ro 0 0
   /dev/fuse /mnt/shell/emulated fuse rw,nosuid,nodev,relatime,user_id=1023,group_id=1023,default_permissions,allow_other 0 0
   /dev/fuse /mnt/shell/emulated/0 fuse rw,nosuid,nodev,relatime,user_id=1023,group_id=1023,default_permissions,allow_other 0 0
   

   找到其间咱们重视的带 /system 的那一行：

   /dev/block/platform/msm_sdcc.1/by-name/system /system ext4 ro,seclabel,relatime,data=ordered 0 0
   

3. 从头挂载。

   指令：

   mount -o remount,rw -t yaffs2 /dev/block/platform/msm_sdcc.1/by-name/system /system
   

   这儿的 /dev/block/platform/msm_sdcc.1/by-name/system 便是咱们从上一步的输出里得到的文件途径。

假如输出没有提示过错的话，操作就成功了，能够对 /system 下的文件随心所欲了。

检查衔接过的 WiFi 暗码

注：需求 root 权限。

指令：

adb shell
su
cat /data/misc/wifi/*.conf

输出示例：

network={
	ssid="TP-LINK_9DFC"
	scan_ssid=1
	psk="123456789"
	key_mgmt=WPA-PSK
	group=CCMP TKIP
	auth_alg=OPEN
	sim_num=1
	priority=13893
}
network={
	ssid="TP-LINK_F11E"
	psk="987654321"
	key_mgmt=WPA-PSK
	sim_num=1
	priority=17293
}

ssid 即为咱们在 WLAN 设置里看到的称号，psk 为暗码，key_mgmt 为安全加密办法。

假如 Android O 或以后，WiFi 暗码保存的地址有改变，是在 WifiConfigStore.xml 里边

adb shell
su
cat /data/misc/wifi/WifiConfigStore.xml

输出格局：

数据项较多，只需重视 ConfigKey（WiFi 姓名）和 PreSharedKey（WiFi 暗码）即可

<string name="ConfigKey">&quot;Wi-Fi&quot;WPA_PSK</string>
<string name="PreSharedKey">&quot;931907334&quot;</string>

设置体系日期和时刻

注：需求 root 权限。

指令：

adb shell
su
date -s 20160823.131500

标明将体系日期和时刻更改为 2016 年 08 月 23 日 13 点 15 分 00 秒。

重启手机

指令：

adb reboot

检测设备是否已 root

指令：

adb shell
su

此时指令行提示符是 $ 则标明没有 root 权限，是 # 则标明已 root。

运用 Monkey 进行压力测验

Monkey 能够生成伪随机用户事情来模拟单击、触摸、手势等操作，能够对正在开发中的程序进行随机压力测验。

简略用法：

adb shell monkey -p <packagename> -v 500

标明向 <packagename> 指定的运用程序发送 500 个伪随机事情。

Monkey 的具体用法参阅 官方文档。

敞开/封闭 WiFi

注：需求 root 权限。

有时需求操控设备的 WiFi 状况，能够用以下指令完结。

敞开 WiFi：

adb root
adb shell svc wifi enable

封闭 WiFi：

adb root
adb shell svc wifi disable

若履行成功，输出为空；若未获得 root 权限履行此指令，将履行失利，输出 Killed。

刷机相关指令

重启到 Recovery 形式

指令：

adb reboot recovery

从 Recovery 重启到 Android

指令：

adb reboot

重启到 Fastboot 形式

指令：

adb reboot bootloader

经过 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>
   

安全相关指令

启用/禁用 SELinux

启用 SELinux

adb root
adb shell setenforce 1

禁用 SELinux

adb root
adb shell setenforce 0

启用/禁用 dm_verity

启用 dm_verity

adb root
adb enable-verity

禁用 dm_verity

adb root
adb disable-verity

更多 adb shell 指令

Android 体系是根据 Linux 内核的，所以 Linux 里的许多指令在 Android 里也有相同或类似的完结，在 adb shell 里能够调用。本文档前面的部分内容现已用到了 adb shell 指令。

检查进程

指令：

adb shell ps

输出示例：

USER     PID   PPID  VSIZE  RSS     WCHAN    PC        NAME
root      1     0     8904   788   ffffffff 00000000 S /init
root      2     0     0      0     ffffffff 00000000 S kthreadd
...
u0_a71    7779  5926  1538748 48896 ffffffff 00000000 S com.sohu.inputmethod.sogou:classic
u0_a58    7963  5926  1561916 59568 ffffffff 00000000 S org.mazhuang.boottimemeasure
...
shell     8750  217   10640  740   00000000 b6f28340 R ps

各列意义：

列名	意义
USER	所属用户
PID	进程 ID
PPID	父进程 ID
NAME	进程名

检查实时资源占用状况

指令：

adb shell top

输出示例：

User 0%, System 6%, IOW 0%, IRQ 0%
User 3 + Nice 0 + Sys 21 + Idle 280 + IOW 0 + IRQ 0 + SIRQ 3 = 307
  PID PR CPU% S  #THR     VSS     RSS PCY UID      Name
 8763  0   3% R     1  10640K   1064K  fg shell    top
  131  0   3% S     1      0K      0K  fg root     dhd_dpc
 6144  0   0% S   115 1682004K 115916K  fg system   system_server
  132  0   0% S     1      0K      0K  fg root     dhd_rxf
 1731  0   0% S     6  20288K    788K  fg root     /system/bin/mpdecision
  217  0   0% S     6  18008K    356K  fg shell    /sbin/adbd
 ...
 7779  2   0% S    19 1538748K  48896K  bg u0_a71   com.sohu.inputmethod.sogou:classic
 7963  0   0% S    18 1561916K  59568K  fg u0_a58   org.mazhuang.boottimemeasure
 ...

各列意义：

列名	意义
PID	进程 ID
PR	优先级
CPU%	当时瞬间占用 CPU 百分比
S	进程状况（R=运转，S=睡眠，T=盯梢/中止，Z=僵尸进程）
#THR	线程数
VSS	Virtual Set Size 虚拟耗用内存（包括同享库占用的内存）
RSS	Resident Set Size 实际运用物理内存（包括同享库占用的内存）
PCY	调度战略优先级，SP_BACKGROUND/SPFOREGROUND
UID	进程全部者的用户 ID
NAME	进程名

top 指令还支撑一些指令行参数，具体用法如下：

Usage: top [ -m max_procs ] [ -n iterations ] [ -d delay ] [ -s sort_column ] [ -t ] [ -h ]
    -m num  最多显现多少个进程
    -n num  改写多少次后退出
    -d num  改写时刻间隔（单位秒，默许值 5）
    -s col  按某列排序（可用 col 值：cpu, vss, rss, thr）
    -t      显现线程信息
    -h      显现协助文档

检查进程 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:/ $
   

其它

如下是其它常用指令的简略描绘，前文现已专门讲过的指令不再额外阐明：

指令	功用
cat	显现文件内容
cd	切换目录
chmod	改变文件的存取形式/拜访权限
df	检查磁盘空间运用状况
grep	过滤输出
kill	杀死指定 PID 的进程
ls	罗列目录内容
mount	挂载目录的检查和办理
mv	移动或重命名文件
ps	检查正在运转的进程
rm	删去文件
top	检查进程的资源占用状况

常见问题

发动 adb server 失利

犯错提示

error: protocol fault (couldn't read status): No error

或许原因

adb server 进程想运用的 5037 端口被占用。

解决计划

找到占用 5037 端口的进程，然后终止它。以 Windows 下为例：

netstat -ano | findstr LISTENING
...
TCP    0.0.0.0:5037           0.0.0.0:0              LISTENING       1548
...

这儿 1548 即为进程 ID，用指令完毕该进程：

taskkill /PID 1548

然后再发动 adb 就没问题了。

com.android.ddmlib.AdbCommandRejectedException

在 Android Studio 里新建一个模拟器，可是用 adb 一直衔接不上，提示：

com.android.ddmlib.AdbCommandRejectedException: device unauthorized.
This adb server's $ADB_VENDOR_KEYS is not set
Try 'adb kill-server' if that seems wrong.
Otherwise check for a confirmation dialog on your device.

在手机上装置一个终端然后履行 su 提示没有该指令，这不正常。

于是删去该模拟器后从头下载装置一次，这次就正常了。

adb 的非官方完结

• fb-adb – A better shell for Android devices (for Mac).

参阅链接

• Android Debug Bridge
• ADB Shell Commands
• logcat Command-line Tool
• Android ADB指令大全
• adb 指令行的运用记录
• Android ADB指令大全(经过ADB指令检查wifi暗码、MAC地址、设备信息、操作文件、检查文件、日志信息、卸载、发动和装置APK等)
• 那些做Android开发有必要知道的ADB指令
• adb shell top
• 像高手一样运用ADB指令行（2）

本文摘抄自

• awesome-adb