Files
fruit-pop-googleplay/docs/startup-loading.md
T
2026-11-20 16:29:14 +08:00

29 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 认证流程。