cneicy
d74c2f08ca
- 将 ShrinkEventBus、ShrinkDataSaver 及其 EventBus 集成从 gitlink 转为仓库直接维护的完整 UPM 包，补齐运行时、编辑器工具、测试与文档 - 新增 Command 和 Network 的 App 集成组件，支持 ContextLoader 服务发布、可逆注销及 Network Loopback 生命周期管理 - 更新 Starter 与演示组合逻辑，缺失模块时可注册、已有兼容安装器时可覆盖，并补充宿主启动断言 - 升级内部包依赖与 Shared CodeGen 包定义，放宽 Integration.App 包的 Git 忽略规则 - 将独立服务器生成器改为基于已编译程序集的语义扫描，支持 partial、复杂泛型、命名冲突检测及模板 SHA-256 覆写保护 - 新增 Network 语义扫描、模板保护和 App 组件生命周期测试 - 新增真实 UPM 消费工程验证脚本，校验内部版本一致性、程序集加载及 EditMode 测试 - 重构当前架构文档并归档已完成的 Cordis 迁移与旧代码地图
77 lines
4.1 KiB
Markdown
77 lines
4.1 KiB
Markdown
# ShrinkContext.AppAdapter
|
||
|
||
ShrinkApp ↔ ShrinkContext 的桥接层：提供当前默认的 ContextLoader 宿主、声明式组合 Profile、诊断工具，并保留 `IShrinkAppModuleInstaller` 兼容适配。当前架构与边界见仓库根 `DESIGN.md`。
|
||
|
||
## 组成
|
||
|
||
| 类型 | 职责 |
|
||
|---|---|
|
||
| `ShrinkAppInstallerComponent` | 安装器 → 组件：`DependsOn` 映射为 `app.module.*` 注入键（依赖缺失**等待**而非抛错）；发布模块键；apply = RegisterServices + InitializeAsync |
|
||
| `ShrinkAppLoaderHost` | 加载器驱动的 ShrinkApp 宿主：发现安装器（注入覆盖可测试）、应用声明式组合、经 `ShrinkContextLoader` 增量协调、运行中按模块开关 |
|
||
| `ShrinkAppCompositionProfile` | ScriptableObject/JSON 组合文档：描述条目启用、显式排除、isolate 与 intercept；组件工厂仍由代码目录注册 |
|
||
| `ShrinkAppLoaderBootstrapper` | `hostingMode == ContextLoader` 时自动创建常驻宿主，应用 `Resources/ShrinkAppComposition`，并把服务容器接回 `ShrinkApp.Services` |
|
||
| `ShrinkContextDiagnosticsWindow` | `ShrinkSDK/Cordis/诊断与组合`：查看运行时 fiber/依赖/事务、编辑 Profile JSON、读取可选的 ModFramework 常驻统计并运行容量基准 |
|
||
|
||
## 启用方式
|
||
|
||
`ShrinkAppSettings.hostingMode` 设为 `ContextLoader`（Inspector 或资产字段）。经典项目默认 `ClassicHost`，行为零变化。
|
||
|
||
```csharp
|
||
// 运行中按模块开关（宿主与其余模块不重启）
|
||
var host = ShrinkAppLoaderBootstrapper.Instance!.Host;
|
||
await host.SetModuleDisabledAsync("shrink.network", true);
|
||
```
|
||
|
||
## 声明式组合
|
||
|
||
默认资源名为 `Assets/Resources/ShrinkAppComposition.asset`。组合根先用代码注册安装器或原生组件工厂，Bootstrapper 再应用 Profile；配置文件不能通过类型名反射实例化任意组件。
|
||
|
||
Profile 的 JSON 结构如下：
|
||
|
||
```json
|
||
{
|
||
"includeUnlistedEntries": false,
|
||
"entries": [
|
||
{
|
||
"id": "shrink.datasaver",
|
||
"enabled": true,
|
||
"isolate": [],
|
||
"intercept": [
|
||
{
|
||
"key": "shrink.service.datasaver",
|
||
"metadata": [
|
||
{ "name": "access", "value": "read-only" }
|
||
]
|
||
}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
- `includeUnlistedEntries = false` 时，没有列出的已注册模块不会进入 loader。
|
||
- `ShrinkAppSettings.disabledModuleIds` 与 Profile 的 `enabled = false` 取并集；Profile 不会偷偷启用 Settings 已禁用的模块。
|
||
- isolate 与 intercept 都在进入 loader 前校验空键和重复键。
|
||
- intercept metadata 当前是字符串键值，由领域访问策略解释，不是任意对象反序列化入口。
|
||
- Profile 可引用一个 JSON `TextAsset` 作为覆盖；诊断窗口也支持 JSON 导入、校验、写回和导出。
|
||
|
||
## 行为差异（对照经典 ShrinkAppHost）
|
||
|
||
| 场景 | ClassicHost | LoaderHost |
|
||
|---|---|---|
|
||
| 依赖缺失 | 排序期抛错 | 安装器保持 Waiting，依赖出现自动激活 |
|
||
| 重复 ModuleId | 宿主级异常 | 构造期抛错（一致）；运行期替换退化为供给冲突失败 |
|
||
| 运行中禁用模块 | 不支持（需重启） | `SetModuleDisabledAsync` 增量协调，重启用会重新执行安装器初始化 |
|
||
| `ShrinkApp.IsRunning` | Host 驱动 | LoaderHost 通过 `SetExternalHostRunning` 同步静态门面状态 |
|
||
|
||
## 已知边界
|
||
|
||
- `ShrinkAppServices.TryUnregister(instance)` 支持按实例撤回服务；原生 Context 组件已使用该路径。旧 installer 包装器仍取决于安装器自身是否提供完整逆操作。
|
||
- config/isolate 变化走条目重建；intercept metadata 可原位更新而不改变 fiber generation。
|
||
- 运行中不支持重新应用整份 Profile；资产修改在下一次宿主启动生效，运行中模块开关仍使用 `SetModuleDisabledAsync`。
|
||
- Editor 基准的毫秒数和 GC 管理堆差值只用于同机前后对比；自动测试只断言索引候选规模和事务恢复结果。
|
||
|
||
## 测试
|
||
|
||
`Tests/` 覆盖安装器生命周期、LoaderHost 开关、原生 Starter 接线、Profile/JSON 校验、显式条目选择、设置禁用优先级，以及 notify/失败恢复结构性基准。
|