Files
Workspace/Assets/Modules/ShrinkDataSaver.Integration.App
cneicy d74c2f08ca feat(packages): 内置 SDK 包并完善 ContextLoader 集成
- 将 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 迁移与旧代码地图
2026-08-18 18:06:34 +08:00
..

ShrinkDataSaver.Integration.App

ShrinkDataSaver.Integration.AppShrinkDataSaverShrinkApp.Core 的桥接层。它的职责不是重新实现存档系统,而是把 ShrinkDataSaver 接到统一宿主链里,让项目在接入 ShrinkApp 时由宿主接管初始化顺序。

当前能力

  • 提供原生 ShrinkDataSaverAppComponent,发布 shrink.service.datasaver
  • 在组件激活阶段调用 ShrinkDataSaverRuntime.Initialize()
  • ContextLoader 下向 ShrinkApp.Services 注册可逆的 ShrinkDataSaverService 门面
  • 区分 IShrinkDataSaverReaderIShrinkDataSaverWriter;默认上下文取得完整写能力
  • 支持以 ShrinkDataSaverAccess.MetadataKey = ShrinkDataSaverAccess.ReadOnly 的 intercept 向派生上下文只暴露读取能力,写接口和具体服务请求会被明确拒绝
  • ShrinkDataSaverAppInstaller 仅保留给 ClassicHost 兼容路径,已标记过时
  • 保留 ShrinkDataSaverBootstrap 的旧用法兼容;若宿主已接管,旧 bootstrap 会自动退出

只读上下文

var communityContext = ctx.Intercept(
    ShrinkDataSaverAppComponent.ServiceKey,
    new Dictionary<string, object?>
    {
        [ShrinkDataSaverAccess.MetadataKey] = ShrinkDataSaverAccess.ReadOnly
    });

var reader = communityContext.Get<IShrinkDataSaverReader>(
    ShrinkDataSaverAppComponent.ServiceKey);

这是服务能力的最小化暴露:只约束通过 ShrinkCtx.Get 解析该键的调用方。它不会限制代码绕过上下文后直接访问静态 API,也不构成不可信模组沙箱。