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 迁移与旧代码地图
76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
# 外部集成
|
|
|
|
## 总览
|
|
|
|
- 这个仓库外部依赖不多，主要是 Unity 运行时、Unity 编译管线、文件系统和少量第三方包。
|
|
- 没有发现数据库、网络 API、认证服务、WebHook、云函数等后端集成代码。
|
|
|
|
## Unity 平台能力
|
|
|
|
- `Assets/Modules/ShrinkEventBus/Runtime/EventAutoRegHelper.cs`
|
|
- 使用 `RuntimeInitializeOnLoadMethod` 参与运行时初始化。
|
|
- `Assets/Modules/ShrinkDataSaver/Runtime/ShrinkDataSaverBootstrap.cs`
|
|
- 依赖 `Application.persistentDataPath`
|
|
- 依赖 `DontDestroyOnLoad`
|
|
- 在 `OnApplicationQuit` 和 `OnApplicationPause` 里刷写设置
|
|
- `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 生命周期、编译后处理、文件系统和模块间桥接。
|
|
- 如果后续要扩展云存档、远程同步或遥测，这里目前只有存储接口和事件桥接两个自然扩展点。
|