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 类根因后归零。)
This commit is contained in:
2026-10-11 22:07:48 +08:00
commit 41e3aa3d95
80 changed files with 6985 additions and 0 deletions
+38
View File
@@ -0,0 +1,38 @@
/build/
/entry/build/
/entry/.preview/
/.hvigor/
/oh_modules/
/entry/oh_modules/
# IDE 配置
/.idea/
*.iml
# 本地配置(含 SDK 本机绝对路径)
/local.properties
/.clangd
/.clang-format
/.clang-tidy
# 签名材料:私钥 / 证书 / Profile / 口令 —— 严禁入库
/sign/
/signature/
*.p12
*.cer
*.p7b
*.csr
*.keystore
*.jks
password.txt
*password*.txt
# 仓库根目录的签名构建配置:含本机绝对路径与加密口令,机器相关,不入公共仓库
# (仅锚定根目录;entry/build-profile.json5 是普通模块构建配置,仍需入库)
/build-profile.json5
# hvigor 本地引擎 / 插件:构建期从 DevEco 恢复进来的机器相关副本,不入公共仓库
# 注意 /hvigor/hvigor-config.json5 是项目构建配置,仍需入库
/hvigor/*
!/hvigor/hvigor-config.json5
/hvigor-ohos-plugin/