49 lines
3.4 KiB
Markdown
49 lines
3.4 KiB
Markdown
# 本关玩法面板测试包（可整体移除）
|
||
|
||
本目录只包含测试场景、测试面板、预览服务、回归脚本及对应 .meta，不存放正式美术资源。
|
||
|
||
核对日期：2026-09-15。测试面板直接加载正式 GameplayIntro 预制体。正式组件和素材位于 `assets/GameplayIntro`，资源包名 `gameplay_intro`；玩法筛选工具位于公共目录 `assets/Script/module/Tool/LevelGameplay.ts`。当前 HomeScene 没有 HomePropTestPanel 节点，测试目录也没有 HomePropTestPanel.ts。
|
||
|
||
当前 `settings/project.json` 的启动场景是 TestLayout（UUID `8e21ec7e-3913-44ec-8f99-53ff52fe81ed`），相对已合入当前分支的 `origin/main`（`e992a8f`）已发生变更。不需要测试时，先在 Creator 中切回正式启动场景并保存设置，再删除 `assets/test` 和同级 `assets/test.meta`。
|
||
|
||
正式脚本的方法职责、原有 SceneManager.ts 的逐项改动及完整 main 对比清单见 `assets/GameplayIntro/README.md`。
|
||
|
||
## 使用
|
||
|
||
保持当前项目在 Cocos Creator 2.4.15 中打开，在项目根目录执行：
|
||
|
||
```powershell
|
||
node assets/test/tests/preview.cjs
|
||
```
|
||
|
||
打开 `http://127.0.0.1:7460/`。默认读取本项目 settings/project.json 中的编辑器预览端口；7460 是独立预览入口。也可以传入两个参数指定编辑器端口和测试端口。Node.js 需要 18 或以上。Ctrl+C 停止服务。
|
||
|
||
也可以在 Creator 中打开 `assets/test/scene/TestLayout.fire`，选择预览当前场景。
|
||
|
||
测试面板读取本地 `custom/Json/levelN`，支持右上角问号打开、点击面板外空白关闭、关卡输入、前后翻页、边界回弹、白点替换动画。预设第 1/7/44/511 关分别覆盖无道具、1/2/5 页；没有特殊道具时隐藏问号。只读本地关卡，不修改游戏进度，线上关卡更新后可能与本地样本不同。
|
||
|
||
## 回归测试
|
||
|
||
```powershell
|
||
node assets/test/tests/guide-carousel.cjs
|
||
```
|
||
|
||
覆盖本关类型筛选、变体匹配、生成队列、去重、零/单/双/多页、分页高亮、滑动回弹、相邻三页内存控制、过期加载回收、关闭重开及素材映射；同时用正式场景节点验证问号显隐、实际关卡输入、加载暂停和关闭恢复。
|
||
|
||
编译器默认从 `C:/ProgramData/cocos/editors/Creator/2.4.15` 读取；其他目录可通过 `COCOS_EDITOR_HOME` 指定。
|
||
|
||
## 残留的 HomeScene 道具测试
|
||
|
||
`tests/home-prop-panel.cjs` 仍保留，但它读取的 `script/HomePropTestPanel.ts` 已不存在，HomeScene 中对应节点也已不存在。因此当前没有该测试入口，这个脚本不能作为可运行的测试命令使用。本次仅更新文档，未删除残留测试文件。
|
||
|
||
## 测试脚本职责
|
||
|
||
| 脚本 | 作用 |
|
||
| --- | --- |
|
||
| `script/TestLayoutPanel.ts` | 创建测试控件，读取指定本地关卡并筛选介绍；支持全部玩法、问号重开和首尾/前后跳页，不修改玩家进度 |
|
||
| `tests/guide-carousel.cjs` | 在模拟 Cocos 环境中验证正式逻辑；不等同于真机视觉及性能验证 |
|
||
| `tests/preview.cjs` | 加载 Creator TypeScript 编译器，编译测试所需脚本，并通过本地服务读取编辑器预览引擎和资源 |
|
||
| `tests/home-prop-panel.cjs` | 已失去依赖的残留测试，当前不可正常运行 |
|
||
|
||
2026-09-15 合入 main（`e992a8f`）后，已执行 `node assets/test/tests/guide-carousel.cjs`，全部回归项通过。本次未启动预览服务或进行真机验证。
|