如何检测设备缺失.NET 6 Desktop Runtime并弹窗引导用户下载

将WPF应用从.NET Framework 4.7迁移到.NET 6后，采用直接拷贝输出文件夹的框架依赖模式部署时，若目标设备未安装.NET Desktop Runtime会直接启动失败，不会像.NET Framework那样自动弹出引导窗口。目标提示效果如下：

.NET Framework作为Windows系统深度集成的组件，本身由系统内置了运行时缺失的检测引导逻辑；而.NET 6属于独立迭代的可安装组件，默认生成的原生启动器（apphost）默认关闭了图形化错误提示，缺运行时只会弹出找不到核心动态库的系统报错。以下是可落地的实现方案：

方案1：开启SDK内置引导（最推荐，无额外代码） #

• 适用条件：本地安装的.NET 6 SDK版本 ≥ 6.0.300（目前Visual Studio 2022默认搭载的SDK均满足要求）
• 操作步骤：
  1. 右键WPF项目，选择「编辑项目文件」，打开.csproj配置文件
  2. 在顶层<PropertyGroup>节点内添加如下配置项：

<AppHostWindowsShowErrorDialog>true</AppHostWindowsShowErrorDialog>

3. （可选配置，避免版本兼容问题）如果需要固定引导用户安装对应大版本的最新运行时，可额外添加：

<RollForward>LatestMinor</RollForward>

4. 正常按原有流程编译发布，直接拷贝输出文件夹到目标设备即可

• 实际效果：目标设备缺失对应版本.NET 6 Desktop Runtime时，会直接弹出你截图所示的官方系统提示窗口，用户点击确认即可跳转至对应运行时的下载安装页面，体验和原.NET Framework的引导完全一致。
• 注意：该配置仅对Windows平台生效，完全适配WPF的Windows-only运行场景。

方案2：原生启动器检测（适配低版本SDK） #

如果使用的.NET 6 SDK版本低于6.0.300，没有内置上述配置项，可以自行开发一个不依赖任何.NET环境的原生启动器替代默认生成的exe入口：

• 核心逻辑：
  • 启动器使用编译为原生机器码的语言开发（比如C++ Win32、Rust等，生成的启动文件仅几十KB），不依赖任何系统外运行库
  • 启动时先读取系统注册表，检测是否已安装对应版本的.NET 6 Desktop Runtime：检测路径为HKLM\SOFTWARE\dotnet\Setup\InstalledVersions\[x86/x64]\sharedfx\Microsoft.WindowsDesktop.App，判断是否存在6.x版本的安装记录
  • 若检测到运行时已安装，直接调用dotnet命令启动同目录下的WPF主程序集
  • 若未检测到运行时，弹出和官方样式一致的提示框，用户确认后引导至运行时下载页，也可内嵌运行时静默安装逻辑
• 注意：不要尝试用C#/.NET本身写检测逻辑，设备缺失运行时时.NET程序根本无法加载，检测代码永远不会执行。

不推荐方案说明 #

• 自包含部署：虽然可以把.NET运行时和程序打包在一起，不需要用户单独安装运行时，但WPF自包含单文件部署的输出体积通常在150MB以上，冷启动速度也比框架依赖模式慢30%以上，没有强绿色无依赖需求不建议使用。

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