返回

.NET MAUI Android真机调试：ADB Device Not Found解决

IOS

.NET MAUI Android 应用无法安装或调试到真机：ADB Device Not Found 错误排查与解决

调试 .NET MAUI Android 应用时，无法安装到真机，总是遇到 "device 'RFCWA0E38TK' not found" 的错误，这确实让人头疼。 别着急，本文会一步步分析这个问题的原因，并提供一系列实用的解决方案。

一、问题

尝试将 .NET MAUI Android 应用程序部署到真机进行调试时，安装包无法成功安装。 开发环境持续报以下错误：

  1>com.package.appname.apks: Error BT0000 : ...
10:10:15 E/377791216: device 'RFCWA0E38TK' not found
com.android.ddmlib.AdbCommandRejectedException: device 'RFCWA0E38TK' not found
 ...
[BT:1.15.1] Error: Installation of the app failed.
com.android.tools.build.bundletool.model.exceptions.CommandExecutionException
 Installation of the app failed.
...
Caused by: com.android.ddmlib.InstallException: device 'RFCWA0E38TK' not found
...
Caused by: com.android.ddmlib.AdbCommandRejectedException: device 'RFCWA0E38TK' not found
 ...

尽管已经尝试了多种方法，包括确认 USB 调试已开启、重启 ADB 服务、重置设备等，问题在特定设备（如Huawei P30 Lite）上仍然存在，偶尔会在恢复出厂设置后成功一次，但随后问题会再次出现。

二、问题原因分析

这个错误的核心信息是 "device 'RFCWA0E38TK' not found"，表明 ADB（Android Debug Bridge）无法找到指定的设备。尽管 adb devices 命令可能显示设备已连接，但更深层次的通信可能存在问题。

问题可能出在以下几个方面：

  1. ADB 驱动问题: 电脑上的 ADB 驱动可能过时、损坏，或者与特定设备不兼容。

  2. USB 连接问题: USB 线缆、端口或手机的 USB 接口可能存在问题，导致连接不稳定。

  3. 设备驱动问题： 设备可能缺少特定的驱动文件，特别是在某些厂商（如 Huawei）的设备上。这些驱动文件可能是 ADB 所需的，即使 adb devices 显示了设备。

  4. 设备系统/固件冲突： 特定设备的系统或固件可能与 ADB 或 .NET MAUI 的构建工具有冲突。

  5. ADB 版本不兼容: 开发环境中使用的 ADB 版本与设备所需的 ADB 版本不兼容。

  6. 安全软件干扰: 电脑上的某些安全软件（例如杀毒软件）可能会干扰 ADB 的正常运行。

  7. USB 调试授权问题: 即使已启用 USB 调试，设备可能未正确授权给当前的电脑。

  8. .NET MAUI 项目配置问题 : MAUI项目文件中的设置错误或缺失可能造成此问题

三、解决方案

针对上述可能的原因，逐一排查，下面提供详尽的解决步骤。

1. 基础排查和操作

  • 确认 USB 调试已启用： 在手机的“开发者选项”中，确保“USB 调试”已开启。不同的设备开启方式可能略有不同。

  • 切换 USB 端口： 尝试使用电脑上不同的 USB 端口（最好是 USB 2.0 端口），并确保端口工作正常。

  • 更换 USB 数据线： 使用高质量的 USB 数据线，确保线缆没有损坏，并且支持数据传输。

  • 重新插拔设备： 断开设备与电脑的连接，然后重新连接。

  • 重启设备和电脑： 这是最简单但有时最有效的解决办法。

2. ADB 相关操作

  • 重启 ADB 服务:

    在命令行中输入以下命令：

    adb kill-server
adb start-server

    这两个命令可以关闭并重启ADB服务，重置其状态。

  • 检查 ADB 版本：

    adb version

    确认当前版本与所需的兼容，如有更新最好同步到最新版本。

  • 显式指定设备进行安装（如果 adb devices 显示多个设备）:

如果 `adb devices` 列出了多个设备或模拟器，你需要指定要安装到的设备。使用 `-s` 参数后跟设备的序列号来执行安装命令:

```bash
adb -s RFCWA0E38TK install -r <path_to_your_apk>
```
请将 `RFCWA0E38TK` 替换为你设备的实际序列号, `<path_to_your_apk>` 替换为你的 APK 文件路径。`-r` 参数表示重新安装。

3. 驱动程序排查

  • 更新或重新安装 ADB 驱动:

    • 自动安装： 大部分情况下，当连接设备并开启 USB 调试后，系统会自动安装 ADB 驱动。

    • 手动安装： 如果自动安装失败，可以尝试手动安装。

      1. 下载 Android SDK Platform-Tools：

      https://developer.android.com/studio/releases/platform-tools

      1. 下载完成后，解压到任意位置。
      2. 使用adb 命令时可以输入完整路径或设置系统路径变量后使用。

      • 华为设备特别注意：

        1. 安装华为手机助手（HiSuite）：华为手机助手通常会包含必要的驱动程序。从华为官网下载并安装。

        https://consumer.huawei.com/en/support/hisuite/
        (可能需要切换到对应的国家/地区站点)。

        1. 安装后，连接手机，并按照 HiSuite 的提示进行操作。

    • (macOS 特别说明) 安装 Android File Transfer:

      macOS 用户需要安装 Android File Transfer 才能在 Finder 中访问 Android 设备的文件。 某些情况下，它也可以帮助解决连接问题。

      https://www.android.com/filetransfer/

4. 设备授权和权限

  • 撤销 USB 调试授权：

    1. 在手机的“开发者选项”中，找到“撤销 USB 调试授权”并点击。
    2. 重新连接手机，并在手机上弹出的对话框中选择“允许”此电脑进行 USB 调试。
    3. 确保选中“始终允许使用这台计算机进行调试”。

  • ADB密钥(macOS 特别说明):

    在较新版本的 Android 中，ADB 使用密钥进行身份验证。有时，本地密钥可能会损坏或出现冲突。可以尝试删除 ~/.android/ 目录下的 adbkey 和 adbkey.pub 文件(删除前可以备份) ，然后重启 ADB 服务:

       rm ~/.android/adbkey
   rm ~/.android/adbkey.pub
   adb kill-server
   adb start-server

5. 项目配置核查(.NET MAUI)

  • 检查 AndroidManifest.xml
检查`AndroidManifest.xml`文件中`<application>`标签下的`android:debuggable`是否为`true`

```xml
    <application android:allowBackup="true" android:icon="@mipmap/appicon" android:roundIcon="@mipmap/appicon_round" android:supportsRtl="true" android:debuggable="true">
    </application>

```

  • ** 清理和重建项目：**

    在 Rider 中, 选择 "Build" -> "Clean Solution"， 然后选择 "Build" -> "Rebuild Solution"。

6.进阶排查

  • 使用特定版本的 Platform-Tools:
    如果问题出现在使用某个特定版本的Android SDK Build-Tools时, 可考虑更换不同的Platform-Tools版本, 来确认是否因为版本造成.

  • 检查环境变量 PATH（高级）：

    • 确保你的 PATH 环境变量中包含了 Android SDK 的 platform-tools 目录。

    • macOS:
      编辑你的 shell 配置文件（如 ~/.bash_profile, ~/.zshrc），添加以下行 (将 <path_to_sdk> 替换为你的 Android SDK 实际路径）：

      ```bash
export ANDROID_HOME=<path_to_sdk>
export PATH=$PATH:$ANDROID_HOME/platform-tools
```
保存文件后，运行 `source ~/.bash_profile` (或 `source ~/.zshrc`) 使更改生效。

    • 确认是否有多个ADB：
      系统中可能存在多个ADB 实例. 通过 which adb(macOS/Linux) 或 where adb (Windows) 确定 ADB 路径。如果存在多个路径, 请考虑卸载/删除不需要的ADB实例. 优先使用 Android SDK Platform Tools 中的ADB.

  • ADB over Wi-Fi (无线调试):

    如果USB连接持续有问题, 也可以使用无线进行调试:

    1. 手机和电脑连接到同一Wi-Fi 网络。
    2. 使用 USB 将手机连接到电脑， 确保 USB 调试已开启。
    3. 在命令行运行:
    adb tcpip 5555
    1. 断开USB连接。
    2. 在手机的“设置” -> “关于手机” -> “状态信息”中找到手机的 IP 地址。
    3. 在命令行输入:
    adb connect <手机的IP地址>:5555

    7. 现在可以通过无线方式调试了。如果连接失败, 尝试再次输入此命令。

    (每次重启设备都需要重新设置端口并连接).

7. 系统及安全软件

  • 暂时禁用安全软件：
    • 暂时禁用你的杀毒软件、防火墙或其他安全软件，然后再次尝试部署。 如果成功，则说明是安全软件导致的问题。将ADB相关程序添加到信任列表中通常可以解决问题.
  • 尝试纯净启动(高级,适用于复杂软件环境排查):
    如果怀疑有软件冲突, 可以创建一个新的系统用户账户，并在新用户下进行测试. 避免当前用户已安装软件产生的影响。

如果按照上述步骤操作后仍然无法解决问题，那很可能是遇到了特定于设备型号和系统版本的罕见问题。 这种情况下，可以考虑尝试：

  • 查找是否有针对你手机型号的特定 ADB 驱动。
  • 搜索与你手机型号和 .NET MAUI 相关的已知问题。
  • 向 .NET MAUI 社区 或 华为官方论坛 寻求进一步的帮助，并提供详细的错误信息、设备型号、系统版本以及已经尝试过的所有步骤。