【万能转换器|06】HarmonyOS ArkTS 历史记录实战:去重保存换算结果并支持清空
【万能转换器|06】HarmonyOS ArkTS 历史记录实战:去重保存换算结果并支持清空
证据边界:本文基于
D:\huawei\one3(万能转换器)当前源码做静态核对。“当前事实”来自 History 模型、HistoryRepository、HistoryService、ConvertPage、HomePage、HistoryPage 与 SettingsPage;“建议实现”和“验收设计”均明确标注。本轮未执行构建、模拟器、真机、故障注入或性能采样。

历史记录不是“把几行文字追加到数组”这么简单。对单位转换和实用计算器来说,同一个输入可能被连续计算多次;首页只想展示最近三条,记录页要按转换、计算和收藏筛选;用户还需要单条删除、批量删除、全部清空,并希望重启应用后记录仍在。如果每个页面各存一份列表,去重、排序和删除很快就会互相打架。
“万能转换器”的真实源码把历史链路拆成模型、仓库、服务和页面四层:History.ets 定义持久化结构与容错反序列化,HistoryRepository.ets 使用 ArkData Preferences 保存整组 JSON,HistoryService.ets 负责去重、收藏、删除和 AppStorage 广播,HomePage.ets、HistoryPage.ets、SettingsPage.ets 则通过共享状态展示最近记录或执行清空。
本文面向 HarmonyOS 5.0 及以上版本,基于这些真实源码解释“同一次事件”如何定义、为什么写盘后要广播新数组、清空为何必须确认,以及当前实现中 200 条上限、批量删除、失败回滚和 payload 恢复仍有哪些边界。不会虚构云同步、账号漫游、平台访问量或已经不存在的恢复能力。
一条历史记录的写入顺序
业务页面只构造 AddRecordPayload;HistoryService 负责复合去重和队首更新,Repository 完成整表写入与 flush,成功后再广播 recentHistory 的新数组引用。

历史记录的职责边界
模型、业务页面、Service、Repository、Preferences 和 AppStorage 各自只承担一类变化,页面不直接操作存储,Repository 也不决定业务去重规则。

一、历史记录保存的是业务事件,不只是展示文案
真实 HistoryItem 同时包含路由语义、展示语义和持久化元数据:
export interface HistoryItem {
id: string;
schemaVersion: number;
kind: HistoryKind;
type: string;
title: string;
summary: string;
payload: string;
createdAt: number;
favorite: boolean;
}
其中 kind 只有两个值:
export type HistoryKind = 'convert' | 'calc';
convert 表示通用单位转换,calc 表示 BMI、年龄、角度、欧姆定律等计算器。type 再细分到长度、温度、BMI 等具体工具。title 和 summary 用于列表展示,payload 保存去重或未来恢复输入所需的 JSON 字符串,favorite 则让记录页能够过滤收藏。
这种结构比只存一句“1 m = 100 cm”更稳。展示文案可以随版本变化,而事件身份和路由类型仍能独立存在。
二、四层架构避免页面直接操纵存储
这条历史链路的职责可以这样划分:
业务页面 / 表单
↓ AddRecordPayload
HistoryService
↓ HistoryItem[]
HistoryRepository
↓ JSON string
Preferences
UI 不调用 preferences.getPreferences();Repository 不判断两条记录是否重复;Service 不负责画空状态和确认弹窗。每层只有一个主要变化原因:
- 模型变化时修改
History.ets。 - 存储介质或容量策略变化时修改 Repository。
- 去重、收藏和删除规则变化时修改 Service。
- 展示、筛选和交互变化时修改页面。
源码中 HistoryRepository 的注释也明确写着“不做任何业务,拼摘要、去重等放在 HistoryService”。这条边界是本文最值得复用的部分。
三、为什么历史列表适合 Preferences
Repository 使用单独的 Preferences 文件和单个键:
const PREF_NAME = 'app_history';
const KEY_ITEMS = 'items';
const MAX_ITEMS = 200;
保存时把整个 HistoryItem[] 序列化为一个 JSON 字符串:
async saveAll(items: HistoryItem[]): Promise<void> {
const store = this.ensureReady();
const trimmed = items.slice(0, MAX_ITEMS);
await store.put(
KEY_ITEMS,
serializeHistory(trimmed)
);
await store.flush();
}
对于上限 200 条、主要按时间倒序整表读取的本地工具历史,这种方案实现简单,不需要表结构、索引和迁移脚本。页面也没有复杂查询,筛选是在内存中完成。
但这不是“历史数据永远都该用 Preferences”的通用结论。若记录数量增长到数万、需要日期范围查询、统计聚合、分页、跨设备冲突合并或单条事务更新,关系型存储更合适。当前选择成立的前提是数据小、查询简单、完全本地。
四、Repository 通过 ensureReady 把初始化错误显式化
Repository 构造时只保存 Context,真正取得 Preferences 由 init() 完成:
async init(): Promise<void> {
if (this.store) return;
this.store = await preferences.getPreferences(
this.context,
PREF_NAME
);
}
其他方法首先调用:
private ensureReady(): preferences.Preferences {
if (!this.store) {
throw new Error(
'HistoryRepository not initialized; call init() first.'
);
}
return this.store;
}
这里没有用“store 为空就静默返回”,而是让调用顺序错误明确暴露。对于持久化服务,这比假装保存成功更容易定位问题。
HistoryService.init() 会先初始化仓库、读取全部记录,再创建单例:
const repo = new HistoryRepository(context);
await repo.init();
const items = await repo.loadAll();
const svc = new HistoryService(repo);
svc.cache = items;
HistoryService.instance = svc;
AppStorage.setOrCreate<HistoryItem[]>(
APPSTORE_KEY,
items
);
如果读取失败,单例不会提前发布,调用 HistoryService.get() 也会抛出“未初始化”错误。真实 EntryAbility.onCreate() 发起异步初始化并记录失败日志,但没有等待完成;冷启动直达历史相关页面时仍需要关注初始化时间窗口。
五、加载时统一按 createdAt 倒序
Repository 从 Preferences 读出 JSON 后,先反序列化,再按 createdAt 降序排序:
async loadAll(): Promise<HistoryItem[]> {
const store = this.ensureReady();
const raw = await store.get(
KEY_ITEMS,
''
) as string;
const items = deserializeHistory(raw);
items.sort(
(a: HistoryItem, b: HistoryItem) =>
b.createdAt - a.createdAt
);
return items;
}
这样即使旧版本写入顺序异常,启动后仍能恢复“最近优先”的显示语义。Service 在新增或命中重复时也把记录移动到队首,因此运行期和重启后的顺序保持一致。
需要注意,排序只发生在加载阶段;Service 默认相信自己的 cache 已按最近优先维护。任何绕过 Service 直接修改 Preferences 的代码,都可能破坏运行期不变量。
六、业务页面负责构造摘要和 payload
以 ConvertPage 为例,页面离开时会验证输入非空且是有限数值,然后构造摘要:
const summary = firstOther
? `${trimmed} ${fromUnit.symbol} = ` +
`${firstOther.display} ${firstOther.unit.symbol}`
: `${trimmed} ${fromUnit.symbol}`;
const payload = JSON.stringify({
fromKey: this.fromKey,
value: trimmed
});
随后调用统一服务:
HistoryService.get().add({
kind: 'convert',
type: this.convertType,
title: this.pageTitle,
summary,
payload,
});
BMI、年龄、角度等表单也采用同一个 add() 接口,只是 payload 结构由各自业务决定。Service 不解析 BMI 身高或长度单位,它只把 payload 当作稳定的事件键和扩展字段。
这条边界让不同计算器可以独立演进。Service 不需要为每个工具增加一个方法。源码顶部注释中的旧示例提到 addConvert(),而当前真实 API 是通用 add();文档与测试应跟随实际接口,避免照抄过期注释。
七、去重身份为什么是 kind + type + payload
HistoryService.add() 查找重复记录时使用三个字段:
const dupIdx = this.cache.findIndex(
(x: HistoryItem) =>
x.kind === p.kind &&
x.type === p.type &&
x.payload === p.payload
);
这意味着:
- 相同长度转换类型、相同源单位、相同输入值会被视为同一事件。
- 长度转换和面积转换即使 payload 文本相同,也不会互相去重。
convert和calc之间不会冲突。- 同一工具只要 payload 不同,就会保留为不同记录。
没有把 summary 放进去重键是合理的。摘要可能因为格式化精度、单位名称或本地化文案变化而改变;业务输入才更适合作为事件身份。
同时要理解字符串比较的边界:payload 是 JSON 字符串,字段顺序、空格和数值文本都会影响相等性。{"value":"1","fromKey":"m"} 与 {"fromKey":"m","value":"1"} 语义相同但字符串不同。当前 payload 都由受控代码按固定顺序生成,所以问题不明显;如果未来允许外部导入,应对 payload 做规范化或构造专门的 dedupKey。
八、命中重复后保留 id 和收藏状态
命中重复事件时,Service 不创建新 ID,而是重建记录:
const updated: HistoryItem = {
id: existing.id,
schemaVersion: HISTORY_SCHEMA_VERSION,
kind: p.kind,
type: p.type,
title: p.title,
summary: p.summary,
payload: p.payload,
createdAt: now,
favorite: existing.favorite,
};
this.cache.splice(dupIdx, 1);
this.cache.unshift(updated);
这个更新有三个语义:
createdAt改成当前时间,重复事件回到队首。title和summary使用最新格式。favorite保留,不会因为再次计算而丢失收藏。
保留 ID 也有利于 ArkUI 列表复用和后续单条操作。否则同一业务事件每次都换 ID,收藏、选中状态和动画都更难保持连续。
九、新事件的 ID 可用,但不是强唯一算法
新记录 ID 由毫秒时间戳和 0 到 999 的随机后缀组成:
export function newHistoryId(): string {
const t = Date.now();
const r = Math.floor(
Math.random() * 1000
);
return `${t}_${r}`;
}
对于用户手动触发的本地工具记录,短时间发生冲突的概率不高,且去重通常先拦截重复事件。但它并不提供数学上的强唯一保证:同一毫秒创建大量不同记录时,随机后缀仍可能碰撞。
当前场景可以接受这种轻量方案;如果未来增加批量导入、后台生成或跨设备合并,应换成平台 UUID、单调序列或“设备标识 + 时间 + 随机”的更强 ID 策略。本文不能把“低概率”描述成“绝不重复”。
十、200 条上限只裁剪持久化副本
Repository 的 saveAll() 使用:
const trimmed = items.slice(0, MAX_ITEMS);
所以写进 Preferences 的最多是前 200 条。可是 Service 的 cache 在新增后没有同步裁剪:
this.cache.unshift(item);
await this.repo.saveAll(this.cache);
this.broadcast();
这会产生一个容易被忽略的真实边界:当前运行会话内,cache 和 AppStorage 可能超过 200 条;重启后从 Preferences 加载时才恢复为最多 200 条。换句话说,源码实现的是“持久化上限 200”,不是严格的“内存列表永远不超过 200”。
如果产品要求两者一致,裁剪应在 Service 维护 cache 不变量时完成,或者 Repository 返回实际保存后的列表。否则用户可能在长时间不重启的会话里看到第 201 条,重启后它又消失。
十一、为什么广播时一定复制数组
Service 在仓库写入成功后调用:
private broadcast(): void {
AppStorage.set<HistoryItem[]>(
APPSTORE_KEY,
this.cache.slice()
);
}
slice() 创建新数组引用。HomePage 和 HistoryPage 都使用:
@StorageLink('recentHistory')
recentHistory: HistoryItem[] = [];
或:
@StorageLink('recentHistory')
history: HistoryItem[] = [];
如果只在原数组上 splice()、unshift(),再把同一个引用交给 AppStorage,ArkUI 的响应链可能无法稳定识别变化。复制新数组是一个很小但关键的状态更新规则。
首页只展示:
this.recentHistory.slice(0, RECENT_LIMIT)
其中 RECENT_LIMIT = 3。记录页则读取完整共享列表,再在内存中过滤。两者共享真源,但拥有不同展示投影。
十二、记录页的四种筛选不需要四份数据
HistoryPage 只有一份 history,根据子 Tab 计算展示列表:
switch (this.activeTab) {
case 'convert':
return this.history.filter(
(x: HistoryItem) => x.kind === 'convert'
);
case 'calc':
return this.history.filter(
(x: HistoryItem) => x.kind === 'calc'
);
case 'favorite':
return this.history.filter(
(x: HistoryItem) => x.favorite
);
case 'all':
default:
return this.history.slice();
}
“全部 / 转换 / 计算 / 收藏”只是派生视图,不是四个持久化集合。这避免了收藏切换时还要同步多张表。
页面还为不同空状态提供不同文案:
全部、转换、计算为空:暂无记录
收藏为空:还没有收藏
这是重要的错误/空状态设计。数据为空不是加载失败,收藏为空也不应提示“使用任意工具”;它应该告诉用户点击星标即可收藏。
十三、ForEach key 为什么包含 favorite、编辑态和选中态
记录页的 ForEach key 不只使用 ID:
(item: HistoryItem) =>
`${item.id}:` +
`${item.favorite ? 1 : 0}:` +
`${this.editMode ? 1 : 0}:` +
`${this.selected.indexOf(item.id) >= 0 ? 1 : 0}`
源码注释说明,这是为了让星标变化时重建该行,避免 ArkUI 复用旧子树。编辑模式和选中状态也被纳入 key,复选框变化可以稳定反映到 UI。
这是一种针对当前 Builder 结构的实际修复策略,但也有代价:状态变化会让行节点被重建,可能影响动画和性能。更理想的长期方案是让行组件明确接收响应状态,减少把多个 UI 状态编码进 key。不过在当前数据规模下,这个做法直观且可复核。
十四、清空操作为什么必须二次确认
记录页的“清空”只在非编辑态、非锁定 Tab 且确实有数据时出现。点击后先展示不可撤销提示:
AlertDialog.show({
title: '清空所有记录',
message: '此操作不可撤销,确定要清空全部历史记录吗?',
primaryButton: {
value: '取消',
action: () => {},
},
secondaryButton: {
value: '清空',
action: () => {
HistoryService.get()
.clearAll()
.then(() => {
promptAction.showToast({
message: '已清空',
duration: 1500
});
})
},
},
});
Service 的 clearAll() 会清空全部记录,注释明确写着“含收藏”:
async clearAll(): Promise<void> {
this.cache = [];
await this.repo.clear();
this.broadcast();
}
SettingsPage 的“清除缓存”也调用同一个方法,并显示记录数量。这说明历史记录与收藏记录不是两套存储:收藏只是 HistoryItem 上的布尔字段,全部清空会一起删除。
十五、清空成功提示与失败反馈的真实边界
页面只在 clearAll() Promise 成功后显示“已清空”或“已清除”,避免仓库失败却提前报成功。失败分支会写日志:
.catch((err: Error) => {
console.error(
`[History] clear failed: ${err.message}`
);
});
当前源码没有用户可见的“清空失败,请重试”,也没有按钮禁用或处理中状态。因此不能把失败重试写成现有功能。
产品级增强可以增加 clearing 状态,确认后暂时禁用重复触发,失败时保留列表并显示 Toast。更重要的是,Service 当前先把 cache 设为空数组,再调用 Repository。如果 repo.clear() 失败,Service 内存已经为空,但 AppStorage 因为没有执行 broadcast 可能仍显示旧列表,内存、UI 和磁盘会出现分歧。事务顺序需要进一步治理。
十六、add、remove、toggleFavorite 也存在失败回滚问题
add() 在写盘前对 this.cache 执行 splice/unshift;toggleFavorite() 在写盘前替换数组元素;remove() 在写盘前用 filter() 生成新 cache。随后才调用 Repository。
以删除为例:
async remove(id: string): Promise<void> {
this.cache = this.cache.filter(
(x: HistoryItem) => x.id !== id
);
await this.repo.saveAll(this.cache);
this.broadcast();
}
如果 saveAll() 抛错,broadcast 不会发生,但 Service cache 已经改变。后续操作会基于未落盘的新 cache 继续执行。更稳妥的写法是先创建 next 副本,持久化 next 成功后再赋给 cache 并广播:
const next = this.cache.filter(
(x: HistoryItem) => x.id !== id
);
await this.repo.saveAll(next);
this.cache = next;
this.broadcast();
这段是改进建议,不是当前源码。核心原则是“先构造下一状态,持久化成功后提交内存状态”,让 Preferences、Service cache 和 AppStorage 尽量保持原子一致。
十七、批量删除目前是逐条整表落盘
记录页编辑模式可以全选或多选。确认后:
for (const id of ids) {
await svc.remove(id);
}
而每次 remove(id) 都会:
- 过滤一次完整 cache。
- 序列化一次完整列表。
- Preferences put 一次。
- flush 一次。
- AppStorage broadcast 一次。
删除 50 条就可能产生 50 次整表写盘和 50 次 UI 广播,且中途失败会形成部分删除。当前上限只有 200,普通使用未必明显,但算法和事务语义都不理想。
可扩展方案是在 Service 增加 removeMany(ids: string[]),用 Set 一次过滤、一次写盘、一次广播。页面也应捕获批量删除异常,失败时不要直接退出编辑模式或显示完整成功数量。
十八、payload 当前用于去重,但没有真正恢复输入
模型注释写着 payload 保存“重新打开时所需参数”。实际 HistoryPage.handleRowTap() 只根据 kind 和 type 跳转:
if (item.kind === 'convert') {
pushConvert(
item.type as ConvertType,
item.title
);
} else if (item.kind === 'calc') {
pushCalc(
item.type as CalcType,
item.title
);
}
它没有解析 item.payload,也没有把 fromKey、value、BMI 身高体重等参数传给目标页。HomePage.openHistory() 也是同样的路由方式。
因此当前真实能力是“点击历史重新进入对应工具”,不是“恢复当时完整输入状态”。payload 已经为后续恢复保留了数据,但还缺路由参数契约、目标页解析和版本兼容。文章若把注释直接当成功能,会产生不可复核的夸大。
要实现完整恢复,需要:
HistoryItem.payload
↓ 按 kind/type 解码
RouteParams
↓ 页面 aboutToAppear
字段合法性校验
↓
恢复输入并重新计算
解码失败时应进入默认状态,而不是让旧记录阻止页面打开。
十九、反序列化已经容错,但运行时校验还不完整
deserializeHistory() 会处理空字符串、非法 JSON、非数组结构,并为旧记录补齐 schemaVersion、payload、createdAt 和 favorite:
favorite: x.favorite === true
JSON 解析失败会记录日志并返回空数组,避免应用因历史损坏直接崩溃。
不过当前代码把解析结果直接断言为 HistoryItem[],没有逐项验证:
kind是否为convert或calc。type是否属于当前路由联合类型。title、summary是否为字符串。createdAt是否为有限时间戳。- ID 是否重复。
如果数组中存在 null,访问 x.id 会抛错,外层 catch 会让整组历史都返回空数组,而不是只丢弃坏记录。更成熟的迁移器应该逐项校验、跳过损坏条目、记录迁移统计,并根据 schemaVersion 执行明确版本转换。
二十、针对去重和清空最值得写的测试
在当前项目测试目录中没有检索到针对 HistoryService/Repository 的专门测试。优先级最高的不是截图测试,而是规则和失败路径。
去重用例:
同 kind + type + payload:
数量不增加
createdAt 更新
移动到队首
id 保持
favorite 保持
payload 不同:
新建记录
新记录位于队首
kind 或 type 不同:
不去重
持久化用例:
loadAll 按 createdAt 倒序
非法 JSON 返回空列表
旧记录缺 favorite 时补 false
saveAll 只落盘前 200 条
clear 删除 items 键并 flush
一致性用例:
saveAll 失败时 cache 不应提交
clear 失败时 UI 和 cache 不应清空
批量删除只写盘一次
广播必须产生新数组引用
重启后内存数量与磁盘上限一致
再加两条路由测试:点击历史能进入正确工具;在“完整恢复”尚未实现前,不应断言旧输入已恢复。
二十一、多设备列表验收要关注底部编辑栏
历史页使用全屏根容器、List、文本单行省略和 constraintSize({ minWidth: 0 }),对长标题、长摘要和窄屏有基本防护。四个子 Tab 目前横向排列,手机小窗、大字体和语言扩展时需要确认不会挤出屏幕。
编辑模式底部栏固定高度 56vp,但源码没有在这段组件中显式计算系统底部手势区避让。面向 HarmonyOS 5.0+ 多设备验收应覆盖:
手机竖屏:长摘要省略,星标可点击
手机横屏/小窗:四个子 Tab 不重叠
大字体:标题、时间、星标不互相遮挡
平板与 2in1:列表宽度不过分拉伸
深色模式:收藏金色、次要文本和背景有足够对比
编辑模式:底部删除栏不进入系统手势区
空状态:切换四个子 Tab 后文案正确
清空弹窗:取消与清空按钮含义清晰
批量删除和清空都属于不可撤销操作,确认弹窗是审核与体验的必要保护。失败时的用户提示则仍需补齐。
二十二、隐私与上架说明必须匹配真实实现
本文核验的历史链路使用本地 Preferences,保存工具类型、标题、摘要、payload、时间和收藏状态。它没有在这些文件中调用网络、账号或云同步 API,也不需要为历史功能新增敏感权限。
这不等于可以推断整个应用没有任何网络行为;上架材料仍需对完整包、权限和 SDK 做一致性检查。针对历史功能,隐私说明应准确描述“换算和计算记录保存在本地,可由用户删除”,不能声称账号同步或多设备漫游。
清空路径有两处:记录页“清空所有记录”和设置页“清除缓存”。二者都调用 HistoryService.clearAll(),因此审核说明与帮助文档应统一描述其结果:删除全部历史,包括已收藏的历史记录。
二十三、可复用的本地历史架构清单
将这套模式迁移到搜索历史、最近文件或本地操作日志时,可以复用以下检查:
- 用结构化模型保存事件,不只保存文案。
- 明确定义复合去重键。
- 重复事件更新到队首,并决定是否保留收藏。
- Repository 只负责存储,不承载业务规则。
- Service 维护唯一内存 cache。
- 持久化成功后再广播新数组引用。
- 内存上限和磁盘上限必须一致。
- 清空、删除和收藏都要设计失败回滚。
- 批量操作应一次提交,而非循环整表写盘。
- payload 恢复必须有真实路由与校验链路。
- 反序列化要逐项校验和版本迁移。
- 不可撤销操作提供确认和可见失败反馈。
这份清单的核心是状态一致性:磁盘、Service cache、AppStorage 和页面不能各说各话。
二十四、把“能保存”拆成四个一致性检查
静态阅读能够证明模型字段、去重条件、调用顺序和页面绑定存在,却不能直接证明每一次运行都保持一致。历史记录真正要守住的是四份状态:业务页面刚构造的事件、HistoryService 的 cache、Preferences 中的 JSON,以及 AppStorage 暴露给页面的新数组。任意一份提前提交或落后,用户就会遇到“当前能看到,重启后消失”“列表删除了,磁盘仍保留”或者“磁盘只剩 200 条,页面却继续显示更多”的分裂状态。
第一项检查是去重契约。准备两条 kind、type、payload 完全相同但 title 或 summary 不同的输入,第二次 add 后数量应保持不变,原 id 和 favorite 应保留,createdAt、title、summary 更新,并移动到队首。随后只修改 payload,再次 add,数量应增加。这个用例能证明身份由复合键决定,而不是由展示文案决定。
第二项检查是写入失败。让 saveAll 或 flush 抛错,观察 Service cache、AppStorage 和重新读取的 Preferences。当前源码先 splice/unshift 修改 cache,再等待 Repository;失败时不会执行 broadcast,但 cache 已经改变。下一次成功操作可能把这份未确认的变更一起落盘。因此验收结论应写成“页面未广播假成功,但 cache 缺少回滚”,不能笼统写“失败安全”。更稳的建议实现是在临时数组中计算 nextItems,保存成功后再赋给 cache 并广播。
第三项检查是容量边界。连续写入超过 200 条互不重复的事件后,当前 Repository 只把 items.slice(0, 200) 序列化,Service cache 不会随之裁剪。此时首页和记录页可能仍从 AppStorage 看见 200 条以上,而杀进程重启后只恢复 200 条。测试必须同时记录运行中数量、Preferences 实际条数和重启后数量。若产品规则就是最多 200 条,应由 Service 提交前统一裁剪,或由 Repository 返回最终落盘数组,避免内存与磁盘采用两套上限。
第四项检查是不可撤销操作。记录页清空和设置页清除缓存都应先展示数量与不可撤销提示,点击取消后数据不变,点击确认并等待 Repository 成功后才显示成功 Toast。还要覆盖失败分支:磁盘清除失败时列表应保留,并出现用户可见提示。批量删除则应验证只提交一次;当前实现循环调用 remove,会对 N 条选择执行 N 次整表写入和 N 次广播,这是一条可复核的性能与一致性风险,不是已经完成的批量事务。
本轮没有运行项目构建、模拟器、真机、故障注入或性能采样,所以这些内容是基于当前源码得出的验收设计和风险判断,不是已通过的运行结果。正式交付记录应包含初始数据、操作步骤、预期数组、实际 Preferences 值、重启结果、设备类型和失败日志;只有这样,“源码里有历史服务”才能升级为“历史链路在目标环境中可验证”。
二十五、结语:历史记录的难点是身份与一致性
“万能转换器”的历史实现已经具备清晰骨架:Preferences 提供跨启动保存,Repository 集中存储细节,Service 用 kind + type + payload 去重并保留收藏,AppStorage 让首页和记录页同步更新,确认弹窗保护全部清空。
真实源码同时揭示了下一步最有价值的工程改进:把 200 条上限同步到内存、让写入失败不污染 cache、把批量删除改成一次事务、为坏记录做逐项迁移,并真正把 payload 接入页面恢复。把这些边界写清楚,才是一篇可复核的 HarmonyOS 技术文章,而不是把“有历史列表”扩写成不存在的完整能力。
更多推荐



所有评论(0)