WinUI3 C#应用MSIXBundle兼容问题：TargetFramework22621无法适配19041

问题原因 #

你遇到的安装错误核心是MSIX包的AppxManifest清单中，TargetDeviceFamily的MinVersion被错误设置为10.0.22621.0，而非你指定的19041.0。这通常由两个原因导致：

• 打包工具版本与TargetFramework版本不匹配
• 项目文件中最低版本配置未正确同步到清单

具体解决步骤 #

1. 修正项目文件（.csproj）配置 #

确保项目文件中同时明确设置以下属性，保证编译和打包阶段的版本一致性：

<TargetFramework>net6.0-windows10.0.22621.0</TargetFramework>
<!-- 指定最低支持的OS版本 -->
<SupportedOSPlatformVersion>10.0.19041.0</SupportedOSPlatformVersion>
<!-- WinUI3项目需额外设置此属性，确保清单生成正确的最低版本 -->
<TargetPlatformMinVersion>10.0.19041.0</TargetPlatformMinVersion>
<!-- 可选：指定测试过的最高版本 -->
<TargetPlatformMaxVersionTested>10.0.22621.0</TargetPlatformMaxVersionTested>

2. 使用匹配TargetFramework的Windows SDK打包 #

你当前使用的是10.0.19041.0版本的makeappx.exe，但TargetFramework是22621，版本不匹配会导致工具无法正确解析最低版本配置。需改为使用10.0.22621.0版本的Windows SDK中的makeappx.exe来打包，修改Azure DevOps Pipeline中的脚本路径：

"C:\Program Files (x86)\Windows Kits\10\bin\10.0.22621.0\x64\makeappx.exe" bundle /d $(Build.ArtifactStagingDirectory)\ /p "$(Build.ArtifactStagingDirectory)$(applicationName).msixbundle"

3. 验证AppxManifest配置 #

打包后，解压MSIX包检查AppxManifest.xml的Dependencies节点，确认TargetDeviceFamily的MinVersion正确：

<Dependencies>
  <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.19041.0" MaxVersionTested="10.0.22621.0" />
</Dependencies>

如果这里的MinVersion仍是22621，需清理项目后重新编译打包。

关于SupportedOSPlatformVersion的意义 #

这个属性的作用是编译阶段的API兼容性检查：它会限制你只能调用Windows 10.0.19041.0及以上版本提供的API，避免编译时引入低版本系统不支持的接口。但它本身不会直接控制MSIX包的安装最低版本——安装最低版本由AppxManifest中的TargetDeviceFamily.MinVersion决定，两者需要通过正确的项目配置保持同步，否则就会出现“编译允许低版本，但安装要求高版本”的矛盾。

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