Microsoft.UI.XAML 项目中启用 PublishSingleFile 导致 ResourceManager.Current 报错的解决方案

问题背景

在使用 Microsoft.UI.XAML 开发 Windows 应用程序时，开发者可能会选择启用 PublishSingleFile 选项来生成单个可执行文件。然而，这一优化措施在某些情况下会导致 Windows.ApplicationModel.Resources.Core.ResourceManager.Current 属性访问时抛出"找不到指定文件"的异常。

问题现象

当项目配置中启用了 PublishSingleFile 选项后，应用程序在运行时访问 ResourceManager.Current 属性时会抛出以下异常：

Unable to find the specified file.
   at WinRT.ExceptionHelpers.<ThrowExceptionForHR>g__Throw|39_0(Int32)
   at WinRT.ExceptionHelpers.ThrowExceptionForHR(Int32)
   at ABI.Windows.ApplicationModel.Resources.Core.IResourceManagerStaticsMethods.get_Current(IObjectReference)
   at Windows.ApplicationModel.Resources.Core.ResourceManager.get_Current()

根本原因

这个问题源于单文件发布模式下，Windows 资源管理器的某些依赖项无法被正确加载。Windows.ApplicationModel.Resources.Core 命名空间下的 ResourceManager 在设计上依赖于特定的文件结构，而单文件发布改变了这种结构，导致资源管理器无法定位必要的资源文件。

解决方案

微软提供了替代方案来解决这个问题。开发者应该使用 Microsoft.Windows.ApplicationModel.Resources 命名空间下的 ResourceManager 类，而不是 Windows.ApplicationModel.Resources.Core 中的版本。

具体修改步骤

1. 在项目中添加对 Microsoft.Windows.ApplicationModel.Resources 的引用
2. 修改代码中的引用：

   // 替换前
   using Windows.ApplicationModel.Resources.Core;
   
   // 替换后
   using Microsoft.Windows.ApplicationModel.Resources;
   

3. 更新代码中的 ResourceManager 使用方式

代码示例

public MainWindow()
{
    try
    {
        // 使用新的 ResourceManager
        var resourceManager = new Microsoft.Windows.ApplicationModel.Resources.ResourceManager();
        // 后续资源访问代码...
    }
    catch(Exception e)
    {
        // 异常处理
    }
}

技术细节

新的 ResourceManager 实现针对现代 Windows 应用程序开发进行了优化，特别是考虑了打包和发布场景。它提供了更好的兼容性，特别是在以下场景：

1. 单文件发布模式
2. 自包含部署
3. 各种打包选项

最佳实践

1. 对于新项目，建议直接使用 Microsoft.Windows.ApplicationModel.Resources 命名空间
2. 迁移现有项目时，应全面测试所有资源访问点
3. 考虑资源加载性能，对于频繁访问的资源可以缓存 ResourceManager 实例

总结

在 Microsoft.UI.XAML 项目中使用单文件发布功能时，开发者应当注意资源管理器的兼容性问题。通过采用 Microsoft.Windows.ApplicationModel.Resources 命名空间下的实现，可以确保应用程序在各种发布模式下都能正确加载和管理资源。这一解决方案不仅解决了当前问题，还为应用程序的未来维护和扩展提供了更好的基础。