Uno.Sdk 升级后 Windows 平台出现 PRI 资源重复错误解析

问题背景

在使用 Uno 平台进行跨平台应用开发时，开发者将项目从 Uno.Sdk 5.5.56 版本升级到 5.6.20 版本后，在 Windows 平台构建时遇到了 PRI (Package Resource Index) 资源处理错误。错误信息显示存在重复的资源条目，特别是与 Uno.Toolkit.WinUI 相关的 mergedpages.WinUI.xbf 文件冲突。

错误现象

升级后，开发者观察到以下构建错误：

PRI175: 0x80073b0f - Processing Resources failed with error: Duplicate Entry
PRI277: 0x80073b0f - Conflicting values for resource 'Files/Uno.Toolkit.WinUI/Generated/mergedpages.WinUI.xbf'

值得注意的是，这个问题仅出现在 Windows 平台，而 WASM 和 Android 平台构建正常。

问题根源

经过技术专家分析，这个问题通常由以下情况引起：

1. 多项目解决方案中的版本冲突：当解决方案中包含多个项目，且这些项目引用了不同版本的 Uno 相关包时，可能导致资源生成冲突。

2. UnoFeatures 配置不一致：特别是当主项目和其他辅助项目（如本例中的 .Data.csproj 和 .Charts.csproj）在 UnoFeatures 配置上存在差异时，容易引发此类问题。

3. WinAppSDK 的资源处理机制：Windows 应用 SDK 在构建时对资源文件有严格的一致性要求，当检测到同一资源有多个不同版本时，会抛出重复条目错误。

解决方案

针对这个问题，开发者可以采取以下解决步骤：

1. 统一 UnoFeatures 配置：

   • 检查解决方案中的所有项目文件(.csproj)
   • 确保所有项目都包含一致的 <UnoFeatures> 配置
   • 特别确认是否包含 Toolkit 特性

2. 版本一致性检查：

   • 使用 MSBuild 诊断级别日志分析包引用
   • 确保所有项目引用相同版本的 Uno 相关包

3. 构建日志分析：

   • 使用 msbuild /bl 生成详细的二进制日志
   • 设置日志级别为诊断级别以获取更详细的信息

最佳实践建议

1. 跨项目配置同步：当解决方案包含多个相互依赖的项目时，建议创建统一的 Directory.Build.props 文件来集中管理公共配置。

2. 分步升级策略：进行 Uno.Sdk 大版本升级时，建议先升级测试项目验证兼容性，再逐步升级主项目。

3. 资源管理规范：对于跨平台项目，应建立明确的资源命名规范，避免不同平台间的资源文件命名冲突。

总结

此次问题的核心在于多项目环境下的配置不一致性，特别是 UnoFeatures 中 Toolkit 配置的缺失导致了 Windows 平台资源构建时的冲突。通过统一各项目的配置，特别是确保 UnoFeatures 中包含必要的 Toolkit 声明，可以有效解决此类 PRI 资源重复错误。这也提醒开发者在进行跨平台开发时，需要特别注意各子项目间配置的一致性，以避免类似的平台特定构建问题。