HarmonyOS应用实战-启示散页-76-清空数据别只删 Preferences:同步 AppStorage、缓存和恢复账本

发布时间:2026/11/16 6:37:41

HarmonyOS应用实战-启示散页-76-清空数据别只删 Preferences:同步 AppStorage、缓存和恢复账本 HarmonyOS 应用实战 76清空数据别只删 Preferences同步 AppStorage、缓存和恢复账本只删除牌组索引或只删除收藏列表都会留下首页状态、当前牌组或更新时间戳的残留。这个问题不能只靠页面上补一个提示解决因为真正的断点在libraryHAR/src/main/ets/repositories/PreferencesStore.ets、状态字段和服务 owner 之间。下面按现有工程事实展开先看源码再说明风险链路最后给出可以落地的补强方式。这篇解决什么清空与重置角度结论落点当前事实PreferencesStore 提供 remove业务仓储也能按 key 保存和删除牌组。libraryHAR/src/main/ets/repositories/PreferencesStore.ets主要风险只删除牌组索引或只删除收藏列表都会留下首页状态、当前牌组或更新时间戳的残留。重置功能必须列出持久化 owner一次操作覆盖牌组、收藏、历史和 AppStorage 信号。补强方向ResetPlan重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。页面责任清空与重置页面禁止自己拼 key确认框只选择重置范围。对清空与重置来说这张表先把边界固定住当前事实来自libraryHAR/src/main/ets/repositories/PreferencesStore.ets风险落在重置功能必须列出持久化 owner一次操作覆盖牌组、收藏、历史和 AppStorage 信号。补强方案只围绕ResetPlan展开不把问题扩散成泛泛的 HarmonyOS 状态管理讨论。现有代码锚点清空与重置 对应 libraryHAR/src/main/ets/repositories/PreferencesStore.ets下面这段来自The_Book_of_Answers当前工程锚点是async remove。它不是装饰性引用而是判断这篇文章能不能落地的依据。0169}0170try{0171returnawaitthis.store(storeName).has(key);0172}catch(e){0173returnfalse;0174}0175}01760177asyncremove(storeName:string,key:string):Promisevoid{0178conststhis.store(storeName);0179try{0180awaits.delete(key);0181awaits.flush();0182}catch(e){0183consterreasBusinessError;0184hilog.error(DOMAIN,TAG,remove fail %{public}s %{public}s,key,JSON.stringify(err));0185throwerrasError;这段代码说明PreferencesStore 提供 remove业务仓储也能按 key 保存和删除牌组。 所以后续补强不能绕开这个事实如果把清空与重置直接写成页面局部变量第一次交互可能看起来没问题跨页面、重进或发布回归时就会暴露。失败链路问题通常不是突然出现只删除牌组索引或只删除收藏列表都会留下首页状态、当前牌组或更新时间戳的残留。环节内容排查动作触发点用户确认确认输入来自哪里断点重置功能必须列出持久化 owner一次操作覆盖牌组、收藏、历史和 AppStorage 信号。确认服务层有没有拦住外显现象首页仍指向已删除牌组确认页面有没有清楚反馈这张断点表是给清空与重置做回归时用的。先复现触发点再检查重置功能必须列出持久化 owner一次操作覆盖牌组、收藏、历史和 AppStorage 信号。是否存在最后看用户能不能从首页仍指向已删除牌组这种现象里得到下一步动作。先排除误区清空与重置 不是页面补丁遇到清空与重置最容易犯的错是先在页面里加一个局部状态让当前场景看起来正常。这个做法短期能遮住现象但不会处理首页仍指向已删除牌组这类断点。临时做法看起来解决了什么后续会留下什么页面里直接改State当前界面刷新了服务和仓储没有真实状态保存失败后直接返回用户看不到报错数据可能没有写入每个入口各写一份判断某个页面正常其他入口继续出错只看成功路径操作流程很顺失败分支无法复现functionunsafeHandleArticle76(reason:string):void{if(!reason){return;}promptAction.showToast({message:reason});// 只提示不收口下一次进入仍可能遇到同一个 清空与重置 问题。}这段反例的目的不是讲语法而是提醒边界清空与重置的根因要回到重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。页面只能表达反馈不能替服务层决定数据是否已经可靠。按照图里的顺序看真正要拦住的是这一句重置功能必须列出持久化 owner一次操作覆盖牌组、收藏、历史和 AppStorage 信号。 只要这个点没有收口用户看到的现象就会在刷新、保存、返回、导入或发布时反复变化。责任边界清空与重置 不该由谁兜底PreferencesStore 只做底层 key 操作ResetService 负责编排页面只展示确认和结果。层级应该负责不应该负责页面页面禁止自己拼 key确认框只选择重置范围。直接改底层 key 或吞掉失败服务重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。让每个页面复制一套规则仓储/配置只保存和读取真实数据理解页面交互语义排查清空与重置时先问 owner再问信号最后才看样式。像首页仍指向已删除牌组通常不是单纯的 UI 细节而是currentDeckId 没有回写默认值没被服务层收住。状态模型ResetPlan建议把这件事压成一个明确模型。下面代码是建议补强不表示当前工程已经存在同名接口。interfaceResetPlan{deckKeys:string[];// 需要删除的牌组相关 keyfavoriteKeys:string[];// 收藏相关 keyhistoryKeys:string[];// 问题历史 keyappStorageKeys:string[];// 运行时刷新信号 key}functioncreateResetPlan(input:PartialResetPlan):ResetPlan{return{deckKeys:Array.isArray(input.deckKeys)?input.deckKeys:[],favoriteKeys:Array.isArray(input.favoriteKeys)?input.favoriteKeys:[],historyKeys:Array.isArray(input.historyKeys)?input.historyKeys:[],appStorageKeys:Array.isArray(input.appStorageKeys)?input.appStorageKeys:[],};}ResetPlan至少要能回答三个问题输入从哪里来、失败怎么表达、成功之后谁刷新。字段少一点没关系但不能让页面靠猜来决定页面禁止自己拼 key确认框只选择重置范围。。提交顺序清空与重置 要先有提交点把状态模型写出来以后还要约束提交顺序。否则接口名字很好看实际调用仍可能在页面、服务和仓储之间来回绕。页面先收集用户动作只生成ResetPlan或等价输入。服务读取必要的当前状态执行重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。。通过边界后再写仓储、Preferences 或运行时信号。页面根据结果展示成功、失败、刷新或恢复入口。asyncfunctionsubmitArticle76(state:ResetPlan):Promisevoid{constresult:ResetPlanResultawaitcommitResetPlan(state);if(!result.ok){ResetPlanNotice(result.reason);return;}AppStorage.setOrCreate(article76ChangedAt,result.changedAt);}这个顺序的价值在失败分支。只要清空与重置没通过服务闸门就不应该提前写入运行时信号也不应该让页面表现得像已经保存成功。服务闸门先判断能不能提交清空与重置的服务层应该先判断边界再执行写入或刷新。下面的写法把reason返回给页面是为了让收藏页不刷新能被解释而不是只弹一个“失败”。interfaceResetPlanResult{ok:boolean;reason:string;changedAt:number;}functionexplainResetPlan(state:ResetPlan):string{if(state.deckKeys.length0){returndeckKeys 不能为空;}return;}asyncfunctioncommitResetPlan(state:ResetPlan):PromiseResetPlanResult{constreason:stringexplainResetPlan(state);if(reason){return{ok:false,reason,changedAt:Date.now()};}return{ok:true,reason:ready,changedAt:Date.now()};}这里的关键是清空与重置不满足边界时不要写仓储也不要悄悄修改运行时状态。先返回原因页面再决定展示刷新、重试、回退还是放弃入口。页面接入提示可以清楚规则不要搬到 UI页面要做的是把用户动作表达清楚。比如页面禁止自己拼 key确认框只选择重置范围。这类信息适合放到 UI但真正的校验和写入顺序仍然应该在服务层。BuilderfunctionResetPlanNotice(reason:string){if(reason){Column({space:8}){Text(清空与重置).fontSize(16).fontWeight(FontWeight.Medium)Text(reason).fontSize(13).fontColor(AppColor.danger)}.padding(12).border({width:1,color:AppColor.danger}).borderRadius(AppRadius.md)}}这种接入方式对清空与重置有一个好处页面可以保持轻量服务仍然是规则 owner。以后再加列表页、设置页、恢复页或发布回归也不用围绕ResetPlan复制判断条件。结构收口从源码到验证只走一条线清空与重置的结构图要能互相对应源码锚点证明当前事实ResetPlan描述新增边界服务规则决定提交方式验证点证明清空收藏后收藏页列表立即为空。没有被吞掉。验证路径成功和失败都要跑序号验证点1清空收藏后收藏页列表立即为空。2清空牌组后默认牌组被恢复并成为当前牌组。3清空历史后问题输入建议不再出现旧问题。4重置过程中失败时不应显示已完成状态。Write-Host查看 清空与重置 的源码锚点rg-nasync\ remove|ResetPlanD:\ProgramData\huawei\lesson\The_Book_of_Answers\libraryHAR\src\main\ets\repositories\PreferencesStore.etsWrite-Host查看相关状态字段rg-ndeckKeys|favoriteKeys|historyKeys|AppStorageKey|AppPrefKey|StorageLink|updatedAtD:\ProgramData\huawei\lesson\The_Book_of_Answers这些命令只能检查清空与重置的源码落点和关键字段不代表已经完成真机交互。涉及清空收藏后收藏页列表立即为空。这种场景时还需要在 DevEco/设备侧补完整流程验证。负向回归清空与重置 要故意跑坏一次只跑成功路径很容易误判。清空与重置至少要准备一组负向样本让服务层证明它会拒绝错误输入而不是靠页面刚好没有触发问题。负向样本期望反应说明缺少deckKeys返回明确原因不写仓储验证主输入不是默认通过触发首页仍指向已删除牌组保留当前页面状态验证失败分支不会静默返回模拟LastFavoriteUpdateAt 未更新页面显示下一步动作验证用户能继续处理重复执行提交结果保持一致验证服务闸门能承受重进asyncfunctionrunNegativeArticle76(state:ResetPlan):Promisestring{constresult:ResetPlanResultawaitcommitResetPlan(state);if(result.ok){returnunexpected success;}returnresult.reason;}这组负向样本能把清空与重置从“看起来能用”推进到“失败时也能解释”。写文章时把这部分放出来读者才能按自己的工程复现。常见问题先定位断点现象常见原因优先检查首页仍指向已删除牌组currentDeckId 没有回写默认值重置后调用 SeedLoader.ensureCurrentDeck收藏页不刷新LastFavoriteUpdateAt 未更新重置结束写 AppStorage 信号历史记录残留漏删 QuestionHistoryPrefKey.List用 ResetPlan 管住 owner key遇到清空与重置的异常时不要先改样式。先确认是哪一层没有交接页面是否保留deckKeys服务是否统一处理规则仓储或配置是否留下旧值运行时信号是否发出。落地顺序先最小闭环再补体验在libraryHAR/src/main/ets/repositories/PreferencesStore.ets附近确认当前链路避免改错文件。增加ResetPlan或等价状态模型字段只保留能解释失败的部分。把清空与重置的规则放到服务层页面只展示原因和下一步动作。跑成功路径和失败路径特别是清空收藏后收藏页列表立即为空。。constregressionForArticle76:string[][清空收藏后收藏页列表立即为空。,清空牌组后默认牌组被恢复并成为当前牌组。,清空历史后问题输入建议不再出现旧问题。];收口清空与重置 的处理方法可以压成一句话PreferencesStore 只做底层 key 操作ResetService 负责编排页面只展示确认和结果。 当前工程已经有可依赖的源码基础文章里的新增接口和函数属于建议补强真正落地时优先保持 owner 清楚再补页面反馈。结论内容边界可以直接复用PreferencesStore 提供 remove业务仓储也能按 key 保存和删除牌组。libraryHAR/src/main/ets/repositories/PreferencesStore.ets建议新增ResetPlan重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。暂不声明真机行为、CSDN 上传、发布结果没有实际执行就不写成已完成容边界———可以直接复用PreferencesStore 提供 remove业务仓储也能按 key 保存和删除牌组。libraryHAR/src/main/ets/repositories/PreferencesStore.ets建议新增ResetPlan重置服务先删除用户数据再重新跑 SeedLoader最后写 currentDeckId 和更新时间戳。暂不声明真机行为、CSDN 上传、发布结果没有实际执行就不写成已完成
延伸阅读

更多相关文章

2026/11/14 23:29:09

认知三论 · 认知总作用量方程深入研究报告

认知三论 认知总作用量方程深入研究报告 作者:方见华 单位:世毫九实验室 摘要 本报告基于此前提出的以黄金比例\boldsymbol{\Phi\frac{1\sqrt{5}}{2}}为贯穿常数的认知总作用量方程,开展底层数学自洽性、认知现象学映射、主流科学范式对接、…

2026/11/9 15:06:47

【面向对象】面向对象设计原则:SOLID五大原则

考点频率:★★★★★(上午选择题必考,下午题设计类图时也常需体现这些原则) 难度:⭐⭐⭐ 建议:重点理解每个原则的核心含义和软考常考表述,能根据场景判断是否违反了某条原则1️⃣ 为什么要学SO…

2026/11/16 10:00:53

Windows-build-tools终极指南:3分钟搞定Windows开发环境配置

Windows-build-tools终极指南:3分钟搞定Windows开发环境配置 【免费下载链接】windows-build-tools :package: Install C Build Tools for Windows using npm 项目地址: https://gitcode.com/gh_mirrors/wi/windows-build-tools 还在为Windows上编译Node.js原…

2026/11/16 19:30:23

电工证复证在哪里复审网上查询最靠谱的流程

电工证复证在哪里复审网上查询最靠谱的流程 怕考不过白交培训费?电工证复审不是走过场,网上查询靠谱流程必须掌握! 很多学员在准备电工证复审时,总担心自己交了培训费却因为流程出错或资料不全导致复审失败,白白浪费时间和金钱。其实只要掌握好…

2026/11/16 19:30:23

汽车电工证哪里查 一线电工没空复习怎么应对

汽车电工证哪里查 一线电工没空复习怎么应对 工地太忙根本没时间复习考试,很多一线电工尤其是汽车电工,天天在车上、在车间、在工地上跑,根本没时间去准备考试,更别提查证了。但问题来了, 汽车电工证在哪考…

2026/11/16 19:30:23

大理州电工证如何考到通过率揭秘

大理州电工证如何考到通过率揭秘 学历不高怕报不上名?别慌!大理州电工证考到其实门槛并不高,关键是你有没有掌握方法。今天我就从一个干了10年应急领域老手的角度,告诉你 大理州电工证如何考到…

2026/11/16 19:30:23

衡水考电工证报名电话怎么考,郑州报考避坑指南全攻略

衡水考电工证报名电话怎么考,郑州报考避坑指南全攻略 你是不是也和我一样,找衡水考电工证报名电话的时候,总担心自己被中间人骗了?别急,今天就来聊聊怎么避开那些坑,拿到属于你的电工证,还能少走弯路。 电工证到底有多重要…

2026/11/16 19:30:23

维修电工证的工资待遇多少钱 报考怕被坑的看这篇

维修电工证的工资待遇多少钱 报考怕被坑的看这篇 你是不是正准备考维修电工证,但不知道去哪报名?怕被中介骗钱?更不知道这个证到底值不值, 多少钱 能拿到手,拿到手又值多少钱?别急,我从业这么多年,帮你把这些门道讲清楚。…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/16 0:00:11

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱

黎城电工证查询报名费多少钱 内部消息告诉你怎么避开中介陷阱 你是不是也和我一样,想考电工证,但不知道去哪报名,怕被中介坑?最近网上有不少人问“黎城电工证查询报名费多少钱”,结果一查,信息五花八门,真假难辨。别担心,今天我就从一线从业者的角度…

2026/11/16 0:00:11

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来?

青岛崂山区电工证培训通过率揭秘:外省证书怎么转过来? 之前考的证在外省能不能转过来?这个问题困扰着很多在外地打工的电工,尤其是像南阳卧龙区的建筑工人,他们常年在工地作业,手上持有电工证是基本要求,但很多人因为工作流动性大,担心证书不能转到本…

2026/11/15 4:46:37

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑