随手备忘录手记 03|HarmonyOS 7.0新特性实验:重开始终是旧清单的问题【共创稿事节】【鸿蒙心迹】

1. 前言
出门前,我在“随手备忘录”里勾上钥匙,保存,然后退出。再次打开时,我期望看到刚才留下的勾。如果钥匙又变成未完成,首先需要查清楚:保存没有成功,还是页面拿到了旧数据?
上一篇处理了读取失败、等待超时和迟到结果。准备服务能够发布明确的结果,旧任务也不能随意覆盖新操作。不过,一次按时完成、字段合法的读取,仍可能返回旧清单。
我们继续使用同一个手机Stage应用:一个entry模块、一个主UIAbility,提供通勤与运动模板,物品图鉴按需打开。本篇固定通勤清单中的钥匙、工牌和雨伞。勾选仍以最近一次成功保存为准,不按日期重置,也不表示手机知道物品是否真的装进了包。
为了追踪数据来源,先定义两份记录。
| 记录 | 数据版本 | 钥匙 | 工牌 | 雨伞 |
|---|---|---|---|---|
| A | 1 | 未勾选 | 未勾选 | 未勾选 |
| B | 2 | 已勾选 | 未勾选 | 未勾选 |
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。
- 写入A,确认钥匙未勾选,工牌和雨伞也未勾选。
- 在初始化缓存方案中,记录初始化读取A的证据,并按接入条件让系统有机会建立可复用结果。
- 通过应用勾选钥匙并保存B,保留保存完成及持久化内容的证据。
- 退出后重新启动,记录操作方式及进程、生命周期信息。
- 核对读取候选、发布模型和实际屏幕是否都对应B。
- 为实际启动读取方案建立独立轮次,重复相同过程。
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链寻找这些工作,再决定哪些内容应该等用户打开图鉴时才加载。
更多推荐




所有评论(0)