文档

Unity Engine

User Manual

Script Reference

Unity Engine

在 Android 设备上进行调试

Debug your application on an Android device via a USB or wireless connection.
阅读时间4 分钟最后更新于 1 个月前
Unity 支持以下方式在 Android 设备上调试应用程序：

USB 调试

Unity 支持 Android 设备的 USB 调试。要使用 USB 调试，请确保设备已启用开发者选项 (Developer options)。为此，请参阅 Android 的 Configure Developer options 文档。
使用 USB 线缆将设备连接到开发计算机。如果您在 Windows 系统上开发，可能需要安装设备专用的 USB 驱动程序。相关信息请访问设备制造商的官方网站。
Windows 和 macOS 的设置过程有所不同。有关将 Android 设备连接到 SDK 的更多信息，请参阅 Android 开发者文档的运行应用程序 (Running Your App) 部分。

Android 调试桥 (ADB)

Unity 支持通过 USB 和无线连接的 Android 调试桥(ADB)。无线连接在以下场景中非常有用：无法进行 USB 调试时、控制器已连接到 Android 设备时、调试 VR 应用程序且 Android 设备插入 VR 套件时。

通过 USB 连接

要使用 USB 通过 ADB 将 Android 设备连接到 Unity：
  1. 在设备上启用 ADB。具体操作，请参阅设置设备进行开发。
  2. 使用 USB 线缆将 Android 设备连接到运行 Unity 的计算机。
  3. 导航到文件 (File) > 构建配置文件 (Build profiles)。
  4. 选择或添加 Android 构建配置文件。
  5. 在 Run Device 构建设置中，从可用选项中选择设备。如果设备未出现，请单击 Refresh。
  6. 选择构建并运行 (Build And Run) 以构建应用程序并在设备上运行。

无线连接

要通过 ADB 将 Android 设备无线连接到 Unity，请执行以下操作：
  1. 在设备上启用无线 ADB。具体操作请参考使用 Wi-Fi 连接到设备。
  2. 查找设备的 IP 地址。执行此操作的过程取决于设备制造商。
  3. 导航到文件 (File) > 构建配置文件 (Build profiles)。
  4. 选择或创建 Android 构建配置文件。
  5. 从 Run Device 构建设置中，选择 <Enter IP> 选项。
  6. 在打开的窗口中，输入设备的 IP 地址和端口号。如果设备的端口号为 
    5555
    ，则无需输入。
  7. 选择 Add。Unity 连接到设备后，设备名称将显示在 Run Device 列表中并自动选中。
  8. 选择构建并运行 (Build And Run) 以构建应用程序并在设备上运行。

查看 Android 日志

在 Android 设备上运行应用程序时，Android 会从脚本中收集堆栈跟踪和日志等信息。为了查看这些日志，Android 提供了 logcat 命令行工具。要将此工具用于 Unity 应用程序，请执行以下操作之一：
  • 使用 
    logcat
    参数启动 ADB：
    $ adb logcat
  • 使用 Unity 的 Android Logcat 插件。该插件实现了 logcat 命令行工具的功能，并在 Unity 的专用窗口中显示应用程序的日志信息。
更多信息，请参阅 Android Logcat。