Zeek.Avalonia.Localization

Zeek.Avalonia.Localization 是 Avalonia 桌面本地化模块，负责 culture 管理、逐 key 父级 fallback、文本格式化、.axaml ResourceDictionary 和动态资源刷新。

适用场景

• 需要在 Avalonia 桌面应用中切换 UI 语言。
• 需要通过 .axaml ResourceDictionary 和 {DynamicResource ...} 刷新文本。
• 可选配合 Zeek.Generators 从扁平 JSON / Resx 生成强类型 key 和 generated texts。

安装 / 引用

<PackageReference Include="Zeek.Avalonia.Localization" />

快速开始

在根模块依赖 AvaloniaLocalizationModule，按正式文档注册语言资源并设置默认 culture。没有 generator 时，手写 .axaml ResourceDictionary 主路径仍必须可用。

AOT / Trim

• AOT 支持等级：Required。
• Trim 策略：显式资源注册或 source generator 增强，不运行时扫描语言资源。
• 反射策略：不以反射发现 JSON、Resx、AXAML 或 resource owner。

Sample

• ../../samples/Zeek.LocalizationSample/
• ../../samples/Zeek.GeneratorsSample/

完整文档

• ../../docs/modules/Zeek.Avalonia.Localization.md

当前限制

• 本模块不负责翻译工作流、在线词条平台、远程语言包或多租户语言配置中心。
• 本模块运行时不解析 JSON / Resx；这些格式只作为 Zeek.Generators 的编译期输入。
• 当前正式名称是 Zeek.Avalonia.Localization，不恢复旧的独立 Zeek.Localization 模块名。