鸿蒙PC(2in1)应用与手机应用最大的界面差异,不是代码量,而是一屏要同时承载导航轨、会话列表、主视口、检查器、浮层和状态栏,并覆盖亮面板与暗画布两套主题。若逐处写死,第一版看似专业,后续迭代会互相打架。本文以可构建的鸿蒙PC工作台PulseFrame_ohos(帧脉·性能实验室)为样本,按令牌层、布局层、组件契约层、形态层拆解界面工程。工程为纯ArkTS/ArkUI声明式UI、Stage模型,deviceTypes为['2in1'],compatibleSdkVersion与targetSdkVersion均为5.0.5(17),runtimeOS为HarmonyOS,bundleName为com.pulseframe.perflab,versionCode为1000000;oh-package.json5的dependencies为空,签名HAP 552,795字节(约539.8 KB),未签名526,886字节,资源目录只有512字节app_icon.svg和若干string.json/color.json,全工程没有位图。需要先说明边界:界面上的48、24.8 ms、8.4%、62分,四条优化建议的7.8/3.6/2.4/1.7 ms,以及四个Trace泳道负载百分比,均是Models.ets里的字面量;exportReport()只关闭对话框并弹toast。本文只讨论这些数值的显示位,不把它们当作真实性能结论。
四层给出的是一套排查顺序:视觉不一致先查令牌;挤爆或空荡先查布局;刷新不对先查契约;换设备就难看先查形态。文中还指出几处可在源码逐行验证的问题:火焰图组件缺一个@Watch,且唯一入参从未被使用;同一个耗时在界面上存了两份、对不上;一个字符串mode牵出五种浮层却只有三处分支;帮助浮层写着五个快捷键,而全工程零个键盘监听。
一、令牌层:颜色与字号决定后三层的稳定性
Theme.ets只有1.3 KB,却决定整个应用的气质。两个类共28个静态成员,其中22个颜色、6档字号。值得肯定的是命名方式:ink/inkSoft/muted/faint是一组文本层级,canvas/surface/paper是一组面层级,line/lineStrong是一组描边层级,accent/lime/cyan/coral/amber/purple是一组语义色,dark/dark2/dark3/darkLine/rail是暗色画布专用另一套。设计令牌应当名字描述用途,不描述数值;如果叫gray100、blue500,换主题就得全局搜字符串。这套色板还体现了桌面数据工具常见的“亮内容+暗画布”双主题共存:浅色卡片用surface,图表和火焰图铺在dark上,accent在浅底做主色、lime在暗底做高亮,把“读”和“看”分开。
问题在于令牌与实际使用脱节。PerfText只有display、metric、title、section、body、caption六档,但在Index.ets里几乎没被引用,绝大多数fontSize()直接写数字。后果有两个:一是无法整体调密度,想让界面在1080p更紧凑、4K更舒展,得改几十处字面量;二是无法响应系统字体缩放。5.5到7这一档本来就小,用户把系统字体放到1.5倍后,中文落在9到10.5之间,勉强可读;但指标卡92 vp、顶栏56 vp、状态栏23 vp这类固定高度容器不会跟着长,文字被裁、行距挤成一团。这不是审美问题,而是可访问性问题:用户为了看清数字放大字体,界面却先崩了。
根源是“令牌=常数”。把令牌改成“令牌=函数”,一行调用就能整体改密度,也能接住系统字号。原文给出的纯ArkTS类不依赖任何Kit,核心如下:- export type Density = 'compact' | 'regular' | 'comfortable';
- export interface TextScale {
- display: number; metric: number; title: number;
- section: number; body: number; caption: number; micro: number;
- }
- export interface LayoutScale {
- topBar: number; statusBar: number; rail: number; sidebar: number;
- inspector: number; metricCard: number; heroChart: number;
- gutter: number; hitSize: number;
- }
- const TEXT_BASE: TextScale = {
- display: 29, metric: 25, title: 16, section: 12,
- body: 10, caption: 8, micro: 7
- };
- const LAYOUT_BASE: LayoutScale = {
- topBar: 56, statusBar: 23, rail: 64, sidebar: 234,
- inspector: 300, metricCard: 92, heroChart: 210,
- gutter: 16, hitSize: 28
- };
- export class DensityTokens {
- static readonly textOf = (density: Density, fontScale: number): TextScale => {
- const factor = density === 'compact' ? 0.92 : density === 'comfortable' ? 1.12 : 1;
- const scale = Math.max(1, Math.min(2, fontScale));
- const grow = (base: number): number => {
- if (base >= 16) {
- return Math.round(base * factor * Math.min(scale, 1.25) * 10) / 10;
- }
- return Math.round(base * factor * scale * 10) / 10;
- };
- const result: TextScale = {
- display: grow(TEXT_BASE.display), metric: grow(TEXT_BASE.metric),
- title: grow(TEXT_BASE.title), section: grow(TEXT_BASE.section),
- body: grow(TEXT_BASE.body), caption: grow(TEXT_BASE.caption),
- micro: grow(TEXT_BASE.micro)
- };
- return result;
- };
- static readonly layoutOf = (density: Density, fontScale: number): LayoutScale => {
- const factor = density === 'compact' ? 0.94 : density === 'comfortable' ? 1.1 : 1;
- const scale = Math.max(1, Math.min(2, fontScale));
- const tall = (base: number): number => Math.round(base * factor * (0.6 + 0.4 * scale));
- const result: LayoutScale = {
- topBar: tall(LAYOUT_BASE.topBar),
- statusBar: LAYOUT_BASE.statusBar,
- rail: LAYOUT_BASE.rail,
- sidebar: Math.round(LAYOUT_BASE.sidebar * factor),
- inspector: Math.round(LAYOUT_BASE.inspector * factor),
- metricCard: tall(LAYOUT_BASE.metricCard),
- heroChart: Math.round(LAYOUT_BASE.heroChart * factor),
- gutter: Math.round(LAYOUT_BASE.gutter * factor),
- hitSize: LAYOUT_BASE.hitSize
- };
- return result;
- };
- }
复制代码 这里有三个设计点。第一,grow对大字号单独限幅:29号字跟着系统放到2倍就是58,一行放不下,限到1.25倍是常见做法,大标题是视觉锚点,不必跟正文一起长。第二,容器高度增长系数是0.6+0.4×scale,比文字慢;字号2倍、容器1.4倍意味着容器“跟不上”,必须配合maxLines与constraintSize让文字自己收敛,而不是让容器无限变高,否则会把整个布局挤出窗口。第三,hitSize不随密度变;它只在桌面形态成立,触摸端要抬到40以上,属于形态层参数而非密度参数。有了这层,PerfText.body那种“令牌归令牌、代码归代码”的裂缝才算堵住一半:只要写代码的人用tokens.textOf(density, fontScale).body,改密度就是改一个入参。
二、布局层:1180 vp断点是一道算术题
工作台骨架由五块固定尺寸加两块弹性区构成。顶栏里有一个290的品牌区,加上中间页签组、右侧三个工具按钮和一个头像,这几项全是固定宽度,没有任何layoutWeight兜底。也就是说,窗口窄到一定程度,顶栏会先于主区溢出。同理,指标卡用layoutWeight(1)四等分,卡内却塞了23号数字、单位、一条90×26火花线、一行7号提示。layoutWeight只会平分剩余空间,它不知道卡里的内容至少需要多宽。这是弹性布局最典型的坑:弹性只保证不溢出容器,不保证内容可读。
Index.ets:970那行判断看起来像拍脑袋,其实可以算。设窗口宽度为W,实时诊断视图需要的水平空间是:- W ≥ rail(64) + sidebar(234) + 主区内边距(32) + 建议面板(326) + 间隙(10) + 主视口最小宽度
复制代码 主视口里最窄的合法内容是四张指标卡。卡本身没有最小宽度约束,但卡内要放下23号数字加单位、一条火花线、一行7号提示,实际观感下限约150 vp一张,四张即600 vp。代入得64+234+32+326+10+600=1266,比1180大。所以在1180到1266这一段,四张卡会被压到130左右,数字与火花线开始挤。1180是由“侧栏要不要留”倒推出来的,不是由“主视口舒服不舒服”正推出来的:它保证侧栏+主视口的最小可用组合,代价是该区间指标卡偏挤。这不是bug,而是一个没有被记录的取舍;代码里没有注释说明数字来源,也没有第二个断点接住1266。这类算术写进代码比写进文档可靠,因为改尺寸的人一定会看到它。
把算术变成代码:输入窗口宽度,输出哪些槽位显示、主视口还剩多少、指标卡几列。纯函数,可单元测试,不碰UI:- export interface Slots {
- showSidebar: boolean;
- showInspector: boolean;
- metricColumns: number;
- mainWidth: number;
- overflow: boolean;
- }
- export interface SlotDemand {
- rail: number; sidebar: number; inspector: number;
- gutter: number; gap: number; minMain: number; minMetricCard: number;
- }
- const DEFAULT_DEMAND: SlotDemand = {
- rail: 64, sidebar: 234, inspector: 326,
- gutter: 32, gap: 10, minMain: 520, minMetricCard: 150
- };
- export class SlotSolver {
- static readonly solve = (windowWidth: number, demand: SlotDemand = DEFAULT_DEMAND): Slots => {
- const fixed = demand.rail + demand.gutter + demand.gap + demand.inspector;
- const minWithSidebar = fixed + demand.sidebar + demand.minMain;
- const minWithoutSidebar = fixed + demand.minMain;
- const showSidebar = windowWidth >= minWithSidebar;
- const base = showSidebar ? fixed + demand.sidebar : fixed;
- const mainWidth = Math.max(0, windowWidth - base);
- const cardRoom = mainWidth - demand.inspector - demand.gap;
- const columns = cardRoom < demand.minMetricCard * 4 ? 2 : 4;
- const result: Slots = {
- showSidebar: showSidebar,
- showInspector: windowWidth >= minWithoutSidebar,
- metricColumns: columns,
- mainWidth: mainWidth,
- overflow: windowWidth < minWithoutSidebar
- };
- return result;
- };
- }
复制代码 它与工程现状的差别有两点。第一,断点不是常数。代入默认值,minWithSidebar=64+32+10+326+234+520=1186,和工程里的1180只差6 vp,说明当初确实按这个思路估过,只是没算上间隙;用求解器,改任何一块尺寸,断点自动跟着走。第二,指标卡从4列退到2列,而不是硬挤。四卡降为两行两列,多占约100 vp高度,但每张卡恢复可读。降级顺序建议写进规范:先收侧栏,再降卡片列数,最后收检查器。理由是侧栏是上下文、卡片是结论、检查器是细节,用户对三者的容忍度依次递减;把结论挤坏而保住细节,是最差的一种取舍。
ArkUI其实有现成容器能承担这件事。SideBarContainer自带showSideBar、sideBarWidth、minSideBarWidth、maxSideBarWidth、autoHide与onChange回调,能把侧栏宽度和自动隐藏交给组件;GridRow/GridCol支持breakpoints按xs/sm/md/lg分档,配span做栅格降级。工程当前是纯手写if (this.windowWidth >= 1180),好处是零学习成本、行为完全可控,坏处是断点值散在视图代码里、只有一档。若继续推进,建议结构性分栏交给SideBarContainer,栅格化指标卡交给GridRow,只有主视口/检查器这一对保留手写,因为它们的规则是一个弹性、一个固定,比栅格更简单直接。这不是“框架更好”的立场问题,而是哪一层的规则更适合用声明式描述的问题。
三、组件契约层:一个字符串mode承载多种浮层的代价
PerformanceDialogs是整个工程里最值得学的一处设计。它对外的契约很小:@Prop mode和targetName两个入状态,onClose、onCreate、onExport三个出事件,其余appName、scenario、sampleRate、recordSeconds、exportFormat、includeTrace、includeAdvice、showOverlay、suspendBackground等全是组件内部状态,标题等派生文案由mode经title()计算。这就是一个标准的受控组件:父层只传模式与目标名,组件内部维护表单状态,通过事件把结果抛回去。
问题也在这里:mode是string,一个字符串牵出五种浮层却只有三处分支。入口与浮层的关系若不清晰,导航结构就会漏。产品把“诊断→火焰图→对比→报告”的方法链压成四个视图加一个浮层,四种mode恰好对应四个入口;一旦mode分支少覆盖一种,帮助浮层写着五个快捷键,全工程却零个键盘监听,就会出现文档与实现脱节。组件契约层要解决的不是样式,而是刷新与行为是否可检查:哪些mode必须渲染、哪些快捷键必须绑定、同一耗时显示位是否只有一份数据源,都应在契约层集中约束。原文提到的ShortcutMap、SnapshotSource等纯ArkTS类,方向就是把缺失能力补成可替换对象;但在改造前,至少应先把mode从散落字符串收敛为可枚举、可校验的契约,并把派生文案与分支覆盖做成集中映射,否则新增一种浮层又会在视图里多一处if。
四、形态层:宽屏规则不是装饰
宽屏的价值不是显示得更多,而是三件事之间的因果关系能同时被看到:曲线上的长帧、Trace里对应的那一列、建议卡里的那条根因,在同一屏内构成一条视线。由此得出一条布局硬要求:三块内容的相对位置必须固定。工程里overviewBody()的顺序是“指标卡行→折线→(Trace+建议面板)”,任何一次重排都会切断这条视线。主视口的排列顺序应当被视为契约,而不是随手可调的装饰。
主视口与检查器的比例也共享同一条规则:主视口吃弹性,检查器吃固定宽度。火焰图视图是layoutWeight(1)配width(300),对比视图是layoutWeight(1)配width(286)。检查器不按比例,是因为它装的是文本(方法名、耗时、结论),宽度一变换行位置就变,信息密度跟着抖;主视口装的是图表,宽度变了只需重算画布坐标,观感稳定。可推广为:装文本的槽位给固定宽度,装图形的槽位给弹性宽度。反过来做,文本被拉成长条,图表被压成缝隙,宽屏上一定难看。
浮层则不是页面的一个分支,它在层级上高于整个工作台:PerformanceDialogs挂在Index最外层Stack里,用一个#8A0A1220的半透明行接管点击。它的尺寸约束、滚动行为、关闭语义都要单独设计,不能沿用页面内布局规则。视觉编码也要能被复述:横轴表达时间、纵轴表达耗时、块宽表达Self Time、色相表达线程归属;四条规则对应位置、长度、宽度、颜色四个视觉通道,必须全应用一致。折线图用珊瑚色表示超阈值,火焰图里的珊瑚色也只能表示状态刷新类开销,不能挪去表达别的语义。跨形态时保住的正是这种一致性,而不是某一组具体像素。
结语:把界面当成工程对象
这四层不是一张架构图,而是一套排障顺序。令牌层让颜色和字号可函数化,DensityTokens把“改密度”收敛为一个入参;布局层让断点可计算,SlotSolver把1180背后的算术显式化,并给出先收侧栏、再降卡片列数、最后收检查器的降级顺序;组件契约层让mode、数据源、快捷键从散落分支变成可检查约束;形态层则要求主视口排列、弹性/固定宽度分工和视觉编码在宽屏与跨形态下保持稳定。鸿蒙PC宽屏工作台的界面工程量,最终就落在这些可验证的取舍上,而不是截图里的观感。 |