拆分(行为不变,截图四件套逐字节相同):
- 400 行的 app.rs 拆成 src/app/{mod,state,message,update,subscription,view,boot,tests}.rs,
每个文件 ≤ 300 行;components 的 #[path] 跟着搬到 src/app/mod.rs(逻辑路径仍是 crate::app::components),
可见性放到 pub(crate) 让页面层能用真组件。
- 拆分前后各出 shell/gallery 浅深四张图,cmp 全部 IDENTICAL。
presenter 接线(crate 文档 §4):
- App 持有 Box<dyn Backend> + SettingsBridge + AppState;启动 build_backend + SettingsBridge::open + AppState::new。
- 截图通道强制 mock(D30 可复现);交互模式走真 host,--data-dir 从 M90 起真的被消费。
- Boot 抽干首屏快照(第 3 帧落盘,等节拍会把空页面拍进图);节拍 = 帧事件 + 33ms 时间闸门
(iced::time::every 要 tokio/smol,见 finding),tick → drain_events → AppState::apply。
- 用户动作不乐观回显:Launch/Stop 走 Backend::dispatch,状态等事件回来才变。
- 路由:pages::Message::Navigate(Route) 直接进 AppState::navigate,选中项 = 路由栈顶(不再有本地副本);
首屏自动选中第一行(list-detail 桌面惯例),只做一次。
实例页打通(其余三页保留占位视觉 + Message/update + 路由):
- 列表行换成 components::navigation::ListItem(真五态/选中),页头与详情动作换成 components::buttons
(Play 是唯一的实心 accent),分隔线换成 components::divider。
- 数据全部来自 presenter 快照:VERSION/LOADER/ISOLATION/VERSION ID/FILES/LAST PLAYED + 运行状态行。
- 导航轨换成真 NavigationRail(88),5 项各自压/替换路由。
版面约束未破(实测):列表列 336、正文列 424(元信息卡 206+12+206,右缘 896)、rail 88(药丸 16..71)、
断点 600/840 走 frame_metrics;新增 pages/tests.rs 的 9 条数值断言钉住它们。
69 lines
3.0 KiB
Rust
69 lines
3.0 KiB
Rust
//! Elm 三件套:`State` / `Message` / `update` + `view` 接线,以及启动序列。
|
||
//!
|
||
//! 启动序列:①探测渲染后端并写 `ICED_BACKEND`(必须在 `run()` 之前,M60 Q1)→ ②求值字体栈
|
||
//! (D28 前半)→ ③`iced::application(..).run()`(1180×760、无边框自绘标题栏)→ ④首个 `view()`
|
||
//! 打耗时;截图模式第 3 帧落盘后退出(无边框窗首帧可能是旧尺寸,M60 坑 #5)。
|
||
//!
|
||
//! ## 为什么拆成目录(M90)
|
||
//!
|
||
//! 本文件原来是**单个 400 行的 `app.rs`**:正好卡在「单文件 ≤400 行、动它前必须先拆」的硬门槛上
|
||
//! (AGENTS 的文件上限 + 本 mission 的第一条任务)。拆法与职责:
|
||
//!
|
||
//! | 文件 | 职责(**只做这一件事**) |
|
||
//! |---|---|
|
||
//! | [`state`] | [`App`] 字段 + 构造(presenter 三件在此持有)+ 主题切换 |
|
||
//! | [`message`] | [`Message`] 枚举与「导航项 → 路由」的翻译 |
|
||
//! | [`update`] | 全部 `Message` 分支 + 「用户动作 → `AppCommand`」的派发与事件回流 |
|
||
//! | [`subscription`] | 帧事件(截图)与 presenter 的 TICK 节拍 |
|
||
//! | [`view`] | `view` / `theme` / `title` |
|
||
//! | [`boot`] | [`run`]:后端探测 → 字体 → `iced::application(..)` |
|
||
//!
|
||
//! 拆分的每一步都保持**可观察行为不变**(截图四件套 `--screenshot` / `--screenshot-theme` /
|
||
//! `--screen=gallery` / `--diff` 出图逐字节相同),presenter 接线是在拆分**之后**另一步做的。
|
||
//!
|
||
//! ## 组件库为什么还在本模块下声明
|
||
//!
|
||
//! `src/lib.rs` 是五条组件线共用的文件,改它必然冲突;`#[path]` 保证物理路径仍是
|
||
//! `src/components/`(组件目录自己的归属规则不变),逻辑路径仍是 `crate::app::components`
|
||
//! (组件源码里的文档与测试都按这个路径写)。
|
||
|
||
mod boot;
|
||
mod message;
|
||
mod state;
|
||
mod subscription;
|
||
mod update;
|
||
mod view;
|
||
|
||
#[cfg(test)]
|
||
mod tests;
|
||
|
||
pub(crate) use boot::run;
|
||
pub use message::Message;
|
||
|
||
// 组件库(D39)在本文件声明:`src/lib.rs` 是五条组件线共用的文件,改它必然冲突;
|
||
// `#[path]` 保证物理路径仍是 `src/components/`(组件目录自己的归属规则不变)。
|
||
//
|
||
// M90:可见性从 `mod` 放到 `pub(crate) mod` —— 页面层(`src/pages/**`)要**用**真组件
|
||
// (`components::buttons` / `navigation` / `divider`),而 `app` 不是它的父模块。
|
||
// 只放开 crate 内可见,组件目录的归属规则一字不改。
|
||
#[path = "../components/mod.rs"]
|
||
pub(crate) mod components;
|
||
|
||
/// 验收窗口尺寸(1180×760 @100% DPI —— D30 的硬要求)。
|
||
pub const WINDOW_SIZE: iced::Size = iced::Size {
|
||
width: 1180.0,
|
||
height: 760.0,
|
||
};
|
||
|
||
/// 产品名(自绘标题栏的标题;`'static` 好让 view 借用)。
|
||
pub const APP_TITLE: &str = "Unlucky Launcher";
|
||
|
||
/// 窗口最小尺寸(再小骨架会挤坏:88 导航 + 页面留白 + 卡片)。
|
||
const MIN_SIZE: iced::Size = iced::Size {
|
||
width: 880.0,
|
||
height: 560.0,
|
||
};
|
||
|
||
/// 截图落盘的帧号(见模块文档)。
|
||
const CAPTURE_AT_FRAME: u32 = 3;
|