仪表卡片包含水量、光照与提醒开关;只改变一个属性时,关注实际依赖它的组件是否更新。判断方案是否可靠,应该先写清楚输入是什么、允许什么变化、失败时应该保持哪些数据不变。

具体到「数值花园」这个页面,对象可观察不等于每个字段都追踪,只添加@ObservedV2而未给属性标@Trace容易出现更新缺口。本文把讨论范围限定在「嵌套对象精确刷新」,不把界面能显示和数据已经被正确处理混为一谈。

技术封面

先建立MetricGarden的契约

先确定「对象可观察不等于每个字段都追踪」的处理界限。只添加@ObservedV2而未给属性标@Trace容易出现更新缺口;具体做法是对真正参与界面依赖的字段逐个配置追踪。验收应观察「更新水量时对应读数能及时刷新」,而不只判断界面是否响应。转到「修改对象引用要谨慎」的路径,也必须遵守同样的数据约束。

把「嵌套对象要看两层」单独列为检查条件,问题更容易识别:外层profile变化与内层metric.waterMl变化不是一回事。实施上建议外层引用和内层属性都建立明确观察关系,目标是单独修改内层数值仍可驱动渲染。还要补测「关闭提醒开关」,其结果应满足提醒状态变化,光照值不被篡改,不能只看首次进入的画面。

对「页面状态最好有负责人」而言,先确定谁负责作出判断。因为多个子组件各持一份用水量会产生相互覆盖,处理时需要以PlantProfile作为统一状态源。这样才有机会得到「卡片与明细共享同一个准确读数」的结果;与之关联的「负值入口必须截断」也应采用一致的责任划分。

数值花园:DevEco Studio 工程代码及页面预览

「无关状态不该牵连」容易被顺利路径掩盖。问题在于修改提醒开关不需要重新解析光照说明,所以应当将各类呈现拆成可定位的子组件。正常结果是后续性能分析有清晰边界;一旦失败,还需保留足以复现的操作状态,特别是「迁移旧V1子组件」这类边界场景。

讨论「修改对象引用要谨慎」时应先识别具体风险:换整个metric实例与只改waterMl触发路径不同。采取「根据业务意图选择原地变更或整体替换」后,预期达到可预测的UI刷新优于碰运气。与此同时,「深层对象需要测试」也可能改变执行条件,不能只用一种固定输入判断是否正确。

状态变更的实现路径

对于MetricGarden这个工程,下面的片段把「对象可观察不等于每个字段都追踪」所需的行为收敛到可以定位的代码上。主要涉及@Trace、@ObservedV2。在MetricView.ets或对应common模块接入时,应明确调用方传入什么,尤其要防止「修改提醒开关不需要重新解析光照说明」这一风险继续影响后续处理。对应的工程措施是「将各类呈现拆成可定位的子组件」,不能只靠页面文字来表示处理成功。

@ObservedV2
class PlantMetric {
  @Trace waterMl: number = 200;
  @Trace sunlight: string = '充足';
  @Trace remind: boolean = true;
}
@ObservedV2
class PlantProfile {
  @Trace name: string = '薄荷';
  @Trace metric: PlantMetric = new PlantMetric();
}
function updateWater(profile: PlantProfile, ml: number): void {
  if (ml < 0) { return; }
  profile.metric.waterMl = ml;
}

被追踪的模型最终要被组件读取,否则仅声明可观察类并不能说明界面如何依赖它。如下页面使用同一PlantProfile实例。

@Entry
@ComponentV2
struct MetricView {
  @Local profile: PlantProfile = new PlantProfile();
  build() {
    Column({ space: 16 }) {
      Text(this.profile.name).fontSize(24)
      Text(this.profile.metric.waterMl.toString() + ' ml')
      Text('光照:' + this.profile.metric.sunlight)
      Button('更新用水量').onClick(() => {
        updateWater(this.profile, 250);
      })
    }.padding(24)
  }
}

这段实现适合先用静态数据检查「嵌套对象要看两层」和「字段格式不能写进模型」两条路径。前者要解决外层profile变化与内层metric.waterMl变化不是一回事,后者要求模型保存数值,展示层添加单位。代码层只承诺得到可解释的状态,真正的展示和持久化要在调用位置按数值花园的业务流程串起来;这样才不会把界面点击当作仓储提交。

还要注意「监听器并非万能」:为每次变化注册复杂副作用反而难以调试。由优先声明依赖,确有外部操作再考虑@Monitor承担这一职责后,其他入口调用相同函数可以得到一致处理。最后用「把水量设成负数」观察更新函数拒绝,模型仍保留合法旧值,检查异常路径是否仍遵守同一语义。

如果计划在此基础上增加新功能,先确认「V1与V2不应随意混搭」是否仍成立。新组件统一采用V2状态契约带来的变化必须被单独验证,而不是假设新增页面会自然继承既有保障。

异常情况下要守住什么

在数值花园里,「字段格式不能写进模型」会影响后续操作。风险是:把200ml的文字直接存进数值字段会限制计算。处理办法是模型保存数值,展示层添加单位。若要确认「未来切换单位不需要迁移数据」,可以安排「替换整个metric对象」作为回归用例,结果须符合页面反映新对象的所有相关属性。

先明确「负值入口必须截断」为什么会失败:来自编辑框的非法数值不应进入状态源。这不是简单刷新界面就能解决的问题,需要在updateWater处集中处理范围条件。验收时不仅要看到「组件不会渲染负数用水量」,还要确认本次操作没有改动其他不相关的数据。

「监听器并非万能」与「嵌套对象要看两层」实际上相互制约。前一条风险表现为为每次变化注册复杂副作用反而难以调试;相应的处理是优先声明依赖,确有外部操作再考虑@Monitor。增加新的操作入口之后,也应该继续满足「渲染路径与业务副作用保持分离」,不能为新页面单独复制一份规则。

数值花园:应用页面与交互布局

从输入与输出看「深层对象需要测试」:输入环节的风险是只测整对象替换掩盖了嵌套字段变动失败,因此先落实分别测试内层赋值和外层重新绑定;输出环节则应验证「能够定位观察链的断点」。结合「连续将水量更新三次」这一操作,预期结果为最终显示最新数字,不累积文本格式,能够帮助定位发生偏差的阶段。

最后审查「V1与V2不应随意混搭」这条约束:两套装饰器语义不同,迁移需有明确范围,因此应当新组件统一采用V2状态契约。只有业务侧明确承担这项责任,避免局部可观察却整体仍依赖旧更新策略才能成为可以长期复核的标准,而不是某次页面渲染的巧合。

用明确的断言代替主观感觉

本节把「数值花园」的验证条件具体化。验证应该以官方接口语义、可见的页面状态与可读取的数据为依据,不能把没有在设备上执行的逻辑检查写成性能实测;需要编译、权限或设备支持的步骤,应在对应开发环境中按项目配置完成。

对「只修改waterMl」做一次中断后重试,记录最后的可见结果是否符合水量卡片更新,其他字段保持原值。这一用例能同时观察「无关状态不该牵连」的边界,重点看后续性能分析有清晰边界,不必预设任何未经采样的性能指标。

完成「替换整个metric对象」之后,直接检查页面反映新对象的所有相关属性。如果失败,不要只保存一张截图,而应记录修改对象引用要谨慎的触发顺序,以及「根据业务意图选择原地变更或整体替换」是否被绕过,这些信息才足以支持修正。

先复现「把水量设成负数」。此时的通过条件应写成「更新函数拒绝,模型仍保留合法旧值」,并对照「字段格式不能写进模型」的约束确认状态来源。如果结果偏离,先检查模型保存数值,展示层添加单位是否真正执行,而不是立即更换页面布局。

数值花园:状态与模块分层

针对「关闭提醒开关」,观察点不仅是操作能否完成,还包括提醒状态变化,光照值不被篡改。建议保留触发前后的业务标识,尤其在「负值入口必须截断」存在时,核对组件不会渲染负数用水量,才能排除旧状态干扰。

把「连续将水量更新三次」独立成一条回归记录:预期最终显示最新数字,不累积文本格式。若出现异常,沿监听器并非万能对应的处理逻辑往回定位,检查是否满足「优先声明依赖,确有外部操作再考虑@Monitor」这一前置条件。

「迁移旧V1子组件」不应被正常路径的检查覆盖。这里必须验证明确输入方式再对照验证,不假设装饰器自动等效,并且确认「深层对象需要测试」相关字段没有出现旁路修改;否则当前页面看似完成了操作,实际数据却仍可能不一致。

下一次修改前要保留的约束

若新需求改变了「V1与V2不应随意混搭」的业务含义,应先检查既有措施「新组件统一采用V2状态契约」是否仍适用,而不是在按钮里临时加分支。此前的「只修改waterMl」也需要重新验证。

把「迁移旧V1子组件」保留为发布前回归项,是因为明确输入方式再对照验证,不假设装饰器自动等效。它和「对象可观察不等于每个字段都追踪」共同约束了数据进入系统以及返回用户界面的两个端点。

在资源、路由和权限问题上,建议以项目实际 target SDK 和设备 API 能力为准。本例围绕 HarmonyOS API 26.0.0 Release 可查证的公共机制组织,代码片段应放入完整 Stage 工程中按开发者文档补齐工程声明和对应资源。页面与技术图使用的示例状态一致,涉及数据写入及生命周期的部分应在 DevEco Studio 中分别执行编译与交互核查。

官方参考

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐