设置用于调试的 Android 设备

虽然 Android 仿真器 是快速开发和测试应用的好方法,但你需要在真实的 Android 设备上测试应用。 若要在设备上运行,需要在设备上启用开发人员模式并将其连接到计算机。 有关详细信息,请参阅 developer.android.com 上的硬件设备上运行应用

重要

本文中的步骤以通用的方式编写,旨在适用于尽可能多的设备。 如果在设备上找不到这些设置,请参阅设备制造商的文档。

在设备上启用开发人员模式

设备必须启用开发人员模式才能部署和测试 Android 应用。 通过以下步骤启用开发人员模式:

  1. 转到 “设置” 屏幕。
  2. 选择“ 关于手机”。
  3. 选择 “软件信息”。
  4. 点击“版本号”7 次,直到看到“你现在是开发人员!”

根据设备正在运行的 UI,“ 关于手机 ”选项可能位于其他位置。 如果找不到 “关于手机”,请参阅设备文档。

Android 上的“开发人员选项”屏幕。

启用 USB 调试

在设备上启用开发人员模式后,请按照以下步骤启用 USB 调试:

  1. 转到 “设置” 屏幕。
  2. 选择 “开发人员”选项
  3. 打开 USB 调试 选项。

根据设备运行的 UI,USB 调试 选项可能位于其他位置。 如果找不到 USB 调试,请参阅设备文档。

将设备连接到计算机

最后一步是将设备连接到计算机。 最简单的最可靠方法是通过 USB 执行此作。

如果您以前没有使用这台计算机进行调试,您将在设备上收到一个请求,要求您信任这台计算机。 还可以选中 “始终允许来自此计算机的连接”,以避免每次连接设备时都需要出现此提示。

Android 设备信任提示:允许计算机使用 USB 调试。

如果计算机在插入设备时无法识别设备,请尝试安装设备的驱动程序。 请参阅设备制造商的支持文档。 还可以尝试通过 Android SDK 管理器安装 Google USB 驱动程序:

选择了 Google USB 设备驱动程序的 Android SKD 管理器。

启用 WiFi 调试

可以通过 WiFi 调试 Android 设备,而无需将设备物理连接到计算机。 此方法需要更多精力,但如果设备离计算机太远,无法通过电缆不断插入,则可能会很有用。

通过 WiFi 进行连接

默认情况下,Android 调试桥(adb)配置为通过 USB 与 Android 设备通信。 可以将其重新配置为使用 TCP/IP 而不是 USB。 为此,设备和计算机必须位于同一 WiFi 网络上。

注释

Google USB 驱动程序是必需的,以在 Windows 上使用 Google 设备执行 adb 调试。 有关详细信息,请参阅在 developer.android.com 上获取 Google USB 驱动程序 。 所有其他设备的 Windows 驱动程序由相应的硬件制造商提供。 有关详细信息,请参阅在 developer.android.com 上安装 OEM USB 驱动程序

首先,在 Android 设备上启用无线调试:

  1. 按照启用开发人员模式部分中的步骤操作。
  2. 按照"启用 USB 调试"部分中的步骤操作。
  3. 转到 “设置” 屏幕。
  4. 选择 “开发人员”选项
  5. 打开 无线调试 选项。

根据设备运行的 UI, 无线调试 选项可能位于其他位置。 如果找不到 无线调试,请参阅设备文档。

接下来,使用 adb 连接到设备,首先通过 USB 连接:

  1. 确定 Android 设备的 IP 地址。 找出 IP 地址的一种方法是在 “设置 > 网络和 Internet > Wi-Fi”下查找,然后点击设备连接到的 WiFi 网络,然后点击“ 高级”。 这将打开一个下拉列表,其中显示了有关网络连接的信息,类似于以下屏幕截图中所示的内容:

    具有 IP 地址的 Android 状态屏幕。

    在某些版本的 Android 上,IP 地址不会列出,但可以在“关于电话>状态设置”>下找到。

  2. 在 Visual Studio 中,通过选择菜单选项打开 adb 命令提示符:Android>>Android Adb 命令提示符工具...

  3. 在命令提示符中,使用 adb tcpip 命令告知设备侦听端口 5555 上的 TCP/IP 连接。

    adb tcpip 5555
    
  4. 断开与设备的 USB 电缆的连接。

  5. 使用端口 5555 连接到设备的 IP 地址:

    adb connect 192.168.1.28:5555
    

    此命令完成后,Android 设备通过 WiFi 连接到计算机。

    通过 WiFi 完成调试后,可以使用以下命令将 ADB 重置回 USB 模式:

    adb usb
    

    若要查看连接到计算机的设备,请使用 adb devices 以下命令:

    adb devices
    

在没有 USB 电缆的情况下通过 WiFi 连接

警告

此方法仅适用于运行 Android 11(API 级别 30)及更高版本的设备。

  1. 按照启用开发人员模式部分中的步骤操作。

  2. 按照"启用 USB 调试"部分中的步骤操作。

  3. 转到 “设置” 屏幕。

  4. 选择 “开发人员”选项

  5. 打开 无线调试 选项。

  6. 单击开关旁边的区域以输入无线调试设置。 用于无线调试设置的按钮。

  7. 选择 “配对设备与配对代码”。 它将生成配对代码并显示具有适当端口的 IP 地址,它应如以下屏幕截图所示: 通过配对代码配对。

  8. 打开具有 adb 访问权限的终端。 执行此操作的一种方法是转到 Visual Studio,并选择工具 Android Android Adb 命令提示符

  9. 使用 IP 地址和端口将设备配对。

    adb pair 192.168.1.5:42219
    
  10. 出现提示时, 输入配对代码。 成功配对设备后,应可用作 Visual Studio 中的调试目标。 有关选择调试目标的更多详细信息,请参阅 在 Android 设备上调试应用

在设备上配置开发人员选项

Android 上的“设置”应用包括一个名为 “开发人员”选项 的屏幕,你可以在其中配置有助于分析和调试应用性能的系统行为。 有关详细信息,请参阅 developer.android.com 上的 配置设备上的开发人员选项

在 Android 设备上调试应用

若要在 Android 设备上调试应用,请执行以下作:

  1. 将设备插入计算机,并将其选为 Visual Studio 或 Visual Studio Code 中的调试目标。
  2. 运行应用。

有关在 Visual Studio 中选择调试目标的信息,请参阅 生成第一个应用。 有关在 Visual Studio Code 中选择调试目标的信息,请参阅 生成第一个应用