WindowsAppSDK 1.5 与 .NET 8 下 WinUI 3 类库编译问题的深度解析

问题背景

在使用 WindowsAppSDK 1.5 和 .NET 8 开发 WinUI 3 类库时，开发者可能会遇到一个特定的编译问题。当项目文件中使用单数形式的 <RuntimeIdentifier> 标签时，会出现一系列关于运行时标识符不被识别的错误。这个问题在 .NET 7 环境下不会出现，且在使用复数形式的 <RuntimeIdentifiers> 标签时也能正常编译。

问题表现

当项目配置如下时会出现编译错误：

<PropertyGroup>
    <Platforms>x64</Platforms>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <TargetFramework>net8.0-windows10.0.22000.0</TargetFramework>
    <UseWinUI>true</UseWinUI>
</PropertyGroup>

错误信息会显示多个 win10 开头的运行时标识符不被识别，包括：

• win10-arm
• win10-arm-aot
• win10-arm64-aot
• win10-x86
• win10-x86-aot
• win10-x64
• win10-x64-aot

解决方案

有两种可行的解决方案：

1. 使用复数形式的 RuntimeIdentifiers：

<RuntimeIdentifiers>win-x64</RuntimeIdentifiers>

2. 降级到 .NET 7：

<TargetFramework>net7.0-windows10.0.22000.0</TargetFramework>

技术分析

这个问题的本质在于 .NET 8 和 WindowsAppSDK 1.5 对运行时标识符处理方式的改变。在 .NET 8 中，单数形式的 <RuntimeIdentifier> 和复数形式的 <RuntimeIdentifiers> 有着显著不同的处理逻辑：

1. 单数形式：被视为精确匹配要求，会触发对所有可能运行时标识符的严格验证
2. 复数形式：被视为兼容性列表，允许更灵活的处理方式

WindowsAppSDK 1.5 在 .NET 8 环境下默认会尝试验证一系列 win10 开头的传统运行时标识符，而这些标识符在 .NET 8 的新 RID 图中已被弃用，改用 win 开头的更通用的标识符。

最佳实践建议

1. 对于新项目，建议统一使用复数形式的 <RuntimeIdentifiers>，即使只需要指定一个平台
2. 保持项目文件中平台标识符的一致性，全部使用 win 开头的新式标识符
3. 对于需要特定平台（如 x64）的项目，明确指定 <Platforms> 和 <RuntimeIdentifiers>
4. 在类库项目中特别注意此问题，因为应用程序项目可能表现不同

总结

这个问题揭示了 .NET 8 运行时标识符处理机制的变化以及与 WindowsAppSDK 的交互方式。理解单数和复数形式运行时标识符的区别对于解决类似编译问题至关重要。开发者应当根据项目需求选择合适的标识符形式，并在跨平台开发中特别注意这些细节差异。