Roslyn分析器中ResxSourceGenerator的公共资源生成功能解析

背景介绍

在.NET开发中，资源文件(.resx)是管理本地化字符串、图标和其他资源的常用方式。传统的Visual Studio工具链提供了PublicResXFileCodeGenerator工具，用于从.resx文件生成公共访问修饰符的资源类。随着Roslyn分析器和源代码生成器的兴起，微软推出了Microsoft.CodeAnalysis.ResxSourceGenerator作为更现代化的替代方案。

功能发现

许多开发者在使用Microsoft.CodeAnalysis.ResxSourceGenerator时遇到了一个常见问题：如何生成具有public访问级别的资源属性？这个问题最初被认为是一个缺失的功能，但经过深入研究发现，该功能实际上已经存在，只是需要通过特定的配置来启用。

解决方案详解

要使用ResxSourceGenerator生成公共资源属性，开发者需要在项目文件中为EmbeddedResource项添加Public="true"属性。具体配置如下：

<ItemGroup>
    <EmbeddedResource Update="Resource1.resx" Public="true" />
</ItemGroup>

这个简单的配置变更会指示源代码生成器为资源文件生成public而非internal的访问修饰符，使得资源可以在项目外部被访问。

技术实现分析

ResxSourceGenerator作为Roslyn源代码生成器，会在编译过程中直接分析项目中的.resx文件，并生成对应的C#代码。当检测到Public="true"属性时，生成器会调整输出代码的访问级别。这种设计遵循了现代.NET开发中的"约定优于配置"原则，同时保持了向后兼容性。

使用建议

对于需要跨程序集共享资源的项目，建议：

1. 明确标记需要公开的资源文件
2. 在项目文档中记录这一配置
3. 考虑资源公开带来的API契约影响

文档现状

目前ResxSourceGenerator的官方文档较为缺乏，开发者往往需要通过实验或查看源代码来了解其完整功能集。这也是许多高级功能如公共资源生成不被广泛知晓的原因之一。

总结

Microsoft.CodeAnalysis.ResxSourceGenerator作为新一代资源代码生成工具，已经内置了对公共资源生成的支持。开发者只需通过简单的项目文件配置即可启用这一功能，无需依赖传统的PublicResXFileCodeGenerator。这一发现解决了资源跨程序集共享的问题，展示了Roslyn源代码生成器的灵活性和强大功能。