Files
Workspace/Docs/Archive/codebase-map-2026-05-23/INTEGRATIONS.md
T
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

3.3 KiB

外部集成

总览

  • 这个仓库外部依赖不多,主要是 Unity 运行时、Unity 编译管线、文件系统和少量第三方包。
  • 没有发现数据库、网络 API、认证服务、WebHook、云函数等后端集成代码。

Unity 平台能力

  • Assets/Modules/ShrinkEventBus/Runtime/EventAutoRegHelper.cs
    • 使用 RuntimeInitializeOnLoadMethod 参与运行时初始化。
  • Assets/Modules/ShrinkDataSaver/Runtime/ShrinkDataSaverBootstrap.cs
    • 依赖 Application.persistentDataPath
    • 依赖 DontDestroyOnLoad
    • OnApplicationQuitOnApplicationPause 里刷写设置
  • Assets/Modules/ShrinkDataSaver/Runtime/ShrinkDataSaverSettings.cs
    • 使用 Resources.Load
    • 编辑器下回退到 UnityEditor.AssetDatabase

第三方包

  • com.cysharp.unitask
    • 用于异步事件处理与异步文件操作
    • 关键落点:Assets/Modules/ShrinkEventBus/Runtime/EventBus.cs
    • 关键落点:Assets/Modules/ShrinkDataSaver/Runtime/ShrinkSave.cs
    • 关键落点:Assets/Modules/ShrinkDataSaver/Runtime/ShrinkSettings.cs
  • com.unity.nuget.newtonsoft-json
    • 用于 JSON 序列化、JObject 迁移链和弱类型数据缓存
    • 关键落点:Assets/Modules/ShrinkDataSaver/Runtime/DataSerializer.cs
    • 关键落点:Assets/Modules/ShrinkDataSaver/Runtime/MigrationChain.cs
    • 关键落点:Assets/Modules/ShrinkDataSaver/Runtime/SaveTypes.cs

编译管线集成

  • Assets/Modules/ShrinkEventBus/CodeGen/Editor/EventBusILPostProcessor.cs
    • 接入 Unity.CompilationPipeline.Common.ILPostProcessing
    • 使用 Mono.Cecil 改写带 [EventBusSubscriber]MonoBehaviour
  • Assets/Modules/ShrinkEventBus/CodeGen/Editor/PostProcessorAssemblyResolver.cs
  • Assets/Modules/ShrinkEventBus/CodeGen/Editor/PostProcessorReflectionImporter.cs

模块间集成

  • Assets/Modules/ShrinkDataSaver.Integration.EventBus/DataSaverEventBusBridge.cs
    • ShrinkDataSaver 的原生事件桥接到 ShrinkEventBus
    • 桥接方向是单向的:ShrinkDataSaver -> ShrinkEventBus
  • Assets/Modules/ShrinkDataSaver.Integration.EventBus/DataSaverEvents.cs
    • 定义桥接后的 9 个事件类型

本地存储集成

  • Assets/Modules/ShrinkDataSaver/Runtime/IStorageProvider.cs
    • 定义存储抽象
  • Assets/Modules/ShrinkDataSaver/Runtime/LocalStorageProvider.cs
    • 当前唯一实现
    • 使用本地文件系统读写、删除、列举文件
    • 采用 .tmp 文件再替换的方式降低写坏文件的概率

编辑器集成

  • Assets/Modules/ShrinkEventBus/Editor/EventBusViewerWindow.cs
    • 通过 Unity 菜单打开事件查看器
  • Assets/Modules/ShrinkDataSaver/Editor/ShrinkDataSaverEditorWindow.cs
    • 通过 Unity 菜单操作设置与存档

未发现的外部依赖

  • 未发现 HTTP 客户端调用。
  • 未发现数据库连接代码。
  • 未发现 OAuth、Steamworks、Firebase、PlayFab、Addressables 等 SDK 实际接入代码。
  • README 中提到 Steam Cloud 场景,但当前仓库里没有直接调用 Steam API 的实现。

结论

  • 该仓库的“集成”重点不是远程服务,而是 Unity 生命周期、编译后处理、文件系统和模块间桥接。
  • 如果后续要扩展云存档、远程同步或遥测,这里目前只有存储接口和事件桥接两个自然扩展点。