Zeek.Generators

Zeek.Generators 是 ZeekFramework 的编译期增强模块，用于减少模块依赖、Settings、服务约定、Navigation 和 Localization 等显式注册样板代码。

适用场景

• 希望用 attribute 或约定减少机械注册代码。
• 需要在编译期暴露模块依赖、settings、服务注册或资源接线错误。
• 需要 AOT 友好的 generated glue，但仍保留手写显式注册路径。

安装 / 引用

<PackageReference Include="Zeek.Generators" />

真实用户项目通常只引用 Zeek.Generators，不需要单独引用 Zeek.Generators.Abstractions。

类库如果不希望 analyzer 继续传递给下游项目，可以在自己的 PackageReference 上设置 PrivateAssets="all"。普通应用无需增加该设置。

快速开始

按正式文档在模块、settings、服务或资源上使用对应 attribute。生成代码必须与手写注册等价；没有 generator 时，应用仍应能通过手写注册运行。

AOT / Trim

• AOT 支持等级：Required。
• Trim 策略：编译期生成显式 glue，不承担运行时发现。
• 反射策略：generator 在编译期分析符号；运行时不依赖 generator 程序集。

Samples

• Zeek.GeneratorsSample
• Zeek.GeneratorsSample.FeatureModule

完整文档

• Zeek.Generators 正式模块文档

当前限制

• 本模块不是运行时必要条件，不承担运行时读取、写入、加密、生命周期或 DI scope 管理。
• 本模块不生成用户业务模型的 JsonSerializerContext 本体，只接线用户显式声明的 context。