Workspace/Assets/Modules/ShrinkApp.Core/README.md

ShrinkApp.Core

ShrinkApp.Core 是 Shrink 系列模块的统一宿主层。它不直接替代各个基础包的独立使用方式，而是在项目需要“导入一组包后直接起盘”时，提供统一的启动链、模块安装器、服务容器和基础生命周期事件。

当前定位

• 统一宿主：在 BeforeSceneLoad 阶段创建 ShrinkAppHost
• 模块安装器：通过编译期注入的安装器注册表获取 IShrinkAppModuleInstaller
• 服务容器：各模块通过 RegisterServices(...) 暴露门面服务
• 生命周期事件：通过 ShrinkEventBus 发布 ShrinkAppStartedEvent / ShrinkAppStartFailedEvent

核心类型

ShrinkApp
ShrinkAppHost
ShrinkAppSettings
ShrinkAppServices
ShrinkAppContext
IShrinkAppModuleInstaller
[ShrinkAppModuleInstaller]

启动流程

1. ShrinkApp 在 RuntimeInitializeOnLoadMethod(BeforeSceneLoad) 创建宿主。
2. 宿主从编译期注册表 ShrinkAppGeneratedRegistry 读取全部安装器类型。
3. 安装器按 DependsOn + Order 排序。
4. 先执行 RegisterServices(...)，再顺序执行 InitializeAsync(...)。
5. 启动完成后在首场景 Start() 阶段发布 ShrinkAppStartedEvent。
6. 任一安装器重复、依赖缺失、循环依赖、初始化异常都会 fail-fast。