Flutter 鸿蒙圆屏穿戴实战:让信息学会自己降级
466 px 的圆屏上,"宽度 466"只在正中间成立:y=84 那一行只有 263.82 px 的弦,扣掉呼吸边只剩 239.82。
round_fit从这张弦宽表出发,把放不下的内容按四档降下去,再把内存预算压到 20 KB;52 项测试全部通过,一个手表 HAP 在 Huawei_Wearable 模拟器上跑完了这套契约。
仓库地址:https://atomgit.com/lqjmac/roundfit-flutter
版本地址:https://atomgit.com/CPF-Flutter/flutter_flutter/tree/oh-3.41.9-release
三方库框架:https://atomgit.com/oh-Flutter
0. 环境与实测设备
| 项 | 版本/型号 |
|---|---|
| Flutter | 3.41.9+ohos-1.0.2(OpenHarmony 分支),Dart 3.11.5 |
| DevEco Studio | API 26 SDK 与 hvigor 6.26.4(command-line-tools 的 6.21.2 只映射到 API 21,会报 SDK component missing) |
| round_fit | 0.2.0(本仓库,path 依赖;除 Flutter SDK 外零第三方运行时依赖) |
| 测试 | 包内 52 项(几何 / 档位 / Plan / 圆屏组件)+ example 5 项交互测试,全部通过 |
| Plan 校验 | dart run tool/export_plan.dart 生成 preview/plan.json,node tool/validate_plan.mjs 校验通过 |
| 实测设备 | Huawei_Wearable 模拟器,HarmonyOS 7.0.0.105 / API 26,466×466,density 2.0(233×233 逻辑 dp) |
| 实测形态 | Flutter OHOS HAP:引擎、Dart 与全部圆屏组件跑在模拟器里,画廊、WebView 或视频这类演示不算 |
1. 300 px 的行宽,在 y=84 处只剩 239.82
把手机上的卡片直接搬到手表上,先坏的是宽度。圆屏直径 466,圆心在 (233,233),内容安全圆半径 199,四周各内缩 34。水平线在圆心处最长,398 px;往上下走就迅速变短,到 y=84 只剩 263.82,扣掉行内 24 px 呼吸空间是 239.82。我原来那张固定 300 px 的卡片放在这个高度,右边直接被圆弧切掉一截,圆角也没了。
用 ClipOval 包起来解决不了这个问题,它只是把越界部分裁掉,文字和数值还是按 300 px 排的,裁完就是缺字。正确做法是让每一行先问"我这个高度允许多宽",再决定排版。rowWidthLimit(y) 就是这个问题的最小答案,chordWidthForBand(top, bottom) 是它在有高度内容上的修正版。
断点也跟着失灵。手表没有横竖屏,MediaQuery 那套宽度断点在这里没有输入信号;textScale 会变、可用高度会变、可用内存会变,这三样才是一块表上会变的东西。所以这个库把"响应式"换成了"降级":先丢说明,再丢第二行指标,再丢次操作,最后只留主值和一行标签。缩字号是最差的选项。缩到 0.8 倍,字是小了,可谁也读不清。
内存是另一道硬约束。一块表的图片与模糊预算可能只有几十 KB,背景模糊 12 KB、缩略图 16 KB,两项同时挂着就吃掉 28 KB,比少显示一行指标伤得多。所以预算被写进契约:full 档才允许模糊和图片,降档即关。
几何、档位、内存最后收成一个纯 Dart 引擎:三者都不 import Flutter,tool/export_plan.dart 在命令行进程里复用同一份代码,组件层只负责把 Plan 的绝对坐标画出来。
2. 四页手表 App
示例是一个能点的四页手表 App,跑在 Huawei_Wearable 模拟器(HarmonyOS 7.0.0.105 / API 26,466×466)的真实 HAP 里。
表盘页是晨间简报:

深色底上单一主色 #5BE7C4:眉标、标题、主值 18°、两行指标、两个胶囊操作都落在半径 199 的安全圆内,208px 进度弧画在安全圆外侧 9 px;顶部一枚 60 / 128 KB 内存胶囊可点进实验室。每一处内容的位置都来自 Plan 的绝对坐标(eyebrowY=84、heroY=214、rowsY=[272,318]),这些 y 都从弦宽表算出来,没有一个是拍的。
日程页:

圆屏列表行纵向滚动,每一行按所在区间的最窄弦宽收缩——越靠近表圈的行越窄并渐隐,卡片圆角始终在圆内。点任意条目勾选/取消完成,底部弹出轻提示;左上返回键回表盘。
天气页:

点任一时段,该时段主色描边、标题下的摘要随之切换,主值从表盘的 18° 一路带过来。
实验室页:

预算 − / + 以 16 KB 步进实时改档;系统字号在 1.00× / 1.15× / 1.30× / 1.45× 之间切换;省电模式开关强制 essential;列表下滑能看到内存条、引擎的取舍决策与恢复默认。降级是端到端的:预算从 128 KB 连按三次 − 到 80 KB,表盘当场从 full 掉到 compact,第二行指标和主值说明消失;继续降到 20 KB 只剩主值,日程页也从 4 项折叠到 1 项。四档内存 60 / 40 / 31 / 20 KB,与 Plan 一致。
模拟器上逐项点过:日程页 3 项可读、第 4 项渐隐;点第一项勾选圈变主色、标题加删除线、副标题变 完成 1、提示条写 完成「设计评审」;点主值进「逐小时天气」,点 13:00 该行主色描边;内存胶囊进实验室是 FULL · 60/128 KB,预算 − 三次到 COMPACT · 40/80 KB,五次到 ESSENTIAL · 31/48 KB,七次落到下限 20 KB 的 GLANCE · 20/20 KB。
3. 几何、档位、预算三条线
整条链路是"几何约束 + 内容模型 + 三重上限 → Plan":
直径 466 / 边距 34 ──► 安全圆半径 199 ──► 每一行的弦宽 ──► 文本截断
│
├─ 内容模型(主值、标签、指标行、弧、操作)
├─ 约束(预算 KB、字号倍率、可用高度、requestedTier)
└─► tier = max(memoryCap, textScaleCap, heightCap, requestedTier)
│
└─► Plan:只保留该档仍值得显示的内容 + 内存决策(5 条)
几何线的核心是弦长公式。圆心 (233, 233),安全圆半径 199 = 233 − 34:
chordWidth(y) = 2 * sqrt(max(0, 199² − (y − 233)²))
rowWidth <= chordWidth(y) − 24
公式本身来自勾股定理:圆心到这一行所在直线的距离是 |dy|,斜边是半径 r,半弦长就是 sqrt(r² − dy²),整条弦取两倍。r = 199、dy = 0 时是 398,这就是屏幕中间最宽的那条线。
拿两个真实 y 验算。y=272 时 dy = 39,199² − 39² = 39601 − 1521 = 38080,开方得 195.14,弦宽 390.28,扣掉 24 的呼吸边是 366.28。y=84 时 dy = −149,39601 − 22201 = 17400,开方得 131.91,弦宽 263.82,扣完只剩 239.82。表格里那两行的数不是量出来的,是这么算出来的。
dy 的符号不影响结果,公式里是平方;但 y 越过圆心后弦宽会回升,所以最上面的眉标和最下面的内存标识,可用宽度都只有圆心附近的一半多一点。主值能放到 56–62sp,眉标只有 12sp,差距就在这里。
full 档七个元素的实际约束,弦宽逐行递减:
| 元素 | y | 弦宽 | 行宽上限 |
|---|---|---|---|
| 眉标 | 84 | 263.82 | 239.82 |
| 标题 | 116 | 321.94 | 297.94 |
| 主值 | 214 | 396.18 | 372.18 |
| 指标行 1 | 272 | 390.28 | 366.28 |
| 指标行 2 | 318 | 359.87 | 335.87 |
| 操作区 | 364 | 299.60 | 275.60 |
| 内存标识 | 412 | 173.90 | 149.90 |
档位线是四档降级表加三重上限:
| rank | 档位 | 保留内容 |
|---|---|---|
| 0 | full | 眉标、标题、主值、主值说明、2 行指标、弧、2 个操作 |
| 1 | compact | 眉标、标题、主值、1 行指标、弧、1 个操作 |
| 2 | essential | 标题、主值、1 行指标、1 个操作 |
| 3 | glance | 仅主值 + 一行标签 |
budget >= 96 / 56 / 32 KB → full / compact / essential / glance
textScale >= 1.30 / 1.15 → essential / compact
contentHeight < 260 / 320 → essential / compact
requestedTier 只允许应用主动再降一档(省电模式用),不能越过预算升级:上限取 max,单向棘轮。
内存线是 KB 级公式:base 14 + eyebrow 2 + hero 9(glance 为 6)+ 每行指标 6 + 弧 7 + 每操作 2 + 背景模糊 12(仅 full)+ 图片 16(仅 full)。晨间场景 full 档:14 + 2 + 9 + 2×6 + 7 + 2×2 + 12 = 60 KB ≤ 128 KB。模糊和图片只有 full 档才舍得开,这是小内存下最要紧的一个决定。
先丢装饰、后丢信息,是算过账的顺序。背景模糊 12 KB、缩略图 16 KB 是固定成本,不随内容多少变化,模糊还要按帧算 GPU;一行指标 6 KB,一个操作 2 KB。预算从 96 KB 掉到 56 KB 时,关掉模糊立刻省 12 KB,相当于两行指标,而主值、标题、第一行指标全都还在。反过来先砍信息保模糊,用户看到的是糊着的半条消息。
装饰这块有个特殊规则:模糊和图片只在 full 档计入,预算够也不开。它们一旦开着,每一帧都要付费;信息只是一次性排版。手表的电和热,很少耗在某一屏的静态文字上。
同一份常量、同一套降级策略、同一份 Plan JSON,六个框架各交一份实现:
| 框架 | 场景 | 主值 | 预算 | 目标档位 | 主色 |
|---|---|---|---|---|---|
| Flutter(本项目) | 晨间简报 | 18° | 128 | full | #5BE7C4 |
| Kotlin Multiplatform | 运动圆环 | 8,432 | 64 | compact | #A78BFA |
| Cordova | 通勤下一班 | 3 分钟 | 48 | essential | #7CFFB2 |
| Electron | 表盘工坊 | 09:41 | 100 | full | #FFC36B |
| Qt / QML | 播客进展 | 12:48 | 40 | essential | #FF8A65 |
| React Native | 消息一瞥 | 3 | 28 | glance | #FF7AA2 |
跨框架只允许语言惯用法、包管理器和示例宿主不同,其余逐项一致。
4. 纯 Dart 引擎,组件只负责画 Plan
引擎与组件分层,lib/src 的前六个文件是纯函数,widgets/ 是呈现:
roundfit-flutter/
├─ lib/
│ ├─ round_fit.dart # 公共导出
│ └─ src/
│ ├─ geometry.dart # chordWidth / chordWidthAtY / fitText / hitRing
│ ├─ tier.dart # 四档枚举 / 三重上限 / estimateMemoryKB
│ ├─ content.dart # 场景内容模型(morning 等)
│ ├─ plan.dart # RoundFitPlan.generate / toJson
│ ├─ memory.dart # MemoryBudget(预算、估算、决策)
│ ├─ theme.dart # 颜色用 0xAARRGGBB 整数以便 CLI 复用
│ └─ widgets/
│ ├─ round_screen.dart # 表盘:固定 466×466,按 Plan 绝对定位
│ ├─ round_page.dart # 页面骨架:径向底色 + 安全圆 + 返回键
│ ├─ round_button.dart # 胶囊 / 圆形图标按钮
│ ├─ round_tile.dart # 一行可点信息(选中、完成态)
│ ├─ round_badge.dart # 内存 / 档位元信息胶囊
│ ├─ round_list.dart # 滚动列表:按区间最窄弦宽收窄渐隐
│ ├─ round_settings.dart # RoundStepper / RoundToggle
│ └─ glance_card.dart · arc_progress.dart
├─ test/ # 52 项:几何 / 档位 / Plan / 组件
├─ example/
│ ├─ lib/watch_main.dart # 手表 App 入口
│ ├─ lib/watch/ # 状态、路由、轻提示与四个页面
│ ├─ test/watch_app_test.dart # 5 项交互测试
│ └─ ohos/ # Flutter OHOS wearable 宿主(真实 HAP)
├─ tool/export_plan.dart # 纯 Dart 生成 preview/plan.json
└─ docs/ # round-contract / watch-app / verification
引擎和组件之间有硬边界。引擎是纯函数,组件只是投影,52 项测试大半打在纯函数上,RoundScreen 只是拿 Plan 的绝对坐标摆位置;表盘渲染用 MediaQuery.textScaler 算行高,但每档字号限制在上限内,放大字号触发的是降档,不缩小。Plan 由引擎生成,不由人手写:tool/export_plan.dart 复用库引擎产出 preview/plan.json,tool/validate_plan.mjs 校验,六框架的 Plan 用同一个校验器断言。零第三方依赖、零模糊:只有 Flutter SDK,不叠多层模糊、不做玻璃拟态,数字用 FontFeature.tabularFigures(),中文标签 12–14sp、主值 56–62sp。
example/ohos 这层不参与布局:Flutter 视图放进 FlutterPage,FittedBox 把 466×466 的设计画布缩到窗口的 233 逻辑像素,module.json5 把 deviceTypes 改成 wearable 才能装进手表模拟器。HAP 是 debug 构建,约 92 MB,大头是 Flutter debug 引擎和 arm64/x86_64 两份产物;库本身不碰这些,换宿主只要重走一遍 build_watch_hap.sh。
接入是声明式的:
final RoundFitPlan plan = RoundFitPlan.generate(
RoundFitContent.morning,
budgetKB: 128,
textScale: MediaQuery.textScalerOf(context).scale(10) / 10,
contentHeight: 466,
);
RoundScreen(
plan: plan,
theme: RoundFitTheme.morning,
onAction: (action) { /* action.label / action.kind */ },
);
5. 代码:弦宽、档位与弧
5.1 弦宽与区间最窄
geometry.dart 只依赖 dart:math,不 import Flutter,命令行进程才能复用:
// lib/src/geometry.dart
/// 某条水平线上的弦宽。dy 是相对圆心的纵向偏移(向下为正)。
double chordWidth(double dy, {double radius = kRoundFitSafeRadius}) {
final double square = radius * radius - dy * dy;
if (square <= 0) {
return 0;
}
return 2 * math.sqrt(square);
}
/// 以屏幕绝对 y 坐标计算安全圆的弦宽。
double chordWidthAtY(double y, {double radius = kRoundFitSafeRadius}) =>
chordWidth(y - kRoundFitCenter, radius: radius);
/// 某一 y 坐标上允许的最大行宽:弦宽减去 24 px 呼吸空间。
double rowWidthLimit(double y) {
final double width = chordWidthAtY(y) - kRoundFitRowGutter;
return width <= 0 ? 0 : width;
}
/// 纵向区间 `[top, bottom]` 内最窄的弦宽。
///
/// 一行有高度,圆在区间两端更窄;只按中心 y 取弦宽会让卡片的圆角被屏幕
/// 边缘切掉。这里取区间内离圆心最远的那条边,保证整块内容都在圆内。
double chordWidthForBand(
double top,
double bottom, {
double radius = kRoundFitSafeRadius,
}) {
assert(bottom >= top, 'bottom 不能小于 top');
if (bottom < top) {
return 0;
}
final double upper = (top - kRoundFitCenter).abs();
final double lower = (bottom - kRoundFitCenter).abs();
final double extreme = upper > lower ? upper : lower;
if (extreme >= radius) {
return 0;
}
return 2 * math.sqrt(radius * radius - extreme * extreme);
}
/// 一个纵向区间允许的最大行宽。
double rowWidthLimitForBand(double top, double bottom) {
final double width = chordWidthForBand(top, bottom) - kRoundFitRowGutter;
return width <= 0 ? 0 : width;
}
chordWidth() 的边界很干脆:|dy| >= r 一律返回 0,不会出现负宽度。测试里把这几处边界都写死了:|dy| = r 返回 0,|dy| > r 返回 0,dy = 0 返回 398;rowFitsChord() 还留了 0.001 的浮点余量,免得 300 和 335.87 这种比较被尾数绊倒。chordWidthForBand() 是这次新增的关键函数。行有高度,区间中心合法不代表整块合法,它取 top、bottom 两端离圆心更远的那一侧算弦宽,所以落在表圈附近的卡片,圆角不会被切出安全圆。滚动列表的每一行都按自己当前所在的区间取宽,越靠近边缘越窄。
文本宽度用六框架共享的简化度量:Σ (isCJK(ch) ? 1.0 : 0.56) × fontSize,不依赖平台字体测量。fitText() 超宽时逐码点缩短并保留 …,截断结果严格小于可用宽度;连省略号都放不下时返回空串,由调用方隐藏该槽位。估算当然不准,但它让六个框架对同一份 Plan 逐字节一致。
5.2 档位:三条上限取 max
tier.dart 把预算、字号、高度三道上限和 requestedTier 收敛成一个值:
// lib/src/tier.dart
RoundFitTier tierForBudget(int budgetKB) {
if (budgetKB >= kBudgetFullKB) {
return RoundFitTier.full;
}
if (budgetKB >= kBudgetCompactKB) {
return RoundFitTier.compact;
}
if (budgetKB >= kBudgetEssentialKB) {
return RoundFitTier.essential;
}
return RoundFitTier.glance;
}
RoundFitTier resolveTier({
required int budgetKB,
double textScale = 1,
double contentHeight = 466,
RoundFitTier requestedTier = RoundFitTier.full,
}) {
final List<RoundFitTier> caps = <RoundFitTier>[
tierForBudget(budgetKB),
tierForTextScale(textScale),
tierForContentHeight(contentHeight),
requestedTier,
];
int rank = 0;
for (final RoundFitTier cap in caps) {
if (cap.rank > rank) {
rank = cap.rank;
}
}
return RoundFitTier.values[rank];
}
int estimateMemoryKB({
required RoundFitTier tier,
required bool hasEyebrow,
required int rowCount,
required bool hasArc,
required int actionCount,
bool blur = false,
bool image = false,
}) {
int kb = kMemoryBaseKB;
if (hasEyebrow && tier.keepsEyebrow) {
kb += kMemoryEyebrowKB;
}
kb += tier == RoundFitTier.glance ? kMemoryHeroGlanceKB : kMemoryHeroKB;
kb += rowCount * kMemoryRowKB;
if (hasArc && tier.keepsArc) {
kb += kMemoryArcKB;
}
kb += actionCount * kMemoryActionKB;
if (blur && tier.keepsBlur) {
kb += kMemoryBlurKB;
}
if (image && tier.keepsImage) {
kb += kMemoryImageKB;
}
return kb;
}
取 max,没有写成 if-else 链:任何一处约束触发都只能把档位往下推,约束全都不触发才保住 full。requestedTier 是应用主动再降(省电模式),不能越过预算升级:预算是 48 KB 时请求 compact,结果仍是 essential;预算 128 KB 时请求 glance,结果是 glance。
estimateMemoryKB 的写法也值得看一眼。眉标只在 tier.keepsEyebrow 时计 2 KB,弧只在 keepsArc 时计 7 KB,模糊和图片只在 full 档计。调用方误传 blur: true 也一样,在 compact 档不会被算进预算。
5.3 Plan:把几何和档位落到固定坐标
四档的 y 是固定表,六框架逐项一致:full 的 rowsY=[272,318]、compact 的 [286]、essential 的 [276]、glance 连标题都不留。generate() 先取 RoundFitLayout.forTier(tier),再按 rowWidthLimit(y) 和 300 的行盒上限算出宽度,把文本拟合交给 _fitRow():
// lib/src/plan.dart
RoundFitPlanRow _fitRow({
required RoundFitRow source,
required int y,
required int width,
required RoundFitTypeScale type,
}) {
const double horizontalPadding = 14;
const double labelGap = 12;
final double innerWidth = width - horizontalPadding * 2;
final String limitedLabel = _limitRunes(source.label.trim(), 6);
final TextFit labelFit = fitText(
limitedLabel,
maxWidth: math.max(24, innerWidth * 0.36),
fontSize: type.rowLabel,
);
final String limitedValue = _limitRunes(source.value.trim(), 18);
final double valueWidth = math.max(0, innerWidth - labelFit.width - labelGap);
final TextFit valueFit = fitText(
limitedValue,
maxWidth: valueWidth,
fontSize: type.rowValue,
);
if (labelFit.text.isEmpty || valueFit.text.isEmpty) {
throw StateError('y=$y 的行内容无法在 $width px 内显示');
}
return RoundFitPlanRow(
label: labelFit.text,
value: valueFit.text,
y: y,
width: width,
);
}
generate() 里的行循环负责从固定 y 表和弦宽上限算出 width,再调用 _fitRow():
// lib/src/plan.dart(RoundFitPlan.generate 的行循环)
final List<RoundFitPlanRow> rows = <RoundFitPlanRow>[];
final List<_RowFit> rowFits = <_RowFit>[];
final int rowCount = math.min(tier.rowCount, content.rows.length);
for (int i = 0; i < rowCount; i++) {
final RoundFitRow source = content.rows[i];
final int y = layout.rowsY[i];
final double limit = rowWidthLimit(y.toDouble());
final int width = math.min(kRoundFitRowWidth.toInt(), limit.floor());
if (width <= 0) {
throw StateError('y=$y 处没有可用的行宽');
}
final RoundFitPlanRow row = _fitRow(
source: source,
y: y,
width: width,
type: type,
);
rows.add(row);
rowFits.add(
_RowFit(
sourceLabel: source.label,
row: row,
chordLimit: limit,
truncated: row.label != source.label || row.value != source.value,
),
);
}
generate() 在调它之前还有一串前置断言:最多 2 行指标、最多 2 个操作、full 档必须给主值说明、full / compact 必须有弧、行数与操作数不能少于档位要求。这些检查让"档位说需要两行、内容只给了一行"在构造时就失败,不会拖到渲染到一半才发现空位。
行宽这里有个容易误读的字段:RoundFitPlanRow.width 记的是行盒宽度,full 档两行都写 300,因为 300 小于 366.28 和 335.87 两个上限;文本截断是另一件事,由 _fitRow() 按估算宽度单独判断。最后 estimatedKB 会再和 budgetKB 比一次,超了直接抛 StateError。
5.4 弧:CustomPainter 画三层,不用模糊
ArcProgress 用 CustomPainter 画 208px 轨道、进度弧与端点圆点,全程没有模糊:
// lib/src/widgets/arc_progress.dart(_ArcProgressPainter.paint)
void paint(Canvas canvas, Size size) {
final Offset center = size.center(Offset.zero);
final double safeRadius = math.min(radius, size.shortestSide / 2 - 1);
final Rect rect = Rect.fromCircle(center: center, radius: safeRadius);
final Paint trackPaint = Paint()
..style = PaintingStyle.stroke
..strokeWidth = strokeWidth
..strokeCap = StrokeCap.butt
..color = trackColor;
canvas.drawCircle(center, safeRadius, trackPaint);
final double sweep = 2 * math.pi * progress.clamp(0, 1).toDouble();
if (sweep <= 0) {
return;
}
final Paint progressPaint = Paint()
..style = PaintingStyle.stroke
..strokeWidth = strokeWidth
..strokeCap = StrokeCap.round
..color = color;
canvas.drawArc(rect, -math.pi / 2, sweep, false, progressPaint);
// 端点点缀:不用模糊,只画一个实心圆,省掉高斯模糊的帧开销。
final double endAngle = -math.pi / 2 + sweep;
final Offset end =
center + Offset(math.cos(endAngle), math.sin(endAngle)) * safeRadius;
canvas.drawCircle(end, strokeWidth * 1.15, Paint()..color = color);
canvas.drawCircle(end, strokeWidth * 0.42, Paint()..color = trackColor);
}
bool shouldRepaint(_ArcProgressPainter oldDelegate) =>
oldDelegate.progress != progress ||
oldDelegate.color != color ||
oldDelegate.trackColor != trackColor ||
oldDelegate.radius != radius ||
oldDelegate.strokeWidth != strokeWidth;
safeRadius 再夹一次 size.shortestSide / 2 - 1,是为了在组件被塞进比 416 更小的盒子时不画到画布外。端点用两个实心圆(外圈主色、内芯轨道色)做出"缺口"的效果,比高斯模糊便宜得多。
shouldRepaint 在 Flutter 重建 painter 时被调用,参数是旧实例。这里逐字段比较 progress、color、trackColor、radius、strokeWidth,全都没变就返回 false。父组件因为 textScale 或主题变化重建 ArcProgress 时,只要传进来的值没变,painter 不重绘,只重新布局。
如果进度挂在 AnimationController 上,每帧都是新的 progress,shouldRepaint 会一直返回 true,开销就从判断转到 drawCircle 和 drawArc 的绘制量上。晨间的弧是静态的 0.84,不挂动画,判断和绘制都不构成压力。真要连续动画,应该把进度做成 Listenable 传给 CustomPainter 的 repaint 参数,让重绘绕开 widget 重建。
列表是另一个组件:RoundListView 的每一行按 rowWidthLimitForBand(visibleTop, visibleBottom) 取宽,再夹在 176–320 之间;低于下限就不继续缩,改成降低不透明度,用渐隐交代"这一行快到边了"。176 是实测出来的:更窄时 RoundTile 在 148 px 处溢出 2 px,把行内边距收到 16、下限提到 176 才消失。
6. 装到表上才看见的几笔账
最早就栽在按中心 y 取弦宽上。行有高度,中心 y 合法不代表整块合法,卡片圆角会被切出安全圆。修法是 chordWidthForBand() 取区间最窄,列表逐行收窄渐隐,0.2.0 变更记录 记了这次修复。round_ui_test.dart 里有三组用例专门盯着区间两侧和出界,避免再只测中心点。
也试过"内容放不下就缩小字号"。缩到 0.8 倍读不清,还破坏档位语义:compact 本来就该少一行,不是把 full 压扁。现在每档字号有上限,textScale 超阈值直接降档(1.15 → compact、1.30 → essential),引擎不用缩放代替降级。
预算步进器一开始允许 16 KB,但 glance 最少需要 20 KB,实际点下去 App 直接红屏:
Bad state: 估算 20 KB 超过预算 16 KB
下限因此改成 kMemoryBaseKB + kMemoryHeroGlanceKB,也就是 20 KB。预算轴的下界是最低档的真实成本,不是零。
跨框架对账还卡在字体测量。同一段中文在 ArkUI、QML、UIKit 里的字宽本来就不一样,逐像素对齐不现实,能对齐的只有估算规则。修法是共享简化度量(CJK 1.0em / 其他 0.56em),不依赖任何平台字体测量;validate_plan.mjs 用同一份校验器断言六框架输出。
模糊和缩略图常驻是另一笔账。手机上的习惯是好看就一直挂着,手表上这两项合计 28 KB,占掉 glance 全档预算。现在模糊与图片仅 full 档计入,降档即关,决策写进 plan.memory.decisions。
还有一个纯 Flutter 的:ShaderMask 渐隐 + 卡片边框让内边距多算 1 px,列表行在窄处 RenderFlex overflow 2 px。这是像素账,只能上模拟器看。
7. 从 path 依赖到手表 HAP
包名 round_fit,版本 0.2.0,Apache-2.0,只以 path 依赖接入;lib/ 是引擎和组件,example/ 是那四页 App。接入:
dependencies:
round_fit:
path: ../roundfit-flutter
生成与校验 Plan:
dart run tool/export_plan.dart
# framework=Flutter scenario=晨间简报 tier=full rank=0
# memory=60/128 KB rows=2 actions=2 arc=0.84
# decisions=5 dropped=0
node tool/validate_plan.mjs preview/plan.json
# ✓ Flutter 晨间简报 full 60/128 KB → 1 plan(s) valid
preview/plan.json 是 78 行 UTF-8,SHA-256 是 7e443dc8cbbfa0de3fc258e96b1ff0376adf469728711219a2b29b78132ab9d8。它由 export_plan.dart 调库代码生成,测试里还有一组用例会重新生成并深比较。
手表 HAP 构建与安装(签名说明见手表构建文档):
cd example
./tool/build_watch_hap.sh
hdc -t 127.0.0.1:5555 install -r build/ohos/hap/entry-default-signed.hap
hdc -t 127.0.0.1:5555 shell "aa start -a EntryAbility -b com.lqjmac.tablet_adaptive_example"
构建输出结尾是 ✓ Built build/ohos/hap/entry-default-signed.hap,debug 产物约 92 MB。安装与启动依次打印 install bundle successfully. 和 start ability successfully.。
验证与文档都在仓库里:仓库说明收着几何、档位、内存公式全表和组件 API;圆屏契约文档写弦宽、isCJK 覆盖与环形命中的完整契约;手表构建文档记 HAP 构建、hvigor 版本与签名说明;验证记录留了全部命令与本机输出;test/ 与 example/test/ 则是 52 + 5 项测试。
当前版本在 Flutter 3.41.9+ohos-1.0.2 / API 26 SDK(hvigor 6.26.4)下:flutter analyze 包与示例均无 issue;flutter test 52 项全过(几何、档位、Plan、圆屏组件搭页、操作回调、四档切换、textScaler 放大);example 5 项交互测试全过;Plan 生成与跨框架校验通过;Huawei_Wearable 模拟器(HarmonyOS 7.0.0.105 / API 26,466×466,density 2.0)装真实 HAP 跑通了四页交互与端到端降级(128 → 80 → 20 KB)。
52 项按文件分:geometry_test 9、plan_test 16、round_ui_test 10、tier_test 12、widget_test 5;example 的 5 项只测交互,不重复纯函数断言。这个分法让几何和 Plan 的失败不依赖 Widget 环境,flutter test 不必起模拟器就能跑完。
其他边界:模拟器上的触摸注入用的是 uinput,不是自动化测试框架,所以交互这部分只能算手工验收;flutter build macos 在当前离线网络下卡在 artifact 下载,桌面构建没有列为通过项;跨框架的 Plan 一致性目前靠一个 Node 校验器和六份导出脚本维持,没有 CI。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)