VS调试Xamarin Android应用提示NDK注册表缺失如何解决

问题说明 #

每次启动调试器搭配模拟器运行Xamarin Android项目时都会弹出错误，即便已在Visual Studio安装程序中确认开启多设备C++开发支持，问题仍存在，原始报错信息如下：

Unable to start debugging.
A required Visual Studio registry value could not be found.
Ensure that support for multi-device C++ development is enabled in Visual Studio setup.

Registry key: Software\Microsoft\VisualStudio\17.0_e34a64fc\Setup\VS\SecondaryInstaller\AndroidNDK
Value name: NDK_HOME

报错中文翻译：

无法启动调试
未找到必需的Visual Studio注册表值
请确认已在Visual Studio安装程序中启用多设备C++开发支持

关联注册表路径：Software\Microsoft\VisualStudio\17.0_e34a64fc\Setup\VS\SecondaryInstaller\AndroidNDK
缺失值名称：NDK_HOME

解决步骤 #

• 先确认本机Android NDK的实际安装路径
  打开Visual Studio，依次进入「工具>选项>Xamarin>Android设置」，找到页面中显示的NDK存放路径并复制。如果此处路径为空，直接定位到VS安装目录下的Xamarin NDK默认路径即可，社区版默认路径为C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Xamarin\Android\NDK，使用专业版/企业版的话把路径里的Community替换成对应版本名即可。
• 手动补全缺失的注册表配置
  1. 按Win+R组合键，输入regedit回车打开注册表编辑器
  2. 定位到路径HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\17.0_e34a64fc\Setup\VS\SecondaryInstaller\
  3. 在SecondaryInstaller项上右键，新建名为AndroidNDK的项
  4. 选中刚建好的AndroidNDK项，在右侧空白区域右键，新建字符串值，名称填NDK_HOME，数值数据粘贴之前复制的NDK实际安装路径
• 验证修复结果
  关闭注册表编辑器，完全退出Visual Studio后重新打开，再启动调试运行Xamarin Android项目，确认报错是否消除。
• 兜底修复方案
  如果手动修改注册表后仍报错，打开Visual Studio Installer，找到对应版本的Visual Studio点击「修改」，在「单个组件」分类下搜索Android NDK，取消勾选已安装的NDK组件，点击「修改」完成卸载；卸载完成后再次进入安装界面，重新勾选对应版本的Android NDK组件完成重装，重启电脑后再验证即可。

内容的提问来源于stack exchange，提问作者MegaPiggy