e8d3a6203148f2751723b6a30bfecbf041b9afd7
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,行为零变化。
// 运行中按模块开关(宿主与其余模块不重启)
var host = ShrinkAppLoaderBootstrapper.Instance!.Host;
await host.SetModuleDisabledAsync("shrink.network", true);
声明式组合
默认资源名为 Assets/Resources/ShrinkAppComposition.asset。组合根先用代码注册安装器或原生组件工厂,Bootstrapper 再应用 Profile;配置文件不能通过类型名反射实例化任意组件。
Profile 的 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/失败恢复结构性基准。
Languages
C#
100%