29 lines
3.0 KiB
Markdown
29 lines
3.0 KiB
Markdown
# Fruit Pop 加载界面
|
||
|
||
## 范围
|
||
|
||
- 在 Welcome 场景 Canvas 下添加独立 PreparationPanel,复用已有背景、Logo、水果节点。
|
||
- 按 1080×1920 loading 参考图安排标题、百分比、进度槽及 Getting things ready;所有节点在编辑器中独立可修改,运行时不创建 UI。
|
||
- 新切图通过资源工具导入到 assets/startup/visuals,命名 prep-meter-frame.png、prep-meter-fill.png。原始美术未修改,参考整图未作为运行背景导入。
|
||
- 进度填充采用左锚点与九宫格,左右边距各 48 像素,满格宽度按槽内边界限制为 906,保留圆头和高光;原图上的 70% 只是编辑器展示样例。
|
||
|
||
## 职责与流程
|
||
|
||
- GuestLoginView 继续管理按钮绑定和认证生命周期,通过 guest-login-state-changed 发布无会话内容的展示状态。
|
||
- StartupProgress 是独立于引擎的进度状态机。等待期间只估算到 90%,不会自行完成;认证成功后用 0.24 秒平滑收满,并显示 100% 至少约 0.12 秒。
|
||
- StartupLoadingView 绑定已保存的场景节点,隐藏按钮和页脚,不禁用拥有认证请求的 WelcomeComposition。失败恢复原控件并展示最新错误,可再次点击登录。
|
||
- 成功提示在 loading 收尾期间保持隐藏,结束后恢复。组件临时禁用保留待收尾状态,再启用后继续,不重复发送完成通知。
|
||
- 当前没有主场景,完成后返回现有认证成功落点,并发送不含 token 的 startup-preparation-ready。后续接游戏场景时,需要让完成条件等待场景加载及首屏实际就绪;当前没有假装预加载不存在的资源。
|
||
- 只参考 crimson-lantern 的职责分离、加载上限和真实完成原则,未复制其实现,也未引入原生更新工作流。
|
||
|
||
## 验证
|
||
|
||
- pnpm@11.17.0 安装锁定依赖,pnpm typecheck、pnpm test(19 项)通过。验收过程中出现过编辑器调整按钮缩放导致旧布局契约失败,后续保存值已恢复为 1;未放宽原登录布局测试。
|
||
- 测试覆盖进度单调与上限、无效时间、真实完成和重置、场景布局、资源命名及九宫格边距、认证组件绑定。
|
||
- PinK 场景预览核对 loading 展示、失败恢复、收尾文字互斥、禁用再启用及完成事件单次发送。
|
||
- 编辑器允许打开 PreparationPanel 预览美术;初始隐藏由 StartupLoadingView.onLoad 执行,并在发布页验证,不强制覆盖编辑器可见状态。
|
||
- web-mobile 构建成功。发布页注入验签失败后恢复可重试;随后真实两步认证成功,100% 后撤层并发送一次完成事件。
|
||
- 540×960、390×844、390×640、844×390 核对主体与 loading 控件边界均在可见区域内,切图尺寸比例保持一致。
|
||
- 最终产物 build/web-mobile-startup-release,构建成功;最终 pnpm typecheck 和 19 项测试全部通过。发布页启动隐藏覆盖层、满格宽度 906、左右圆头及恢复后的控件状态已复核。
|
||
|
||
未进行原生构建和真机验证;当前没有原生子工程,本轮范围为场景 UI 与 Web 认证流程。 |