Files
youle_cocos/cocoscreator_projects/docs/framework/integration/2026-09-09-subgame-decoupling-plan.md
T
joywayer 35216f75e7 feat: integrate room framework and isolated subgame bundles
Complete room UI and protocol integration, move game definitions and resources behind bundle entries, publish authoritative version XML, and document single-game builds. Include all current resource changes and experiment artifacts.
2026-09-09 03:13:18 +08:00

1.2 KiB

子游戏静态依赖解除实施计划

目标:公共框架与应用启动层不导入具体子游戏。沿用已经通过独立构建与导出网页验证的 Bundle 动态加载能力,不修改引擎或服务器。

  1. 为入口解析补充失败测试,覆盖未知入口、键不匹配、资源越界;新增公共代码不得静态引用 games 的边界检查。
  2. 将游戏定义、聊天和菜单策略放入各自目录。每个游戏通过 GameEntry_<gameKey> 导出定义;公共入口只依赖 SDK 契约。
  3. SubgameAssets 按 gameKey 加载 game-<gameKey>,完成入口解析、私有 prefab 加载后才允许启动平台。版本仍使用各自 version-<gameKey> Bundle,XML 保持唯一身份来源。
  4. 使用编辑器 API 将游戏根目录设为 Bundle,将模板创建房间 prefab 移到模板游戏目录;清除启动场景的私有 prefab 引用,保留公共房间场景。
  5. 更新静态资源检查、测试夹具与接入说明。测试所有既有行为及失败边界;编辑器导入后验证资源引用和真实 Web 构建运行。

边界:本次解除运行时依赖;不更改房间协议、玩法与原生接口。构建选择器的自动化单独围绕现有 gameKey 实现,不引入第二份身份配置。