从Win11远程部署带WinRT/C++组件的UWP应用至Win10设备异常排查

开发包含WinRT/C++组件的Universal Windows SDK，搭配用于调试的简单UWP应用。开发环境为Windows 11 + Visual Studio 2022：

• 本地调试正常
• 在Windows 11系统的Surface Go 3设备上调试正常
• 将Surface设备降级为Windows 10后，从Win11远程部署时抛出异常：

System.TypeInitializationException: The type initializer for '<My-WinRT-Module' threw an exception. ---> System.IO.FileNotFoundException: The specified module could not be found. (Exception from HRESULT: 0x8007007E)
at System.StubHelpers.StubHelpers.GetWinRTFactoryObject(IntPtr pCPCMD)
at ..ctor()

但以下场景均正常：

• 制作发布包安装到该Win10 Surface设备
• 在Win10 Surface设备上直接安装Visual Studio进行调试

仅从Win11远程部署至Win10设备这一特定场景出问题，怀疑与VS开发工具缺失或.NET SDK版本差异有关。

1. 匹配远程调试工具版本 #

远程部署依赖版本一致的调试工具，Win11上VS2022默认的远程调试工具可能和Win10不兼容：

• 卸载Win10设备上现有远程调试工具，下载对应VS2022版本的Win10兼容版重新安装
• 确保远程调试工具的更新通道和本地VS2022一致（比如都是正式版）

2. 统一.NET SDK与目标版本 #

• 调整UWP项目的目标框架为Windows 10兼容版本（如Windows 10, version 1903），避免使用Win11专属版本
• 在Win10设备上安装与项目目标版本匹配的.NET SDK和运行时，消除版本差异导致的依赖缺失

3. 修复远程部署的文件复制逻辑 #

VS远程部署可能未完整复制WinRT/C++组件的依赖库：

• 在WinRT/C++组件项目属性中，启用部署本地依赖项
• 检查UWP项目引用设置，确保WinRT组件的输出文件及依赖的C++运行时库（如vcruntime、msvcp系列）被设置为“复制到输出目录”
• 可手动将WinRT组件的dll及依赖库复制到Win10设备的应用部署目录，验证是否能正常启动

4. 禁用Win11专属编译特性 #

Win11环境下VS2022可能默认启用了Win11专属编译选项，导致组件无法在Win10加载：

• 在WinRT/C++组件项目属性中，设置平台工具集为v143，同时选择Win10对应的Windows SDK版本（如10.0.19041.0）
• 禁用/ZW:latest这类Win11专属的WinRT编译选项，改用兼容Win10的设置

5. 检查部署权限与路径 #

• 确保远程部署使用的账户拥有Win10设备的管理员权限，避免因权限不足导致依赖库未正确写入
• 排查VS远程部署的目标路径是否存在权限限制，可尝试更换到非系统盘目录部署

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