随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑

1. 前言

站在玄关打开"随手备忘录"时,我通常只看三件东西:钥匙、工牌、雨伞。物品图鉴有它的用途,但这一刻,我并没有打算翻开它。

界面可以把两个动作分得很清楚,代码却未必如此。首页为了取得一个公共定义,导入了公共入口;公共入口又导出了图鉴;图鉴模块在顶层创建对象,对象的构造器顺手读取主题偏好。用户只打开清单,程序却可能已经开始准备图鉴。

这条依赖链值得检查。上一篇把当前清单读取放进实际启动准备,解决了业务缓存可能陈旧的问题。现在还要向调用者背后追一层:读取是否藏在模块加载过程中?

我们继续使用同一个手机Stage应用,一个entry模块、一个主UIAbility,保留通勤与运动模板、勾选保存、主题偏好和静态物品图鉴。图鉴按需打开,这是产品行为;图鉴是否按需加载,则是实现需要保证的边界。

本篇沿用记录B:dataVersion为2,钥匙已勾选,工牌和雨伞未勾选。勾选以最近一次成功保存为准,不按日期重置,也不表示手机知道物品是否真的装进了包。

我想弄清楚的是:怎样让首页只承担它需要的加载工作,同时不让用户第一次打开图鉴时付出难以接受的等待。

2. 方案

先把依赖画出来,比立即替换import更有帮助。从AbilityStage、主UIAbility和首页入口向下追踪,记录直接导入、公共入口再导出,以及每个模块继续依赖的内容。

源码关系告诉我们哪些模块可能被带入,构建产物和运行记录才能说明实际加载了什么。不能看到一个公共导出文件,就断言它的所有导出都产生了运行成本。

这里有三种值得比较的安排。

安排 加载边界 需要承担的代价
全量静态导入 保留首页到图鉴的静态依赖 可能让启动承担暂时不用的模块工作
图鉴按需导入 用户进入图鉴时再加载相关内容 首次进入图鉴需要等待
首屏必要模块前置 在按需图鉴基础上,将合适的必要模块纳入快启初始化 需要核对普通启动成本与实际复用行为

第三种安排有严格的范围。它考虑的是原本就在启动路径上、首屏必需、没有风险操作的模块。图鉴既然属于用户后续动作,就不能为了增加快启复用内容,又被搬回启动路径。

我会先拆除隐式业务副作用,再比较加载位置。否则,一组读取偏好,另一组没有读取,测出的差异就同时混入了业务行为变化和模块加载变化,难以解释。

三组保留相同的清单B、图鉴条目、图片资源、主题条件、存储适配器和页面绑定。不添加大文件或额外计算来放大结果。这个清单应用本来就轻,收益有限也是有效结论。

默认选择图鉴按需导入。至于必要模块是否值得前置,要等依赖与成本记录给出理由;没有合适的对象,就不增加这一层安排。

3. 实现

应用快启从API24开始提供,快启点内包含AbilityStage模块加载、onCreate和UIAbility模块加载。模块加载期间,顶层代码、类静态初始化等工作可能随之执行。

API26新增的是异步准备回调,并不是动态导入或快启基础机制。本篇继续使用26.0.0基线。

最容易漏掉的读取,往往没有出现在生命周期方法里。考虑这样的封装:

typescript 复制代码
interface PreferenceReader {
  readTheme(): Promise<string>;
}

class CatalogSession {
  readonly initialTheme: Promise<string>;

  constructor(reader: PreferenceReader) {
    this.initialTheme = reader.readTheme();
  }
}

// 若在模块顶层执行,构造就会发起读取。
// export const catalog = new CatalogSession(preferenceReader);

调用者看见的是一个图鉴对象,构造器却已经访问外部状态。即使把页面里的调用挪到正确位置,这次读取仍然由模块求值触发。

同样的检查要覆盖静态字段、静态代码块和单例。它们的共同问题是:业务工作的执行时机由隐含依赖决定,而调用者不容易看出来。

检查位置 需要追问的内容
顶层表达式与顶层实例化 是否读盘、注册监听或建立有状态资源
静态字段与静态代码块 是否缓存当前清单、主题等可变值
公共导出入口 首页是否为了一个小定义带入整个功能
构造器与单例 再次调用是否仍返回初始化时的旧Promise

"静态图鉴"只说明内容固定。承载图鉴的对象仍可能读取偏好,因此这个名字不能替代副作用审计。

我的处理方式是把纯定义、内容取得和展示状态分开。首页使用的模板定义不再经图鉴入口导出;图鉴模块只提供内容,由打开动作决定何时调用。

typescript 复制代码
// CatalogTypes.ets:只放图鉴的数据契约。
export interface CatalogEntry {
  id: string;
  title: string;
  description: string;
}
typescript 复制代码
// CatalogContent.ets:不读取用户清单或主题偏好。
import { CatalogEntry } from './CatalogTypes';

export function createEntries(): CatalogEntry[] {
  return [
    { id: 'key', title: '钥匙', description: '出门前确认随身携带。' },
    { id: 'badge', title: '工牌', description: '通勤时确认是否需要。' },
    { id: 'umbrella', title: '雨伞', description: '按当天出行需要准备。' }
  ];
}

这些图鉴字段独立于清单的id、label、checked。图鉴描述物品,不保存"已经带上"的状态,也不改变SavedChecklist、ReadyModel中的dataVersion。

打开入口通过动态导入取得内容:

typescript 复制代码
import { CatalogEntry } from './CatalogTypes';

export async function loadCatalog(): Promise<CatalogEntry[]> {
  const content = await import('./CatalogContent');
  return content.createEntries();
}

纯类型模块即使保留为依赖,也不应附带业务读取。更关键的是,首页其他路径不能仍然静态导入CatalogContent,否则新增一个动态入口并没有建立完整的延后边界。

这里的函数返回内容,主题则由图鉴页面消费应用当前提供的值,不再由图鉴对象在构造时读取。本篇固定主题条件,环境变化的同步留到后续讨论。

延后加载也把失败带到了交互路径上。打开动作需要表达加载中、成功和失败,并处理用户在等待期间返回首页的情况。

下面的控制器集中管理这段交互。CatalogView是页面适配边界,负责显示状态;它不负责读盘或修改清单。

typescript 复制代码
interface CatalogView {
  loading(): void;
  show(entries: CatalogEntry[]): void;
  failed(): void;
  close(): void;
}

class CatalogController {
  private generation: number = 0;
  private busy: boolean = false;

  constructor(private view: CatalogView) {}

  async open(): Promise<void> {
    if (this.busy) {
      return;
    }
    const request = ++this.generation;
    this.busy = true;
    this.view.loading();
    try {
      const entries = await loadCatalog();
      if (request === this.generation) {
        this.view.show(entries);
      }
    } catch {
      if (request === this.generation) {
        this.view.failed();
      }
    } finally {
      if (request === this.generation) {
        this.busy = false;
      }
    }
  }

  close(): void {
    ++this.generation;
    this.busy = false;
    this.view.close();
  }
}

页面返回或销毁时调用close(),加载期间禁用重复打开。代次检查使旧请求不能重新打开已经关闭的图鉴,也不能清除新请求的忙碌状态。它没有取消底层模块加载,只是撤销了旧请求更新页面的资格。

失败后可以再次发起打开,但这不保证所有错误都能靠重试恢复。尤其是模块求值失败,运行时可能保留失败状态,需要在目标环境核对。页面应保留返回清单的出口,不能让图鉴故障阻断已经可用的清单。

模块缓存与业务缓存也应分开理解。重复打开可能复用已经加载的代码,而当前主题、模板选择和勾选不能因此永久缓存。图鉴第一次打开和第二次打开需要分别记录。

清单准备入口保持原样:

typescript 复制代码
async onAboutToCreateAbilityAsync(): Promise<void> {
  await startup.prepare();
}

startup.prepare()继续负责当前模板、保存记录以及前两篇的失败出口和提交隔离。图鉴不加入它的必要等待列表,页面也不再读取第二遍清单。

AbilityStage接口异步回调返回的Promise成功resolve后,后续生命周期才继续;同时实现同步与异步版本时,仅异步版本生效。不能把这个等待保证套在onCreate()中任意发起的异步导入上。评估模块前置时,必须记录其实际完成位置。

本次链路不需要引入Native库。对于已有so的工程,constructor同样需要检查,但它不改变上述职责划分。

4. 检验

重构应先通过正确性检查,再进入性能比较。图鉴加载更晚,如果同时让清单变旧,就没有讨论收益的基础。

每轮恢复记录B,固定设备、SDK、OS构建、DevEco版本、签名、构建类型、主题和日志设置,用实验ID关联输入、跟踪文件与录屏。不同构建分别建立初始化条件,不假设安装更新后仍保留上一组快启结果。

普通冷启动的操作顺序如下:

  1. 按记录的方式结束进程并重新启动,保留启动分类依据。
  2. 暂不进入图鉴,观察首页框架、清单可读和首次有效勾选。
  3. 第一次打开图鉴,记录点击、加载开始、内容可见和可交互。
  4. 返回首页后再次打开,单独记录重复进入的表现。

在支持的普通冷启动场景中,用Load ETS Files核对实际加载文件,再结合Evaluate、调用栈和源码追查成本。文件自身与依赖耗时应按工具定义解释,不能把重叠区间重复相加。

Launch工具边界:当前不支持应用预加载和应用快启的完整启动分析。因此,快启检验需要独立记录路径和执行行为。缺失泳道意味着这里没有对应分析数据,不能填写为零耗时。

快启开关设置成功也不能证明命中。使用onLaunchFromHyperSnap等路径证据分类;证据不足时保留未分类样本,不自动算作普通启动。只有实际复用与模块执行记录相互对应,才能讨论前置安排的效果。

除了顺利打开,还要覆盖以下路径。

用例 检查内容
只看首页 B正确展示,图鉴未意外进入必要等待,清单只准备一次
加载期间连续点击 不重复发起同一轮准备
加载期间返回,再次打开 旧结果不抢占当前页面
图鉴准备失败 显示失败入口,保存记录不变,仍可返回清单
保存后重开 沿用03的A到B脚本检查数据新鲜度
首次无数据、空清单、读取失败 保留各自的页面含义,不被重构合并

故障注入用于检查错误处理和执行顺序,单独运行。人为延时不进入性能统计;准备函数拒绝,也不能被描述成已经复现了模块导入故障。

成本记录至少保留首页可读时间、图鉴首次打开时间、再次打开时间、内存观察值与采样时点、实际模块加载和证据位置。导入完成、页面绑定和真正上屏是不同事件,日志与视频未经对齐不能直接相减。

多轮结果应保留波动,而不是只挑最快一次。如果首页几乎没有改善,图鉴首次进入却明显变慢,就需要重新评估拆分粒度。如果前置安排拖慢普通启动,也应撤回。加载位置是一项可以调整的设计选择,不必成为必须证明成功的结论。

5. 结尾

物品图鉴的加载问题,要求我们把一条模糊的依赖拆成几个可观察的决定:哪些定义属于首页,哪些行为会访问外部状态,哪些工作应由用户动作触发。

对"随手备忘录",可以把放置规则收在一张表里。

内容 放置位置 判断依据
首页必要的纯定义 首页依赖,可评估安全前置 没有隐式业务操作
当前模板与保存记录 实际启动准备服务 需要最近一次成功保存的数据
静态图鉴内容 图鉴打开入口 不属于首页必要信息
图鉴展示使用的主题 消费当前应用状态 不能沿用构造时缓存的旧偏好

导入依赖图、顶层副作用清单和双路径成本记录,分别回答"带进来什么""执行了什么""用户在哪里等待"。三者放在一起,才能判断一次模块拆分是否合适。

接下来,显式准备函数之间还存在顺序:存储打开后才能读清单,纯模板处理却可能独立进行。下一篇沿这条依赖讨论简单异步函数与AppStartup任务组织;图鉴仍留在用户打开它的那条路径上。

相关推荐
Sirius_Ji7 小时前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207418 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白9 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方1 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追1 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追1 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue1 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追1 天前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos