在硬件设备上运行应用

构建 Android 应用时，务必始终先在真实设备上测试您的应用，然后再向用户发布。本页介绍了如何设置您的开发环境和 Android 设备，以便通过 Android 调试桥 (ADB) 连接进行测试和调试。

注意：您可以使用 Android 模拟器在不同版本的 Android 平台上以及不同尺寸的屏幕上测试您的应用。还可以考虑使用 Firebase 测试实验室在基于云的基础架构中托管的各种真实设备上运行您的应用。

针对开发设置设备

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

1. 在设备上，打开设置应用，选择开发者选项，然后启用 USB 调试。

   注意：如果您未看到开发者选项，请按照相关说明启用开发者选项。

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

   • Chrome 操作系统：无需其他配置。
   • macOS：无需其他配置。

   • Ubuntu Linux：需要正确进行两项设置：希望使用 adb 的每个用户都需要位于 plugdev 组中，并且需要为系统添加涵盖设备的 udev 规则。

     plugdev 组：如果您看到一条错误消息，指出您不在 plugdev 组中，您需要将自己添加到 plugdev 组中：

     sudo usermod -aG plugdev $LOGNAME
     

     请注意，组只会在您登录时更新，因此您需要退出后重新登录，此更改才能生效。当您重新登录后，可以使用 id 检查自己现在是否已在 plugdev 组中。

     udev 规则：android-sdk-platform-tools-common 软件包中包含一组适用于 Android 设备并由社区维护的默认 udev 规则。请使用以下命令添加这些规则：

     apt-get install android-sdk-platform-tools-common
     

   • Windows：为 ADB 安装 USB 驱动程序。如需安装指南和 OEM 驱动程序的链接，请参阅安装 OEM 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 面板底部的 Next 和 Previous 按钮浏览页面：

• 通过 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 管理器。
2. 创建一个新的 AVD（如果您还没有 AVD）。
3. 使用 AVD 运行模拟器。
4. 执行以下某项操作：
   • 如果 Android Studio 无法连接到模拟器，请下载最新的 SDK 平台工具，然后重试。
   • 如果模拟器成功启动，请检查 USB 数据线。

检查 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 命令。