# 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 收尾期间保持隐藏,纯认证模式结束后恢复。组件临时禁用会取消准备并忽略迟到结果,再启用后可重新准备,不重复提交认证。 - 默认启用 transitionToGame:收到认证成功事件后获取存档独占权限、恢复会话并加载 Orchard,依赖准备完成才收满并同步切场;失败可用游客按钮单独重试准备,不重复认证。关闭该开关时保留纯认证展示与 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 认证流程。