FamilyBook_harmonyos

2 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
laoyang	0548a45da1	v0.2.0 沉浸式 + 按手机重排版 + 去掉导航模块三条用户反馈一次处理完。 ## ① 不够沉浸：首页距顶太远 + 底部白条根因是重复避让 + 颜色断裂，两处都是我自己的错： · 早先没开全屏时，系统已把窗口推到状态栏下方，我却又加了一个等高的白色 Column「让出安全区」⇒ 重复避让，实测顶部空出 156px； · 状态栏底色被设成「页面底色（宣纸米）」，而顶栏是白色 ⇒ 顶部出现「米色状态栏 + 白色顶栏」的拼接感，看着就是"没对齐"。改法： · EntryAbility 调 setWindowLayoutFullScreen(true)，窗口铺满整屏； · 状态栏底色一律取顶栏底色，底部手势条取页面底色 —— 各自与紧邻元素同色； · 页面侧用 getWindowAvoidArea 自己让位（顶栏顶部内边距 = 状态栏高度，底色一直画到屏幕最上沿）； · 底部那条全宽白 Column 删掉。避让值走异步 window.getLastWindow + windowSizeChange 监听（早先"Ability 取窗存 AppStorage 再同步读"的做法实测读不到值，恒为 0）；旋转/折叠后会自动重算。验证（像素级，非目测）：y=0..200 全为顶栏白（原先 y=0..121 是米色状态条），底部 y=2224..2444 全为纸色、白条消失。 ## ② 去掉「导航」模块用户原话：「导航是专门为电脑端开发的，都是网站，主要用在浏览器的主页，所以不需要」。 ⇒ 删掉 FbNavPage、FbNavLink 类型、FB_DEMO_NAV、fbGroupNav、图标分支与演示数据。 ⚠️ 模块清单自此与 Web 端 Module::LIST 有意不等，注释里写明了别补回去。 ## ③ 排版按手机重做（不照搬电脑端）首页：删掉 hero 招牌整块（它只重复信息面板已有的信息），信息面板升为首块并改成无卡片的页面头部（问候/日期大字、天气右上、三数字贴底）—— 套白卡片会在首屏就切出一块白、压缩可用高度，也破坏沉浸感。卡片从「今天的日程」才开始用，页面层次反而更清楚。其余按手机重排：观影两列定格（原瀑布流）、任务按状态三段（原多列看板）、家谱圈层（原折线树）。README 里列了逐项取舍与理由。 ## 编译 hvigorw assembleHap --mode module -p product=default --no-daemon → BUILD SUCCESSFUL，0 error / 0 warning	2026-10-11 23:20:49 +08:00
laoyang	41e3aa3d95	v0.1.0 界面框架：抽屉骨架 + 13 个模块页面对应服务端 FamilyBook（家书）的鸿蒙客户端首版。本轮只做界面框架，数据全部是演示数据 —— 服务端尚无客户端接口，所有增删改只做入口与样式，不落任何数据。 ## 骨架左侧抽屉 + 右侧内容。抽屉两套形态由窗口短边决定（≥600vp 为宽屏）：宽屏常驻侧栏、窄屏滑出层。判据取「短边」而非「宽度」，因为短边在旋转时不变，比例接近 1:1 的设备横竖屏布局天然一致。 ## 模块（与 Web 端 Module::LIST 一一对应，key 即路由名）首页、家谱、名册、观影、旅程、日程、资源、任务、纪念日、财务、读书、导航、笔记；另有通知消息、个人设置两个附加页。 ## 与 Web 端保持一致的几处 · 模块清单唯一来源在 model/Modules.ets，加模块只改那一处； · 模块主题色三档由主色按 HSL 压明度算出，预设色板与 Web 端逐值一致； · 术语沿用 Web 端固定下来的口径（旅程 ⊃ 行程；观影的「影院」不单独占抽屉位，从模块内设置进）； · 页面结构照 Web 端的信息层次（首页信息面板 / 财务概览在账目之前 / 纪念日「即将到来」在顶 / 任务按状态而非按看板）。 ## 编译验证 hvigorw assembleHap --mode module -p product=default → BUILD SUCCESSFUL，0 error / 0 warning（含一次删 build 后的干净重建）过程中修掉的编译期问题： · Circle().fill() 是 API 26 才有的重载（compatibleSdk 是 24） → 换「方块 + 圆角」画圆，零版本风险； · setWindowBackgroundColor 对 phone/tablet 不可用 → 去掉（页面已铺满同色）； · window.getLastWindow() 只有异步版 → 由 Ability 侧同步取窗存 AppStorage； · 颜色类 @Param 声明成 string 导致传 Resource 报错 → 统一改 ResourceColor； · 页面在 pages/<模块>/ 下，公共件 import 相对路径要多退一级。（首轮编译 95 error / 18 warn，逐条定位到 5 类根因后归零。）	2026-10-11 22:07:48 +08:00

Author

SHA1

Message

Date

laoyang

0548a45da1

v0.2.0 沉浸式 + 按手机重排版 + 去掉导航模块

三条用户反馈一次处理完。

## ① 不够沉浸：首页距顶太远 + 底部白条

根因是**重复避让 + 颜色断裂**，两处都是我自己的错：
· 早先没开全屏时，系统已把窗口推到状态栏下方，我却又加了一个等高的白色
  Column「让出安全区」⇒ 重复避让，实测顶部空出 156px；
· 状态栏底色被设成「页面底色（宣纸米）」，而顶栏是白色 ⇒ 顶部出现
  「米色状态栏 + 白色顶栏」的拼接感，看着就是"没对齐"。

改法：
· EntryAbility 调 setWindowLayoutFullScreen(true)，窗口铺满整屏；
· 状态栏底色一律取**顶栏底色**，底部手势条取**页面底色** —— 各自与紧邻元素同色；
· 页面侧用 getWindowAvoidArea 自己让位（顶栏顶部内边距 = 状态栏高度，
  底色一直画到屏幕最上沿）；
· 底部那条全宽白 Column 删掉。

避让值走**异步** window.getLastWindow + windowSizeChange 监听
（早先"Ability 取窗存 AppStorage 再同步读"的做法实测读不到值，恒为 0）；
旋转/折叠后会自动重算。

验证（像素级，非目测）：y=0..200 全为顶栏白（原先 y=0..121 是米色状态条），
底部 y=2224..2444 全为纸色、白条消失。

## ② 去掉「导航」模块

用户原话：「导航是专门为电脑端开发的，都是网站，主要用在浏览器的主页，所以不需要」。
⇒ 删掉 FbNavPage、FbNavLink 类型、FB_DEMO_NAV、fbGroupNav、图标分支与演示数据。
⚠️ 模块清单自此与 Web 端 Module::LIST **有意不等**，注释里写明了别补回去。

## ③ 排版按手机重做（不照搬电脑端）

首页：删掉 hero 招牌整块（它只重复信息面板已有的信息），信息面板升为首块
并改成**无卡片的页面头部**（问候/日期大字、天气右上、三数字贴底）——
套白卡片会在首屏就切出一块白、压缩可用高度，也破坏沉浸感。
卡片从「今天的日程」才开始用，页面层次反而更清楚。

其余按手机重排：观影两列定格（原瀑布流）、任务按状态三段（原多列看板）、
家谱圈层（原折线树）。README 里列了逐项取舍与理由。

## 编译
hvigorw assembleHap --mode module -p product=default --no-daemon
→ BUILD SUCCESSFUL，0 error / 0 warning

2026-10-11 23:20:49 +08:00

laoyang

41e3aa3d95

v0.1.0 界面框架：抽屉骨架 + 13 个模块页面

对应服务端 FamilyBook（家书）的鸿蒙客户端首版。本轮只做**界面框架**，
数据全部是演示数据 —— 服务端尚无客户端接口，所有增删改只做入口与样式，
不落任何数据。

## 骨架
左侧抽屉 + 右侧内容。抽屉两套形态由窗口短边决定（≥600vp 为宽屏）：
宽屏常驻侧栏、窄屏滑出层。判据取「短边」而非「宽度」，因为短边在旋转时
不变，比例接近 1:1 的设备横竖屏布局天然一致。

## 模块（与 Web 端 Module::LIST 一一对应，key 即路由名）
首页、家谱、名册、观影、旅程、日程、资源、任务、纪念日、财务、读书、
导航、笔记；另有通知消息、个人设置两个附加页。

## 与 Web 端保持一致的几处
· 模块清单唯一来源在 model/Modules.ets，加模块只改那一处；
· 模块主题色三档由主色按 HSL 压明度算出，预设色板与 Web 端逐值一致；
· 术语沿用 Web 端固定下来的口径（旅程 ⊃ 行程；观影的「影院」不单独占
  抽屉位，从模块内设置进）；
· 页面结构照 Web 端的信息层次（首页信息面板 / 财务概览在账目之前 /
  纪念日「即将到来」在顶 / 任务按状态而非按看板）。

## 编译验证
hvigorw assembleHap --mode module -p product=default
→ BUILD SUCCESSFUL，0 error / 0 warning（含一次删 build 后的干净重建）

过程中修掉的编译期问题：
· Circle().fill() 是 API 26 才有的重载（compatibleSdk 是 24）
  → 换「方块 + 圆角」画圆，零版本风险；
· setWindowBackgroundColor 对 phone/tablet 不可用 → 去掉（页面已铺满同色）；
· window.getLastWindow() 只有异步版 → 由 Ability 侧同步取窗存 AppStorage；
· 颜色类 @Param 声明成 string 导致传 Resource 报错 → 统一改 ResourceColor；
· 页面在 pages/<模块>/ 下，公共件 import 相对路径要多退一级。

（首轮编译 95 error / 18 warn，逐条定位到 5 类根因后归零。）

2026-10-11 22:07:48 +08:00