ADB使用

本是古典何须时尚 2022-06-01 07:57 194阅读 0赞

# Android 调试桥 #

## 本文内容 ##

1.  [adb 的工作方式][adb]
2.  [在您的设备上启用 adb 调试][adb 1]
3.  [通过 WLAN 连接到设备][WLAN]
4.  [查询设备][Link 1]
5.  [将命令发送至特定设备][Link 2]
6.  [安装应用][Link 3]
7.  [设置端口转发][Link 4]
8.  [将文件复制到设备/从设备复制文件][Link 5]
9.  [停止 adb 服务器][adb 2]
10. [adb 命令参考][adb 3]
11. [发出 shell 命令][shell]
    
    1.  [调用 Activity Manager (`am`)][Activity Manager _am]
    2.  [调用软件包管理器 (`pm`)][_pm]
    3.  [进行屏幕截图][Link 6]
    4.  [录制视频][Link 7]
    5.  [读取应用的 ART 配置文件][ART]
    6.  [其他 shell 命令][shell 1]

Android 调试桥 (adb) 是一个通用命令行工具，其允许您与模拟器实例或连接的 Android 设备进行通信。它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。该工具作为一个客户端-服务器程序，包括三个组件：

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

您可以在 `android_sdk/platform-tools/` 中找到 `adb` 工具。

## adb 的工作方式 ##

--------------------

启动一个 adb 客户端时，此客户端首先检查是否有已运行的 adb 服务器进程。如果没有，它将启动服务器进程。当服务器启动时，它与本地 TCP 端口 5037 绑定，并侦听从 adb 客户端发送的命令—所有 adb 客户端均使用端口 5037 与 adb 服务器通信。

然后，服务器设置与所有运行的模拟器/设备实例的连接。它通过扫描 5555 到 5585 之间（模拟器/设备使用的范围）的奇数号端口查找模拟器/设备实例。服务器一旦发现 adb 后台程序，它将设置与该端口的连接。请注意，每个模拟器/设备实例将获取一对按顺序排列的端口 — 用于控制台连接的偶数号端口和用于 adb 连接的奇数号端口。例如：

模拟器 1，控制台：5554  
模拟器 1，adb：5555  
模拟器 2，控制台：5556  
模拟器 2，adb：5557  
以此类推...

如上所示，在端口 5555 与 adb 连接的模拟器实例与侦听端口 5554 的控制台的实例相同。

当服务器已设置与所有模拟器实例的连接后，您可以使用 adb 命令访问这些实例。由于服务器管理与模拟器/设备实例的连接，并处理来自多个 adb 客户端的命令，因此，您可以从任意客户端（或从某个脚本）控制任意模拟器/设备实例。

## 在您的设备上启用 adb 调试 ##

--------------------

要在通过 USB 连接的设备上使用 adb，您必须在设备系统设置中启用 **USB debugging**（位于 **Developer options** 下）。

在运行 Android 4.2 及更高版本的设备上，Developer options 屏幕默认情况下处于隐藏状态。如需将其显示出来，请转到 **Settings > About phone** 并点按 **Build number** 七次。返回上一屏幕，在底部可以找到 **Developer options**。

在某些设备上，Developer options 屏幕所在的位置或命名方式可能有所不同。

现在，您可以将设备与 USB 连接。可以从 `android_sdk/platform-tools/` 目录执行 `adb devices` 来验证设备是否连接。如果已连接，您将看到设备名称以“设备”形式列示。

**注**：当您连接运行 Android 4.2.2 或更高版本的设备时，系统将显示一个对话框，询问您是否接受允许在这台计算机上调试的 RSA 密钥。这种安全机制可以保护用户设备，因为它可以确保只有在您能够解锁设备并确认对话框的情况下才能执行 USB 调试和其他 ADB 命令。

如需了解有关通过 USB 连接到设备的详细信息，请参阅[在硬件设备上运行应用][Link 8]。

## 通过 WLAN 连接到设备 ##

--------------------

一般情况下，通过 USB 使用 adb。不过，也可以按照下面的说明通过 WLAN 使用它。

1.  将 Android 设备和 adb 主计算机连接到这两者都可以访问的常用 WLAN 网络。请注意，并非所有访问点均适用；您可能需要使用已正确配置防火墙的访问点以支持 adb 的访问点。
    
    **注：**如果您尝试连接到 Android Wear 设备，则通过关闭与其连接的手机的蓝牙强制将它连接到 WLAN。
2.  使用 USB 电缆将设备连接到主计算机。
3.  设置目标设备以侦听端口 5555 上的 TCP/IP 连接。
    
        $ adb tcpip 5555
4.  从目标设备断开 USB 电缆连接。
5.  查找 Android 设备的 IP 地址。例如，在 Nexus 设备上，您可以通过访问 **Settings** > **About tablet**（或 **About phone**) > **Status** > **IP address** 查找 IP 地址。或者，在 Android Wear 设备上，您可以通过访问 **Settings** > **Wi-Fi Settings** > **Advanced** > **IP address** 查找 IP 地址。
6.  连接至设备，通过 IP 地址识别此设备。
    
        $ adb connect device_ip_address
7.  请确认您的主计算机已连接至目标设备：
    
        $ adb devices
        List of devices attached
        device_ip_address:5555 device

现在，您可以开始操作了！

如果 adb 连接丢失：

1.  请确保您的主机仍与您的 Android 设备连接到同一个 WLAN 网络。
2.  通过再次执行 `adb connect` 步骤重新连接。
3.  如果无法连接，则重置 adb 主机：
    
        adb kill-server
    
    然后，从头开始操作。

## 查询设备 ##

--------------------

在发出 adb 命令之前，知道哪些模拟器/设备实例已连接到 adb 服务器会很有帮助。您可以使用 `devices` 命令生成已连接的模拟器/设备的列表：

adb devices

在响应时，adb 针对每个实例输出此状态信息：

*  序列号 — 一个由 adb 创建的字符串，用于通过其控制台端口号唯一标识模拟器/设备实例。序列号的格式为 `type-console-port`。下面是一个序列号示例：`emulator-5554`
 *  状态 — 实例的连接状态可为下列状态之一：
    
     *  `offline` — 实例未连接到 adb 或不响应。
     *  `device` — 实例现在已连接到 adb 服务器。请注意，此状态并不表示 Android 系统已完全启动且可以运行，因为在此实例连接到 adb 时系统仍在启动。不过，在启动后，这将是模拟器/设备实例的正常运行状态。
     *  `no device` — 未连接模拟器/设备。

输出的格式类似如下：

List of devices attached
    serial_number state

以下示例向您展示了 `devices` 命令及其输出：

adb devices
    List of devices attached
    emulator-5554  device
    emulator-5556  device
    emulator-5558  device

## 将命令发送至特定设备 ##

--------------------

如果多个模拟器/设备实例正在运行，在发出 adb 命令时您必须指定一个目标实例。为此，请在命令中使用 `-s` 选项。以下是 `-s` 选项的用法：

adb -s serial_number command

如上所示，您使用由 adb 分配的序列号为命令指定目标实例。您可使用 `devices` 命令获取正在运行的模拟器/设备实例的序列号。例如：

adb -s emulator-5556 install helloWorld.apk

注意，如果在多个设备可用时您未指定目标模拟器/设备实例就发出命令，那么 adb 将生成一个错误。

如果您有多个设备可用（硬件或模拟设备），但只有一个设备是模拟器，则使用 `-e` 选项将命令发送至该模拟器。同样，如果有多个设备，但只连接了一个硬件设备，则使用 `-d` 选项将命令发送至该硬件设备。

## 安装应用 ##

--------------------

您可以使用 adb 从开发计算机复制应用，并将其安装到模拟器/设备实例上。为此，请使用 `install` 命令。使用此命令，您必须指定您要安装的 APK 文件的路径：

adb install path_to_apk

如需有关如何创建可在模拟器/设备实例上安装的 APK 文件的详细信息，请参阅[构建和运行您的应用][Link 9]。

请注意，如果使用 Android Studio，则无需直接使用 adb（或 aapt）在模拟器/设备上安装您的应用。而是由 Android Studio 为您处理应用的打包和安装。

## 设置端口转发 ##

--------------------

您可以使用 `forward` 命令设置任意端口转发 — 将对特定主机端口的请求转发到模拟器/设备实例上的其他端口。下面向您介绍如何设置主机端口 6100 到模拟器/设备端口 7100 的转发：

adb forward tcp:6100 tcp:7100

您也可以使用 adb 设置传输到指定的抽象 UNIX 网域套接字的转发，如下所示：

adb forward tcp:6100 local:logd

## 将文件复制到设备/从设备复制文件 ##

--------------------

您可以使用 adb 命令 `pull` 和 `push` 将文件复制到模拟器/设备实例或从其中复制文件。与 `install` 命令不同（其仅将 APK 文件复制到特定位置），`pull`和 `push` 命令允许您将任意目录和文件复制到模拟器/设备实例中的任意位置。

要*从*模拟器或设备复制文件或目录（及其子目录），请使用

adb pull remote local

要将文件文件或目录（及其子目录）复制*到*模拟器或设备，请使用

adb push local remote

在上述命令中，`local` 和 `remote` 指的是开发计算机（本地）和模拟器/设备实例（远程）上目标文件/目录的路径。例如：

adb push foo.txt /sdcard/foo.txt

## 停止 adb 服务器 ##

--------------------

在某些情况下，您可能需要终止 adb 服务器进程，然后重启它以解决问题（例如，如果 adb 不响应命令）。

要停止 adb 服务器，请使用 `adb kill-server` 命令。然后，您可以通过发出任意其他 adb 命令重启服务器。

## adb 命令参考 ##

--------------------

您可以在开发计算机上从命令行发出 adb 命令，或通过脚本发出。用法如下：

adb [-d|-e|-s serial_number] command

如果只有一个模拟器在运行或只连接了一个设备，则默认情况下将 adb 命令发送至该设备。如果有多个模拟器在运行和/或连接了多个设备，您需要使用 `-d`、`-e` 或 `-s` 选项指定应向其发送命令的目标设备。

下表列出了所有支持的 adb 命令并解释其含义和用法。

**表 1.** 可用的 adb 命令

<table style="font-size:1em; margin:0.5em 1em 1em 0px; border-width:0px; border-style:initial; border-color:initial; width:935.455px; background-color:rgb(247,247,247)"> 
 <tbody> 
  <tr> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 类别</th> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 命令</th> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 说明</th> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 注释</th> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 目标设备</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">-d</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将 adb 命令发送至唯一连接的 USB 设备。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">如果连接了多个 USB 设备，将返回错误。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">-e</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将 adb 命令发送至唯一运行的模拟器实例。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">如果有多个模拟器实例在运行，将返回错误。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">-s&nbsp;serial_number</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将 adb 命令发送至以其 adb 分配的序列号命名的特定模拟器/设备实例（如“emulator-5556”）。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">请参阅<a href="https://developer.android.com/studio/command-line/adb.html#directingcommands" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">将命令发送至特定模拟器/设备实例</a>。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 常规</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">devices</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出所有连接的模拟器/设备实例的列表。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">如需了解详细信息，请参阅<a href="https://developer.android.com/studio/command-line/adb.html#devicestatus" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">查询模拟器/设备实例</a>。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">help</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出支持的 adb 命令的列表。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">version</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出 adb 版本号。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 调试</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">logcat&nbsp;[option] [filter-specs]</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将日志数据输出到屏幕。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">bugreport</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将&nbsp;<code style="">dumpsys</code>、<code style="">dumpstate</code>&nbsp;和&nbsp;<code style="">logcat</code>&nbsp;数据输出到屏幕，以用于报告错误。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">jdwp</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出给定设备上可用的 JDWP 进程的列表。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">您可以使用&nbsp;<code style="">forward jdwp:pid</code>&nbsp;端口转发规范以连接到特定的 JDWP 进程。例如：<br> <code style="">adb forward tcp:8000 jdwp:472</code><br> <code style="">jdb -attach localhost:8000</code></td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 数据</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">install&nbsp;path_to_apk</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将 Android 应用（使用 APK 文件的完整路径表示）推送到模拟器/设备。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">pull&nbsp;remote&nbsp;local</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">从模拟器/设备实例将指定文件复制到开发计算机。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">push&nbsp;local&nbsp;remote</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">从开发计算机将指定文件复制到模拟器/设备实例。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 端口和网络连接</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">forward&nbsp;local&nbsp;remote</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将来自指定本地端口的套接字连接转发到模拟器/设备实例上的指定远程端口。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">端口规范可使用以下架构： 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">tcp:port_number</code></li> 
     <li style="margin:0px 0px 12px"><code style="">local:unix_domain_socket_name</code></li> 
     <li style="margin:0px 0px 12px"><code style="">dev:character_device_name</code></li> 
     <li style="margin:0px"><code style="">jdwp:pid</code></li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">ppp&nbsp;tty&nbsp;[parm]...</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">通过 USB 运行 PPP。 
    <ul style="margin:0px 0px 15px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">tty</code>&nbsp;— 用于 PPP 流的 tty。例如，<code style="">dev:/dev/omap_csmi_ttyl</code>。</li> 
     <li style="margin:0px"><code style="">[parm]...&nbsp;</code>— 零个或多个 PPP/PPPD 选项，如&nbsp;<code style="">defaultroute</code>、<code style="">local</code>、<code style="">notty</code>等。</li> 
    </ul> <p style="margin-bottom:0px">请注意，不得自动启动 PPP 连接。</p> </td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 脚本</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">get-serialno</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出 adb 实例序列号字符串。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 如需了解详细信息，请参阅<a href="https://developer.android.com/studio/command-line/adb.html#devicestatus" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">查询模拟器/设备实例</a>。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">get-state</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出模拟器/设备实例的 adb 状态。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">wait-for-device</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">阻止执行，直至设备处于在线状态，即直至此实例状态为&nbsp;<code style="">device</code>。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">您可以将此命令附加到其他 adb 命令，在此情况下，adb 在发出其他命令前将处于等待状态，直至模拟器/设备实例已连接。下面是一个示例： <pre style="">adb wait-for-device shell getprop</pre> 请注意，此命令<em>不会</em>使 adb 等待整个系统已完全启动。因此，您不应将其追加到需要系统完全启动的其他命令。例如，<code style="">install</code>&nbsp;需要使用 Android 软件包管理器，其仅在系统完全启动后才可用。如下命令 <pre style="">adb wait-for-device install app.apk</pre> 在模拟器或设备实例连接到 adb 服务器时立即发出&nbsp;<code style="">install</code>&nbsp;命令，但 Android 系统还未完全启动，因此，它将引发错误。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 服务器</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">start-server</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">检查 adb 服务器进程是否在运行，如果未运行则启动它。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">kill-server</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">终止 adb 服务器进程。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">&nbsp;</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> Shell</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">shell</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">在目标模拟器/设备实例中启动远程 shell。</td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> 如需了解详细信息，请参阅<a href="https://developer.android.com/studio/command-line/adb.html#shellcommands" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">发出 shell 命令</a>。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">shell&nbsp;shell_command</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">在目标模拟器/设备实例中发出 shell 命令，然后退出远程 shell。</td> 
  </tr> 
 </tbody> 
</table>

## 发出 shell 命令 ##

--------------------

您可以使用 `shell` 命令通过 adb 发出设备命令，可以进入或不进入模拟器/设备实例上的 adb 远程 shell。要在不进入远程 shell 的情况下发出一个命令，请使用如下 `shell` 命令：

adb [-d|-e|-s serial_number] shell shell_command

或者，使用如下命令进入模拟器/设备实例上的远程 shell：

adb [-d|-e|-s serial_number] shell

当您准备退出远程 shell 时，按 Control + D 或输入 `exit`。

shell 命令二进制文件存储在模拟器或设备的文件系统中，其路径为 `/system/bin/`。

### 调用 Activity Manager (`am`) ###

在 adb shell 中，您可以使用 Activity Manager (`am`) 工具发出命令以执行各种系统操作，如启动 Activity、强行停止进程、广播 intent、修改设备屏幕属性及其他操作。在 shell 中，此语法为：

am command

您也可以直接从 adb 发出 Activity Manager 命令，无需进入远程 shell。例如：

adb shell am start -a android.intent.action.VIEW

**表 2.** 可用的 Activity Manager 命令

<table style="font-size:1em; margin:0.5em 1em 1em 0px; border-width:0px; border-style:initial; border-color:initial; width:935.455px; background-color:rgb(247,247,247)"> 
 <tbody> 
  <tr> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 命令</th> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 说明</th> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">start [options]&nbsp;intent</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">启动&nbsp;<code style="">intent</code>&nbsp;指定的&nbsp;<code style=""><a href="https://developer.android.com/reference/android/app/Activity.html" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">Activity</a></code>。 <p style="margin-bottom:12px">请参阅&nbsp;<a href="https://developer.android.com/studio/command-line/adb.html#IntentSpec" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">intent 参数的规范</a>。</p> <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-D</code>：启用调试。</li> 
     <li style="margin:0px 0px 12px"><code style="">-W</code>：等待启动完成。</li> 
     <li style="margin:0px 0px 12px"><code style="">--start-profiler&nbsp;file</code>：启动分析器并将结果发送到&nbsp;<code style="">file</code>。</li> 
     <li style="margin:0px 0px 12px"><code style="">-P&nbsp;file</code>：类似于&nbsp;<code style="">--start-profiler</code>，但当应用进入空闲状态时分析停止。</li> 
     <li style="margin:0px 0px 12px"><code style="">-R&nbsp;count</code>：重复 Activity 启动&nbsp;<code style="">count</code>&nbsp;次数。在每次重复前，将完成顶部 Activity。</li> 
     <li style="margin:0px 0px 12px"><code style="">-S</code>：启动 Activity 前强行停止目标应用。</li> 
     <li style="margin:0px 0px 12px"><code style="">--opengl-trace</code>：启用 OpenGL 函数的跟踪。</li> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id&nbsp;| current</code>：指定要作为哪个用户运行；如果未指定，则作为当前用户运行。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">startservice [options]&nbsp;intent</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">启动&nbsp;<code style="">intent</code>&nbsp;指定的&nbsp;<code style=""><a href="https://developer.android.com/reference/android/app/Service.html" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">Service</a></code>。 <p style="margin-bottom:12px">请参阅&nbsp;<a href="https://developer.android.com/studio/command-line/adb.html#IntentSpec" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">intent 参数的规范</a>。</p> <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id&nbsp;| current</code>：指定要作为哪个用户运行；如果未指定，则作为当前用户运行。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">force-stop&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">强行停止与&nbsp;<code style="">package</code>（应用的包名称）关联的所有应用。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">kill [options]&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">终止与&nbsp;<code style="">package</code>（应用的包名称）关联的所有进程。此命令仅终止可安全终止且不会影响用户体验的进程。 <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id&nbsp;| all | current</code>：指定将终止其进程的用户；如果未指定，则终止所有用户的进程。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">kill-all</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">终止所有后台进程。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">broadcast [options]&nbsp;intent</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">发出广播 intent。 <p style="margin-bottom:12px">请参阅&nbsp;<a href="https://developer.android.com/studio/command-line/adb.html#IntentSpec" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">intent 参数的规范</a>。</p> <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">[--user&nbsp;user_id&nbsp;| all | current]</code>：指定要发送到的用户；如果未指定，则发送到所有用户。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">instrument [options]&nbsp;component</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">使用&nbsp;<code style=""><a href="https://developer.android.com/reference/android/app/Instrumentation.html" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">Instrumentation</a></code>&nbsp;实例启动监控。通常，目标&nbsp;<code style="">component</code>&nbsp;是表单&nbsp;<code style="">test_package/runner_class</code>。 <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-r</code>：输出原始结果（否则对&nbsp;<code style="">report_key_streamresult</code>&nbsp;进行解码）。与&nbsp;<code style="">[-e perf true]</code>&nbsp;结合使用以生成性能测量的原始输出。</li> 
     <li style="margin:0px 0px 12px"><code style="">-e&nbsp;name&nbsp;value</code>：将参数&nbsp;<code style="">name</code>&nbsp;设为&nbsp;<code style="">value</code>。对于测试运行器，通用表单为&nbsp;<code style="">-e&nbsp;testrunner_flagvalue[,value...]</code>。</li> 
     <li style="margin:0px 0px 12px"><code style="">-p&nbsp;file</code>：将分析数据写入&nbsp;<code style="">file</code>。</li> 
     <li style="margin:0px 0px 12px"><code style="">-w</code>：先等待仪器完成，然后再返回。测试运行器需要使用此选项。</li> 
     <li style="margin:0px 0px 12px"><code style="">--no-window-animation</code>：运行时关闭窗口动画。</li> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id&nbsp;| current</code>：指定仪器在哪个用户中运行；如果未指定，则在当前用户中运行。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">profile start&nbsp;process&nbsp;file</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">启动&nbsp;<code style="">process</code>&nbsp;的分析器，将结果写入&nbsp;<code style="">file</code>。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">profile stop&nbsp;process</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">停止&nbsp;<code style="">process</code>&nbsp;的分析器。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit; white-space:nowrap"> <code style="">dumpheap [options]&nbsp;process&nbsp;file</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">转储&nbsp;<code style="">process</code>&nbsp;的堆，写入&nbsp;<code style="">file</code>。 <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">--user [user_id|current]</code>：提供进程名称时，指定要转储的进程用户；如果未指定，则使用当前用户。</li> 
     <li style="margin:0px"><code style="">-n</code>：转储原生堆，而非托管堆。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">set-debug-app [options]&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将应用&nbsp;<code style="">package</code>&nbsp;设为调试。 <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-w</code>：应用启动时等待调试程序。</li> 
     <li style="margin:0px"><code style="">--persistent</code>：保留此值。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">clear-debug-app</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">使用&nbsp;<code style="">set-debug-app</code>&nbsp;清除以前针对调试用途设置的软件包。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">monitor [options]</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">启动对崩溃或 ANR 的监控。 <p style="margin-bottom:12px">选项包括：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">--gdb</code>：在崩溃/ANR 时在给定端口上启动 gdbserv。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">screen-compat {on|off}&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">控制&nbsp;<code style="">package</code>&nbsp;的<a href="https://developer.android.com/guide/practices/screen-compat-mode.html" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">屏幕兼容性</a>模式。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">display-size [reset|widthxheight]</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">替换模拟器/设备显示尺寸。此命令对于在不同尺寸的屏幕上测试您的应用非常有用，它支持使用大屏设备模仿小屏幕分辨率（反之亦然）。 <p style="margin-bottom:0px">示例：<br> <code style="">am display-size 1280x800</code></p> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">display-density&nbsp;dpi</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">替换模拟器/设备显示密度。此命令对于在不同密度的屏幕上测试您的应用非常有用，它支持使用低密度屏幕在高密度环境环境上进行测试（反之亦然）。 <p style="margin-bottom:0px">示例：<br> <code style="">am display-density 480</code></p> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">to-uri&nbsp;intent</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将给定的 intent 规范以 URI 的形式输出。 <p style="margin-bottom:0px">请参阅&nbsp;<a href="https://developer.android.com/studio/command-line/adb.html#IntentSpec" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">intent 参数的规范</a>。</p> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">to-intent-uri&nbsp;intent</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将给定的 intent 规范以&nbsp;<code style="">intent:</code>URI 的形式输出。 <p style="margin-bottom:0px">请参阅&nbsp;<a href="https://developer.android.com/studio/command-line/adb.html#IntentSpec" style="color:rgb(3,155,229); margin-bottom:0px" rel="nofollow">intent 参数的规范</a>。</p> </td> 
  </tr> 
 </tbody> 
</table>

#### ▸intent 参数的规范 ####

### 调用软件包管理器 (`pm`) ###

在 adb shell 中，您可以使用软件包管理器 (`pm`) 工具发出命令，以对设备上安装的应用软件包进行操作和查询。在 shell 中，此语法为：

pm command

您也可以直接从 adb 发出软件包管理器命令，无需进入远程 shell。例如：

adb shell pm uninstall com.example.MyApp

**表 3.** 可用的软件包管理器命令。

<table style="font-size:1em; margin:0.5em 1em 1em 0px; border-width:0px; border-style:initial; border-color:initial; width:935.455px; background-color:rgb(247,247,247)"> 
 <tbody> 
  <tr> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 命令</th> 
   <th style="padding:4px 12px; vertical-align:top; text-align:left; background-color:rgb(153,153,153); color:rgb(255,255,255); font-weight:normal"> 说明</th> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list packages [options]&nbsp;filter</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出所有软件包，或者，仅输出包名称包含&nbsp;<code style="">filter</code>&nbsp;中的文本的软件包。 <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-f</code>：查看它们的关联文件。</li> 
     <li style="margin:0px 0px 12px"><code style="">-d</code>：进行过滤以仅显示已停用的软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-e</code>：进行过滤以仅显示已启用的软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-s</code>：进行过滤以仅显示系统软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-3</code>：进行过滤以仅显示第三方软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-i</code>：查看软件包的安装程序。</li> 
     <li style="margin:0px 0px 12px"><code style="">-u</code>：也包括卸载的软件包。</li> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id</code>：要查询的用户空间。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list permission-groups</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出所有已知的权限组。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list permissions [options]&nbsp;group</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出所有已知权限，或者，仅输出&nbsp;<code style="">group</code>&nbsp;中的权限。 <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-g</code>：按组加以组织。</li> 
     <li style="margin:0px 0px 12px"><code style="">-f</code>：输出所有信息。</li> 
     <li style="margin:0px 0px 12px"><code style="">-s</code>：简短摘要。</li> 
     <li style="margin:0px 0px 12px"><code style="">-d</code>：仅列出危险权限。</li> 
     <li style="margin:0px"><code style="">-u</code>：仅列出用户将看到的权限。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list instrumentation [options]</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">列出所有测试软件包。 <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-f</code>：列出用于测试软件包的 APK 文件。</li> 
     <li style="margin:0px"><code style="">target_package</code>：列出仅用于此应用的测试软件包。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list features</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出系统的所有功能。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list libraries</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出当前设备支持的所有库。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">list users</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出系统上的所有用户。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">path&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出给定&nbsp;<code style="">package</code>&nbsp;的 APK 的路径。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">install [options]&nbsp;path</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">将软件包（通过&nbsp;<code style="">path</code>&nbsp;指定）安装到系统。 <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">-l</code>：安装具有转发锁定功能的软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-r</code>：重新安装现有应用，保留其数据。</li> 
     <li style="margin:0px 0px 12px"><code style="">-t</code>：允许安装测试 APK。</li> 
     <li style="margin:0px 0px 12px"><code style="">-i&nbsp;installer_package_name</code>：指定安装程序软件包名称。</li> 
     <li style="margin:0px 0px 12px"><code style="">-s</code>：在共享的大容量存储（如 sdcard）上安装软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-f</code>：在内部系统内存上安装软件包。</li> 
     <li style="margin:0px 0px 12px"><code style="">-d</code>：允许版本代码降级。</li> 
     <li style="margin:0px"><code style="">-g</code>：授予应用清单中列出的所有权限。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">uninstall [options]&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">从系统中移除软件包。 <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">-k</code>：移除软件包后保留数据和缓存目录。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">clear&nbsp;package</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">删除与软件包关联的所有数据。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">enable&nbsp;package_or_component</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">启用给定软件包或组件（作为“package/class”写入）。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">disable&nbsp;package_or_component</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">停用给定软件包或组件（作为“package/class”写入）。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit; white-space:nowrap"> <code style="">disable-user [options]&nbsp;package_or_component</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"> <p style="margin-bottom:12px">选项：</p> 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px"><code style="">--user&nbsp;user_id</code>：要停用的用户。</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">grant&nbsp;package_name&nbsp;permission</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">向应用授予权限。在运行 Android 6.0（API 级别 23）及更高版本的设备上，可以是应用清单中声明的任何权限。在运行 Android 5.1（API 级别 22）和更低版本的设备上，必须是应用定义的可选权限。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">revoke&nbsp;package_name&nbsp;permission</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">从应用中撤销权限。在运行 Android 6.0（API 级别 23）及更高版本的设备上，可以是应用清单中声明的任何权限。在运行 Android 5.1（API 级别 22）和更低版本的设备上，必须是应用定义的可选权限。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">set-install-location&nbsp;location</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">更改默认安装位置。位置值： 
    <ul style="margin:0px 0px 15px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">0</code>：自动—让系统决定最佳位置。</li> 
     <li style="margin:0px 0px 12px"><code style="">1</code>：内部—安装在内部设备存储上。</li> 
     <li style="margin:0px"><code style="">2</code>：外部—安装在外部介质上。</li> 
    </ul> <p style="margin-top:16px; padding-top:0px; padding-bottom:0px; padding-left:20px"> <span style="margin-bottom:0px">注</span>：此命令仅用于调试目的；使用此命令会导致应用中断和其他意外行为。</p> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">get-install-location</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">返回当前安装位置。返回值： 
    <ul style="margin:0px 0px 0px 20px; padding:0px"> 
     <li style="margin:0px 0px 12px"><code style="">0 [auto]</code>：让系统决定最佳位置。</li> 
     <li style="margin:0px 0px 12px"><code style="">1 [internal]</code>：安装在内部设备存储上</li> 
     <li style="margin:0px"><code style="">2 [external]</code>：安装在外部介质上</li> 
    </ul> </td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">set-permission-enforced&nbsp;permission[true|false]</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">指定是否应强制执行给定的权限。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">trim-caches&nbsp;desired_free_space</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">减少缓存文件以达到给定的可用空间。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">create-user&nbsp;user_name</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">使用给定的&nbsp;<code style="">user_name</code>&nbsp;创建新用户，输出新用户的标识符。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">remove-user&nbsp;user_id</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">移除具有给定的&nbsp;<code style="">user_id</code>&nbsp;的用户，删除与该用户关联的所有数据。</td> 
  </tr> 
  <tr> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit"><code style="">get-max-users</code></td> 
   <td style="padding:4px 12px; vertical-align:top; background-color:inherit">输出设备支持的最大用户数。</td> 
  </tr> 
 </tbody> 
</table>

### 进行屏幕截图 ###

`screencap` 命令是一个用于对设备显示屏进行屏幕截图的 shell 实用程序。在 shell 中，此语法为：

screencap filename

要从命令行使用 `screencap`，请输入以下命令：

$ adb shell screencap /sdcard/screen.png

以下屏幕截图会话示例向您展示使用 adb shell 捕获屏幕截图，并使用 `pull` 命令从设备下载此文件：

$ adb shell
    shell@ $ screencap /sdcard/screen.png
    shell@ $ exit
    $ adb pull /sdcard/screen.png

### 录制视频 ###

`screenrecord` 命令是一个用于录制设备（运行 Android 4.4（API 级别 19）及更高版本）显示屏的 shell 实用程序。此实用程序将屏幕 Activity 录制到 MPEG-4 文件。

**注**：音频不与视频文件一起录制。

开发者可以使用此文件创建宣传视频或培训视频。在 shell 中，此语法为：

screenrecord [options] filename

要从命令行使用 `screenrecord`，请输入以下命令：

$ adb shell screenrecord /sdcard/demo.mp4

按 Control + C 停止屏幕录制，否则，到三分钟或 `--time-limit` 设置的时间限制时，录制将自动停止。

要开始录制设备屏幕，请运行 `screenrecord` 命令以录制视频。然后，运行 `pull` 命令从设备将此视频下载到主计算机。下面是一个录制会话示例：

$ adb shell
    shell@ $ screenrecord --verbose /sdcard/demo.mp4
    (press Control + C to stop)
    shell@ $ exit
    $ adb pull /sdcard/demo.mp4

`screenrecord` 实用程序可以任何支持的分辨率和所需的比特率进行录制，同时保留设备显示屏的纵横比。默认情况下，此实用程序以原生显示分辨率和屏幕方向进行录制，最大时长为三分钟。

下面是 `screenrecord` 实用程序的一些已知限制，您在使用时应注意：

*  某些设备可能无法以它们的原生显示分辨率进行录制。如果在录制屏幕时出现问题，请尝试使用较低的屏幕分辨率。
 *  不支持在录制时旋转屏幕。如果在录制期间屏幕旋转了，则部分屏幕的录制将被切断。

**表 4.** `screenrecord` 选项

### 读取应用的 ART 配置文件 ###

从 Android 7.0（API 级别 24）开始，Android Runtime (ART) 会收集已安装应用的执行配置文件，其可用于优化应用性能。您可能想要检查收集的配置文件，以了解在应用启动期间，系统决定频繁执行哪些方法和使用哪些类。

要生成配置文件信息的文本表单，请使用以下命令：

$ adb shell cmd package dump-profiles package

要检索生成的文件，请使用：

$ adb pull /data/misc/profman/package.txt

### 其他 shell 命令 ###

如需所有可用 shell 程序的列表，请使用以下命令：

adb shell ls /system/bin

大多数命令都提供帮助说明。

表 5 列出了一些比较常用的 adb shell 命令。

**表 5.** 其他一些 adb shell 命令

[adb]: https://developer.android.com/studio/command-line/adb.html#howadbworks
[adb 1]: https://developer.android.com/studio/command-line/adb.html#Enabling
[WLAN]: https://developer.android.com/studio/command-line/adb.html#wireless
[Link 1]: https://developer.android.com/studio/command-line/adb.html#devicestatus
[Link 2]: https://developer.android.com/studio/command-line/adb.html#directingcommands
[Link 3]: https://developer.android.com/studio/command-line/adb.html#move
[Link 4]: https://developer.android.com/studio/command-line/adb.html#forwardports
[Link 5]: https://developer.android.com/studio/command-line/adb.html#copyfiles
[adb 2]: https://developer.android.com/studio/command-line/adb.html#stopping
[adb 3]: https://developer.android.com/studio/command-line/adb.html#issuingcommands
[shell]: https://developer.android.com/studio/command-line/adb.html#shellcommands
[Activity Manager _am]: https://developer.android.com/studio/command-line/adb.html#am
[_pm]: https://developer.android.com/studio/command-line/adb.html#pm
[Link 6]: https://developer.android.com/studio/command-line/adb.html#screencap
[Link 7]: https://developer.android.com/studio/command-line/adb.html#screenrecord
[ART]: https://developer.android.com/studio/command-line/adb.html#appprofiles
[shell 1]: https://developer.android.com/studio/command-line/adb.html#othershellcommands
[Link 8]: https://developer.android.com/studio/run/device.html
[Link 9]: https://developer.android.com/studio/run/index.html