Files
Workspace/Assets/Modules/ShrinkApp.Starter.Basic
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
..

ShrinkApp.Starter.Basic

ShrinkApp.Starter.BasicShrinkApp 的最小起盘 Starter。目标不是提供完整游戏模板,而是让项目在导入最小基础包后,能快速得到一个可运行的入口场景、基础配置和最小示例流程。

ShrinkAppSettings.hostingMode = ContextLoader 时,Starter 组合根会把 Command、DataSaver、Network 三个已发现模块替换为原生 IShrinkComponent,并把兼容用的服务门面作为可逆效应挂回 ShrinkApp.Services。因此 Starter 调试台仍可使用原来的服务 API,同时模块 disable/enable 由 ShrinkContextLoader 增量协调。

当前能力

  • 生成 ShrinkAppSettings.asset
  • 生成或补齐 ShrinkDataSaverSettings.asset
  • 生成 ShrinkAppBasicStarterSettings.asset
  • 生成 ShrinkAppComposition.asset(7 个默认 Cordis 条目;组件工厂仍由代码组合根提供)
  • 生成 Assets/Scenes/ShrinkAppEntry.unity
  • 生成最小示例 UI 与 ShrinkAppBasicSampleController
  • 演示 ShrinkApp + ShrinkDataSaver + Command + Network 的最小闭环

可以单独执行 ShrinkApp/Starter/创建默认 Cordis Composition 创建或修复组合资产,不需要重建场景。

当前示例场景内置的最小入口已经扩成一个小型调试台,包括:

  • Save Slot 0
  • Load Slot 0
  • Run starter status
  • Bind Loopback
  • Disconnect Loopback
  • Refresh Status
  • Clear Output
  • 命令输入框
  • 输出日志区
  • 模块/服务/存档/命令/网络五块只读状态面板

当前五块只读状态面板分别展示:

  • 已启动模块列表
  • 已注册服务类型列表
  • 存档槽位元数据概览
  • 当前已注册命令列表
  • 网络诊断摘要与 session 概览

同时会生成一份 Starter 自己的配置资产,用于控制:

  • 是否在启动时自动绑定 loopback transport
  • 默认命令文本
  • 默认 loopback session id
  • 是否把命令输出打印到控制台
  • 启动时是否自动执行默认命令
  • 命令输出区最多保留多少行