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
parent a7ec8aa6a7
commit 35216f75e7
1028 changed files with 835556 additions and 21415 deletions
@@ -0,0 +1,20 @@
+# 构建指南
+
+返回[框架目录](../README.md)。本目录专门说明如何选择子游戏、配置版本、预览和导出 Web 包。
+
+## 推荐阅读顺序
+
+1. [单游戏构建操作](single-game-build.md)：二七王与模板的完整构建步骤、Bundle 勾选、切换游戏、配置复用、产物检查和排错。
+2. [版本配置与身份来源](version-and-build.md)：XML 字段、网页与原生身份、版本包、构建扩展和发布环境限制。
+3. [旧构建目录与脚手架说明](legacy-project-layout.md)：识别旧独立工程流程，避免使用错误的构建命令。
+4. 新接入游戏先完成[子游戏接入指南](../integration/README.md)和[创建房间接入](../integration/create-room.md)。
+
+## 当前构建流程
+
+保存启动场景中的 gameKey → 核对游戏入口、版本 XML 和 Bundle 元数据 → 构建面板仅保留公共包与目标游戏包 → 使用独立输出目录构建 → 检查代码、资源、XML → 通过 HTTP 运行导出网页。
+
+本目录说明的是同一个 YouleNexus 工程内选择一款子游戏。切换现有游戏不修改框架代码、框架资源或引擎源码，也不依赖构建后删除其他游戏目录。
+
+## 当前边界
+
+已支持按 gameKey 动态加载游戏入口与私有 prefab，以及自动输出原生兼容 XML。构建时在 Bundle 列表保留公共 resources、目标游戏和目标版本包；当前还未自动同步 gameKey 与构建勾选项。正式发布环境注入仍待完善。