请添加图片描述

1. 前言

出门前,我在“随手备忘录”里勾上钥匙,保存,然后退出。再次打开时,我期望看到刚才留下的勾。如果钥匙又变成未完成,首先需要查清楚:保存没有成功,还是页面拿到了旧数据?

上一篇处理了读取失败、等待超时和迟到结果。准备服务能够发布明确的结果,旧任务也不能随意覆盖新操作。不过,一次按时完成、字段合法的读取,仍可能返回旧清单。

我们继续使用同一个手机Stage应用:一个entry模块、一个主UIAbility,提供通勤与运动模板,物品图鉴按需打开。本篇固定通勤清单中的钥匙、工牌和雨伞。勾选仍以最近一次成功保存为准,不按日期重置,也不表示手机知道物品是否真的装进了包。

为了追踪数据来源,先定义两份记录。

记录数据版本钥匙工牌雨伞
A1未勾选未勾选未勾选
B2已勾选未勾选未勾选

B与前两篇使用的基准状态相同。A是这轮检验的起点:先让初始化接触A,再通过应用保存B,最后重新启动。上一篇勾选工牌的迟到回归用例单独保留,不带入这轮输入。

这给了我们三个观察位置:持久化记录、内存模型和实际屏幕。如果存储里是B,内存却是A,问题出现在读取或发布之前;如果内存已经是B,屏幕仍是A,就应继续检查绑定和渲染。

请添加图片描述

先建立这条证据链,再判断快启是否参与其中,可以少走不少弯路。

2. 方案

缓存有一个隐含条件:在复用期间,缓存内容仍适合当前用途。

纯模板通常容易满足这个条件。通勤模板包含哪些默认物品,可以作为常量复用。用户有没有勾选钥匙则不同,它会在一次普通操作后改变。当前选中了哪个模板,同样属于可变状态。

应用快启应注意初始化期间的磁盘读取。如果初始化读取了A,系统后来复用这部分初始化结果,而应用直接消费其中的业务缓存,持久化记录即使已经变成B,页面仍可能沿用A。

这并不意味着看到旧清单就能判定快启有问题。保存尚未完成、读取器自己保留旧对象、页面没有响应新模型,都可能产生相似现象。

我们比较两种安排。

安排初始化缓存方案实际启动读取方案
纯模板常量复用复用
用户清单初始化时读取,随后消费缓存本次启动准备时读取
主要关注点缓存何时失效必要读取何时完成
失败处理沿用上一篇的结果分类沿用上一篇的结果分类

我倾向于第二种安排。清单很小,而用户打开应用就是为了确认刚才保存的状态。让必要读取进入启动准备路径,是可以解释的成本。

两组使用相同存储适配器、保存流程、页面绑定和等待预算,只改变可变数据的读取位置与缓存使用方式。这样,结果才有助于回答当前问题。

请添加图片描述

准备服务的契约可以写得很具体:在没有并发编辑的这一轮中,成功发布的模型应对应最近一次成功保存的记录;读不到时,发布恢复结果。旧A不能因为结构完整,就被当作本轮成功取得的数据。

普通启动和快启都需要这份契约。因此,两条路径共用 startup.prepare(),不把全部读取放进仅在快启时调用的回调中。

3. 实现

先保留前两篇的边界。ChecklistReader 负责读取,StartupService 协调等待和提交,StartupState 交接结果,主UIAbility负责消费。

本篇为保存记录和页面模型增加 dataVersion。物品字段不变:

interface ChecklistItem {
  id: string;
  label: string;
  checked: boolean;
}

interface SavedChecklist {
  templateId: string;
  dataVersion: number;
  items: ChecklistItem[];
}

interface ReadyModel {
  templateId: string;
  dataVersion: number;
  items: ChecklistItem[];
}

这个字段随记录一起保存,也随模型一起传到页面。它帮助我们追踪来源,但不能代替内容检查:版本都是2,钥匙却显示不同,仍然是错误。

它也不等于上一篇的尝试标识。attempt 回答“哪一次操作有权提交”,dataVersion 回答“这份业务记录属于哪个版本”。二者都不是系统快照ID。

前两篇的类型没有版本字段,因此这轮先建立带版本的A。已有记录的格式迁移需要单独约定;缺少字段不能被解释成首次使用,更不能触发默认模板覆盖。

接着检查读取器。下面这种封装看起来每次都在读,实际却重复返回同一个Promise:

class CachedChecklistReader {
  private initial: Promise<SavedChecklist | undefined>;

  constructor(
    reader: ChecklistReader,
    templateId: string
  ) {
    this.initial = reader.readChecklist(templateId);
  }

  readChecklist(): Promise<SavedChecklist | undefined> {
    return this.initial;
  }
}

如果构造发生在可复用初始化阶段,移动外层调用的位置并没有解决问题。必须追到真正访问存储的位置,检查模块顶层、静态变量、构造器和单例初始化。服务对象可以提前组装,但组装不应顺便读入当前清单。

实际启动准备仍按原来的顺序取得模板和清单。下面保留上一篇的结果类型,只补上版本传递和物品复制:

async function readCandidate(
  reader: ChecklistReader
): Promise<PreparationResult> {
  const templateId = await reader.readCurrentTemplateId();
  const saved = await reader.readChecklist(templateId);

  if (saved === undefined) {
    return new PreparationResult(
      ResultKind.Recovery, Reason.FirstUse
    );
  }
  if (saved.templateId !== templateId) {
    return new PreparationResult(
      ResultKind.Recovery, Reason.InvalidData
    );
  }

  const items: ChecklistItem[] = saved.items.map(
    (item: ChecklistItem): ChecklistItem => ({
      id: item.id,
      label: item.label,
      checked: item.checked
    })
  );

  return new PreparationResult(
    ResultKind.Ready, Reason.None,
    { templateId, dataVersion: saved.dataVersion, items }
  );
}

存储适配器继续负责解析和字段校验,包括版本字段的合法性;undefined 只表示明确没有保存记录。读取拒绝和损坏仍由上一篇的协调层映射为对应结果。

复制物品使候选模型与读取器返回对象分离,避免后续编辑通过共享引用改变那份对象。复制只能隔离对象修改,无法把旧数据变新;读取器本身仍须取得当前持久化记录。

请添加图片描述

生命周期入口保持简短:

async onAboutToCreateAbilityAsync(): Promise<void> {
  await startup.prepare();
}

onLaunchFromHyperSnap(): void {
  console.info('launch.hyperSnap');
}

AbilityStage接口规定,异步准备回调从26.0.0开始提供,返回的Promise成功resolve后,后续生命周期才继续。同时实现同步和异步版本时,仅异步版本生效。

快启基础机制及 onLaunchFromHyperSnap 始于API24。这里暂时只用后者记录路径;确有快启特定资源需要重同步时,再添加相应职责。不在两个回调里各读一遍清单,也不假定返回void的回调会等待异步读取。两者的具体先后仍要由目标环境日志核对。

prepare() 保留上一篇的预算、尝试标识和结案检查。新一轮开始时,历史模型不再具有“本轮已就绪”资格;页面重试通过准备中的交互状态表达等待。读取器只返回候选结果,协调层接受后才发布。超时和迟到路径不会因为增加版本号而消失。

保存也必须有清楚的完成条件。下面的 ChecklistWriter 是应用存储边界,其Promise应在适配器确认本次保存成功后完成:

interface ChecklistWriter {
  save(record: SavedChecklist): Promise<void>;
}

async function saveCheckedKey(
  current: SavedChecklist,
  writer: ChecklistWriter
): Promise<SavedChecklist> {
  const next: SavedChecklist = {
    templateId: current.templateId,
    dataVersion: current.dataVersion + 1,
    items: current.items.map(
      (item: ChecklistItem): ChecklistItem => ({
        id: item.id,
        label: item.label,
        checked: item.id === 'key' ? true : item.checked
      })
    )
  };

  await writer.save(next);
  return next;
}

这里约定钥匙的稳定标识为 key,显示名称仍为“钥匙”。从A调用后得到B,调用方只有在保存成功返回后才能确认新版本已保存。若写入拒绝,就保持错误提示,不能记录“B已保存”。

版本递增采用单写入者、串行保存的前提,不承担并发冲突解决。具体存储API是否需要额外提交或刷新,应由适配器履行;按钮变色和等待固定秒数都不能替代这个契约。

请添加图片描述

4. 检验

我会先保存输入和操作顺序,再看最后的截图。截图只能告诉我们用户看见了什么,无法单独解释数据如何到达那里。

每轮固定设备、SDK26.0.0、OS构建、签名、源码版本及日志配置,并使用独立实验ID。

  1. 写入A,确认钥匙未勾选,工牌和雨伞也未勾选。
  2. 在初始化缓存方案中,记录初始化读取A的证据,并按接入条件让系统有机会建立可复用结果。
  3. 通过应用勾选钥匙并保存B,保留保存完成及持久化内容的证据。
  4. 退出后重新启动,记录操作方式及进程、生命周期信息。
  5. 核对读取候选、发布模型和实际屏幕是否都对应B。
  6. 为实际启动读取方案建立独立轮次,重复相同过程。

A到B再重开之间不要通过安装新构建切换方案,这会改变初始化条件。两个方案分别建立自己的实验轮次。退后台再回前台也不能充当新启动。

请添加图片描述

快启分类需要 onLaunchFromHyperSnap 等实际路径证据。开关设置成功,只说明设置完成;缺少命中日志,也不能在证据不完整时自动判为普通启动。

记录表至少保留实验ID、方案、启动分类及依据、尝试标识、存储版本、读取版本、内存版本、屏幕对应版本、钥匙状态、读取次数和证据路径。屏幕版本可以通过调试标记,或同轮绑定日志与录屏关联取得。绑定完成仍不等于实际上屏。

几条边界路径需要单独检验:

用例需要保持的行为
保存B后普通启动读取并展示B,不依赖快启专属回调
保存B后已确认快启核对旧方案是否消费A,新方案是否取得B
初始化结果失效,B仍保留当前读取仍应取得B
首次安装没有历史记录进入首次使用引导
成功读取合法空清单展示正常空态,不宣称全部带齐
B已保存,但读取拒绝、损坏或超时展示恢复状态,不把A当作当前成功结果
重试成功后旧任务迟到继续遵守提交隔离,不能覆盖新状态
保存B失败以实际最后成功记录为准,不宣称B已持久化

快启管理接口中的 requestRebuildHyperSnap() 可以用于独立的失效检验:它销毁已初始化的快启数据,由系统择机重新初始化。请求返回不表示重建已经完成,更不适合作为每次保存后的修复动作。本篇26.0.0基线也不使用26.0.1 Beta的错误查询接口判定命中。

正常准备应只有一组模板及清单读取,用户主动重试另计。如果日志显示两组,就要检查是否在快启回调、异步准备和页面入口重复加载。

若旧清单没有出现,应保留这个结果,并继续核对是否命中、初始化是否读到A、结果是否已被清理。一次显示B不能证明旧缓存永远有效。对照尚未获得路径证据的部分,应保留为未覆盖;数据正确性也不能直接换算成启动提速。

5. 结尾

重新打开应用后看到旧清单,需要沿保存、读取、发布、显示这条链路定位。版本字段让链路更容易观察,却不会自动保证数据新鲜;真正的保证来自各层履行自己的职责。

在“随手备忘录”中,纯模板可以评估复用,当前模板选择和用户勾选则由实际启动准备统一读取。准备成功后发布完整模型,失败时沿用恢复出口,迟到结果继续接受提交检查。普通启动和快启共享这套安排。

A/B记录、职责分区表和操作脚本共同给出了检验方式:不仅检查页面有没有打开,还要确认页面上的那个勾能追溯到最近一次成功保存。

接下来还要再向里查一层。调用已经移出初始化,读取却可能藏在构造器、静态变量或传递导入中。下一篇从同一个应用的静态物品图鉴入手,沿着import链寻找这些工作,再决定哪些内容应该等用户打开图鉴时才加载。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐