Visual Studio 2022运行Xamarin项目报错无法检测ADB二进制文件如何解决

报错成因 #

• 安卓模拟器的ADB路径配置与Visual Studio默认安装的Android SDK路径不匹配，模拟器默认扫描系统环境变量中的ADB路径失败时就会触发该报错
• Xamarin的Android SDK路径配置未同步到安卓模拟器全局设置，两边路径不一致导致检测失效
• 系统环境变量中未添加adb.exe所在的platform-tools目录，模拟器全局扫描时无法定位到对应二进制文件

Extended Controls 入口位置 #

该配置入口位于正在运行的安卓模拟器窗口中，而非Visual Studio的菜单内，查找步骤如下：

1. 启动你的Pixel 5 - API 30模拟器，等待模拟器完全加载进入安卓系统桌面
2. 查看模拟器窗口的右侧侧边栏，最底部的三个点...按钮就是Extended Controls入口，点击即可打开配置面板
3. 进入配置面板后，左侧导航栏选择Settings，再切换到General标签页即可找到ADB相关配置项

完整解决步骤 #

• 第一步：确认VS侧的ADB实际路径
  打开Visual Studio Community 2022，依次进入Tools > Options > Xamarin > Android Settings，复制Android SDK Location的路径，在资源管理器中打开该路径，进入下一级platform-tools目录，确认该目录下存在adb.exe，记录该platform-tools目录的完整路径。
• 第二步：配置模拟器ADB路径
  打开上述Extended Controls配置面板，在Settings > General标签页下，找到Use detected ADB location选项：
  • 若自动检测的路径和你刚才确认的platform-tools路径一致，直接勾选该选项，点击面板底部的Apply保存即可
  • 若自动检测的路径不匹配，取消勾选该选项，在下方自定义输入框中填入你记录的platform-tools完整路径，点击Apply保存
• 第三步：验证修复效果
  关闭模拟器和Visual Studio后重新启动，再次运行Xamarin项目，报错即可消失。如果仍有报错，可以将记录的platform-tools完整路径添加到系统Path环境变量中，重启设备后再尝试。

内容的提问来源于stack exchange，提问作者Ola Ström