生成应用的模块生命周期

September 12, 2026 · View on GitHub

English | 简体中文

两种官方架构在能力所属应用工程中提供相同的两阶段生命周期：

  1. ConfigureServices(IServiceCollection)：服务提供器构建前执行。
  2. InitializeAsync(IServiceProvider, CancellationToken)：服务提供器已存在、应用尚未接收工作时执行。

纯 WinUI 在显示第一个窗口前完成初始化。混合架构在 WPF 后台宿主中完成初始化后，才启动命名管道 gRPC 服务。

混合后台模块目录还支持 IXamlNexusGrpcModule，其绑定在核心服务之后、管道服务启动前添加。WinUI 前端也有自己的模块目录，负责客户端服务注册与初始化。

Recipe 模块在宿主的 Modules 命名空间实现 IXamlNexusModule，通过模块初始化器注册工厂：

[ModuleInitializer]
internal static void Register() =>
    XamlNexusModuleCatalog.Register(static () => new MyModule());

显式工厂引用兼容生成项目的裁剪设置，避免运行时扫描程序集。模块按类型全名排序实例化和执行，启动顺序是确定的。初始化异常中止启动，不允许 UI 或 IPC 在部分初始化状态下接收工作。

内置 SQLite Recipe 使用这一流程注册上下文工厂，并在数据库工作可达前完成迁移。

在页面中使用模块服务

新前端模板通过 AppObjectFactory 创建导航页面；page add 也用它创建页面持有的 ViewModel。构造参数来自现有应用服务提供器，Page 或 ViewModel 自身无需注册。无参类型仍可使用；缺少构造依赖时明确失败。

工厂始终创建由调用方持有的新对象，不创建每页 DI scope，也不自动释放业务对象。KeepAlive 继续控制页面复用；持有资源的 ViewModel 需要在页面生命周期中显式清理。页面不能释放容器拥有的共享服务。数据库操作使用上下文工厂或显式操作 scope。SQLite 注入示例见页面开发。