Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

在硬件设备上运行应用

编译 Android 应用时,务必要始终先在真实的设备上测试您的应用,然后再向用户发布。本页面介绍了如何针对 Android 调试桥 (ADB) 连接测试和调试,设置您的开发环境和 Android 设备。

面向开发设置设备

您必须执行以下操作,才能在设备上开始调试:

  1. 在设备上,打开 Settings 应用,选择 Developer options,然后启用 USB debugging

  2. 设置您的系统以检测设备。

    • macOS:无需其他配置。
    • Ubuntu Linux:使用 apt-get install 安装 adb 软件包。这样,您便可以获得适用于所有 Android 设备且由社区维护的默认 udev 规则集。

      请确保您在 plugdev 组中。如果您看到以下错误消息,则 adb 未在 plugdev 组中找到您:

      error: insufficient permissions for device: udev requires plugdev group membership
          

      使用 id 查看您所在的组。使用 sudo usermod -aG plugdev $LOGNAME 将您自己添加到 plugdev 组中。

      以下示例展示了如何安装 Android adb 工具包。

      apt-get install adb
          
    • Windows:为 ADB 安装 USB 驱动程序。如需安装指南和原始设备制造商驱动程序的链接,请参阅安装原始设备制造商 USB 驱动程序文档。

连接到您的设备

您做好准备并通过 USB 连接后,可以在 Android Studio 中点击“Run”图标 在设备上编译和运行您的应用

您还可以使用 adb 发出命令,如下所示:

  • android_sdk/platform-tools/ 目录运行 adb devices 命令来验证设备是否连接。如果已连接,您将看到该设备被列出。
  • 发出任意包含 -d 标记的 adb 命令,将目标确定为您的设备。

使用 Connection Assistant 排查设备连接问题

Connection Assistant 提供了逐步说明,可帮助您通过 ADB 连接来设置和使用设备。

要启用此 Assistant,请依次选择 Tools > Connection Assistant

Connection Assistant 在 Assistant 面板中的一系列页面中提供了说明、环境控件以及已连接设备列表。根据需要,使用 Assistant 面板底部的 NextPrevious 按钮浏览页面:

  • 通过 USB 连接设备:Connection Assistant 首先提示您通过 USB 连接设备,并提供 Rescan USB devices 按钮,您可以使用该按钮启动对已连接设备的新一次扫描。
  • 启用 USB 调试:然后,Connection Assistant 将向您介绍如何在设备上的开发者选项中启用 USB 调试。
  • 重新启动 ADB 服务器:最后,如果您仍未在可用设备列表中看到您的设备,可以使用 Connection Assistant 最后一页上的 Restart ADB server 按钮。重新启动 ADB 服务器还会导致 ADB 再次扫描设备。如果您仍未在可用设备列表中看到您的设备,请尝试本页下一部分中的问题排查步骤。

解决 USB 连接问题

如果 Connection Assistant 未通过 USB 检测到您的设备,您可以尝试通过以下问题排查步骤来解决问题:

检查 Android Studio 能否连接到 Android 模拟器

要检查问题是否是由 Android Studio 与 Android 模拟器的连接问题引起的,请按照下列步骤操作:

  1. 打开 AVD Manager
  2. 新建 AVD(如果您尚未创建)。
  3. 使用 AVD 运行模拟器
  4. 执行以下任一操作:

检查 USB 数据线

要检查问题是否是由 USB 数据线故障引起的,请按照本部分中的步骤操作。

如果您有其他 USB 数据线:

  1. 使用辅助数据线连接设备。
  2. 检查 Connection Assistant 现在能否检测到设备。
  3. 如果未检测到设备,请再次尝试使用主数据线。
  4. 如果仍未检测到设备,则假定问题是设备所致并检查设备是否已针对开发进行设置

如果您没有其他 USB 数据线,但有其他 Android 设备:

  1. 将辅助设备连接到计算机。
  2. 如果 Connection Assistant 可以检测到辅助设备,则假定问题是主设备所致并检查设备是否已针对开发进行设置

    如果未检测到辅助设备,则问题可能是 USB 数据线所致。

检查设备是否已针对开发进行设置

要检查问题是否是由设备上的设置引起的,请按照下列步骤操作:

  1. 按照针对开发设置设备部分中的步骤操作。
  2. 如果这未解决问题,请与原始设备制造商的客户支持代表联系以获取帮助。告诉客户支持代表,无法使用 ADB 将该设备连接到 Android Studio。

RSA 安全密钥

当您将运行 Android 4.2.2(API 级别 17)或更高版本的设备连接到计算机时,系统将显示一个对话框,询问您是否接受允许通过此计算机进行调试的 RSA 密钥。这种安全机制可以保护用户设备,因为它可以确保只有在您能够解锁设备并确认对话框的情况下才能执行 USB 调试和其他 adb 命令。