feat(cordis): 接入上下文组合与模组事务热替换

2026-08-16 23:20:40 +08:00
commit ad256f109b
676 changed files with 52168 additions and 0 deletions
@@ -0,0 +1,31 @@
+# ShrinkApp.Core
+
+`ShrinkApp.Core` 是 `Shrink` 系列模块的统一宿主层。它不直接替代各个基础包的独立使用方式，而是在项目需要“导入一组包后直接起盘”时，提供统一的启动链、模块安装器、服务容器和基础生命周期事件。
+
+## 当前定位
+
+- 统一宿主：在 `BeforeSceneLoad` 阶段创建 `ShrinkAppHost`
+- 模块安装器：通过编译期注入的安装器注册表获取 `IShrinkAppModuleInstaller`
+- 服务容器：各模块通过 `RegisterServices(...)` 暴露门面服务
+- 生命周期事件：通过 `ShrinkEventBus` 发布 `ShrinkAppStartedEvent` / `ShrinkAppStartFailedEvent`
+
+## 核心类型
+
+```csharp
+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。