# 在 Android 设备上进行调试

> Debug your application on an Android device via a USB or wireless connection.

Unity 支持以下方式在 Android 设备上调试应用程序：

* [USB 调试](#usb-debugging)。
* 通过 [Android Debug Bridge (ADB)](#android-debug-bridge) 实现有线或无线连接。

## USB 调试##usb-debugging

Unity 支持 Android 设备的 USB 调试。要使用 USB 调试，请确保设备已启用开发者选项 (Developer options)。为此，请参阅 Android 的 [Configure Developer options](https://developer.android.com/studio/debug/dev-options) 文档。

使用 USB 线缆将设备连接到开发计算机。如果您在 Windows 系统上开发，可能需要安装设备专用的 USB 驱动程序。相关信息请访问设备制造商的官方网站。

Windows 和 macOS 的设置过程有所不同。有关将 Android 设备连接到 SDK 的更多信息，请参阅 Android 开发者文档的[运行应用程序 (Running Your App)](https://developer.android.com/studio/run/device) 部分。

## Android 调试桥 (ADB)##android-debug-bridge

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

### 通过 USB 连接##connect-via-usb

要使用 USB 通过 ADB 将 Android 设备连接到 Unity：

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

### 无线连接##connect-wirelessly

要通过 ADB 将 Android 设备无线连接到 Unity，请执行以下操作：

1. 在设备上启用无线 ADB。具体操作请参考[使用 Wi-Fi 连接到设备](https://developer.android.com/studio/run/device#wireless)。
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 日志##view-android-logs

在 Android 设备上运行应用程序时，Android 会从脚本中收集堆栈跟踪和[日志](/engine/6000.0/script-reference/unity-engine/debug/log.md)等信息。为了查看这些日志，Android 提供了 [logcat 命令行工具](https://developer.android.com/studio/command-line/logcat)。要将此工具用于 Unity 应用程序，请执行以下操作之一：

* 使用 `logcat` 参数启动 ADB：

  `$ adb logcat`
* 使用 Unity 的 [Android Logcat](https://docs.unity3d.com/Packages/com.unity.mobile.android-logcat@latest/index.html) 插件。该插件实现了 logcat 命令行工具的功能，并在 Unity 的专用窗口中显示应用程序的日志信息。

更多信息，请参阅 [Android Logcat](https://docs.unity3d.com/Packages/com.unity.mobile.android-logcat@latest/index.html)。