HarmonyOS | 状态管理(八) | PersistentStorage(持久化存储UI状态)

最新推荐文章于 2025-06-10 23:00:07 发布
最新推荐文章于 2025-06-10 23:00:07 发布
阅读量2.3k 收藏 52
点赞数 56
CC 4.0 BY-SA版权
分类专栏： Android开发 # [HarmonyOS入门应用开发] 文章标签： harmonyos 华为 Persistent
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/tanzuai/article/details/136348139

系列文章目录

1.HarmonyOS | 状态管理(一) | @State装饰器
2.HarmonyOS | 状态管理(二) | @Prop装饰器
3.HarmonyOS | 状态管理(三) | @Link装饰器
4.HarmonyOS | 状态管理(四) | @Provide和@Consume装饰器
5.HarmonyOS | 状态管理(五) | @Observed装饰器和@ObjectLink装饰器
6.HarmonyOS | 状态管理(六) | LocalStorage(页面级UI状态存储)
7.HarmonyOS | 状态管理(七) | AppStorage(应用级UI状态存储)

文章目录

前言

上一篇我们讲到了应用级UI状态存储(AppStorage),本篇我们来讲下持久化存储UI状态(PersistentStorage)

一、PersistentStorage的作用是什么？

PersistentStorage的作用是：应用退出再次启动后，依然能保存选定的结果。

二、PersistentStorage的特性

  • PersistentStorage将选定的AppStorage属性保留在设备磁盘上。

  • 应用程序通过API，以决定哪些AppStorage属性应借助PersistentStorage持久化。

  • UI和业务逻辑不直接访问PersistentStorage中的属性，所有属性访问都是对AppStorage的访问，AppStorage中的更改会自动同步到PersistentStorage。

  • PersistentStorage和AppStorage中的属性建立双向同步。应用开发通常通过AppStorage访问PersistentStorage。

三、限制条件

PersistentStorage允许的类型和值有

最低0.47元/天 解锁文章

200万优质内容无限畅学
HarmonyOS NEXT应用开发之PersistentStorage：持久化存储UI状态
1
04-03 2737
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。应用程序通过API，以决定哪些AppStorage属性应借助PersistentStorage持久化。UI和业务逻辑不直接访问PersistentStorage中的属性，所有属性访问都是对AppStorage的访问，AppStorage中的更改会自动同步到PersistentStorage。PersistentStorage和AppStorage中的属性建立双向同步。
HarmonyOS第七章：应用状态共享（PersistentStorage、LocalStorage、AppStorage）
to_the_Future的博客
09-19 1822
LocalStorage--一个UIAbility状态（内存--非持久化--非全应用） AppStorage-- 应用内状态--多UIAbility共享（内存--非持久化-退出App应用 数据消失） PersistenStroage--全局持久化状态（写入磁盘--持久化状态-退出App应用 数据不消失）
PersistentStorage：持久化存储UI状态
2302_77228054的博客
06-10 987
PersistentStorage是应用程序中的可选单例对象。此对象的作用是持久化存储选定的AppStorage属性，以确保这些属性在应用程序重新启动时的值与应用程序关闭时的值相同。
鸿蒙开发-UI-应用-状态管理
中年程序员
01-10 1697
上文学习了鸿蒙开发的组件状态，详细分析状态变量与UI渲染交互逻辑，本文将学习鸿蒙开发应用的状态管理。本文学习了鸿蒙开发应用的状态管理，与上文组件状态管理构成整个ArkUI框架提供的状态管理机制，其核心就是UI是状态的运行结果。下文学习UI渲染控制。
【HarmonyOS NEXT】应用状态：LocalStorage/AppStorage/PersistentStorage
weixin_71403100的博客
03-04 3863
如果要实现应用级的，或者多个页面的状态数据共享，就需要用到应用级别的状态管理的概念。
HarmonyOS实战开发：PersistentStorage-持久化存储UI状态
2401_84194030的博客
04-22 969
PersistentStorage是应用程序中的可选单例对象
HarmonyOS NEXT开发笔记：PersistentStorage持久化存储UI状态
wewqeqwrqw的博客
09-10 1211
PersistentStorage和AppStorage中的属性建立双向同步。应用开发通常通过AppStorage访问PersistentStorage，另外还有一些接口可以用于管理持久化属性，但是业务逻辑始终是通过AppStorage获取和设置属性的。
鸿蒙HarmonyOS 5.0开发：PersistentStorage：持久化存储UI状态
m0_73088370的博客
12-10 1355
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。
HarmonyOS NEXT应用开发：ArkTS语言状态管理-PersistentStorage：持久化存储UI状态
ZPYQAQ的博客
01-17 755
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。
鸿蒙Harmony-PersistentStorage--持久化存储UI状态储详解
袁震的博客
01-13 1986
用简单的心境，对待复杂的人生，方能看淡得失，从容入世，潇洒自如，心变得简单了，世界也就简单了
鸿蒙HarmonyOS开发：应用的状态管理，LocalStorage，AppStorage，PersistentStorage
在这里，我乐于倾囊相授，分享我的技术心得、项目实战经验、技术技巧。希望能够惠及更多的开发者，助力大家在技术的海洋中扬帆远航。
08-29 2297
状态共享相关的装饰器（@State、@Prop、@Link、@Provide、@Consume等），但是这些装饰器仅能在两个组件之间共享状态，如果开发者需要在一个页面内的所有组件中共享状态，或者是在多个页面之间共享状态，这些装饰器便不再适用了，此时我们需要的就是应用级状态管理功能。
持久化存储UI状态：PersistentStorage
12-21 414
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。应用程序通过API，以决定哪些AppStorage属性应借助PersistentStorage持久化。UI和业务逻辑不直接访问PersistentStorage中的属性，所有属性访问都是对AppStorage的访问，AppStorage中的更改会自动同步到PersistentStorage。PersistentStorage和AppStorage中的属性建立双向同步。
鸿蒙——数据持久化存储（AppStorage、PersitentStoreage、数据库、首选项）
热门推荐
priest44的博客
06-16 1万+
1.localStorage是页面级数据存储，在页面中创建实例，组件中使用@LocalStorageLink和@LocalStorageProp装饰器修饰对应的状态变量，绑定对应的组件使用比状态属性更灵活。appStorage是进程级数据存储，进程启动时自动创建了唯一实例，在各个页面组件中@StorageProp和@StorageLink装饰器修饰对应的状态变量。localStorage和appStorage数据存取都是在主线程进行的，且api只提供了同步接口，存取数据时要注意数据的大小。
鸿蒙Next持久化存储PersistentStorage用法总结
quietlong的专栏
12-12 1067
PersistentStorage是应用程序中的可选单例对象，用于持久化存储选定的AppStorage属性，确保这些属性在应用程序重新启动时的值与关闭时相同。它将属性保留在设备磁盘上，UI和业务逻辑通过AppStorage访问其属性，AppStorage中的更改会自动同步到PersistentStorage，二者建立双向同步。
【鸿蒙开发】应用状态管理LocalStorage，AppStorage，PersistentStorage
d312697510的博客
04-10 1857
鸿蒙开发arkts，应用状态管理，LocalStorage页面级UI状态存储，AppStorage应用全局的UI状态存储，PersistentStorage持久化存储
鸿蒙OS中的Localstorage、Appstorage及PersistentStorage
qq_47666879的博客
05-26 2384
如果开发者要实现应用级的，或者多个页面的状态数据共享，就需要用到应用级别的状态管理的概念，即Localstorage、AppStorage、PersistentStorage这三个都具有存储数据的功能，可以实现应用级别的数据共享，但是三者的区别和作用不同。：页面级UI状态存储，通常用于内、页面间的状态共享。：特殊的单例LocalStorage对象，由UI框架在应用程序启动时创建，为应用程序UI状态属性提供中央存储。
【每日学点鸿蒙知识】PersistentStorage持久化、插槽方法、相对布局、上拉加载下拉刷新、List联动滑动
轻口味的专栏
12-28 834
可以使用@BuilderParam装饰器，该装饰器用于声明任意UI描述的一个元素，类似slot占位符。参考链接：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-builderparam-V5。比如说A组件经过了锚点配置了位置，此时A组件有一个坐标pos1，经过offset设置了新的位置pos2，B组件想要基于A的新位置pos2做标定，必须要将A组件的offset一并加上才能达到在pos2基础上做标定。
HarmonyOS数据存储之首选项（含源码）
当你发现自己的才华撑不起野心时，就请安静下来学习~
12-02 1352
我们在globalThis对象中定义了一个函数getFontPreferences ，用来获取Preferences实例，该实例包括get,put,has,delete和flush等方法。然后我们在页面加载显示的时候，也就是触发生命周期函数onPageShow方法处，通过我们封装的工具类方法getChangeFontSize()来读取首选项中的字体配置。为了保证App启动后，页面里的字体能正常展示，我们需要在生命周期的onCreate方法里，提前保存下默认的字体大小。本功能初步学完，继续加油！
【鸿蒙实战开发】记录下LocalStorage、AppStorage、PersistentStorage的持久化存储相关
HarmonyOS_002的博客
07-11 1845
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
鸿蒙没有在onwindowstagecreate使用presistentstorage持久化数据，会导致什么情况
最新发布
06-18
<think>首先，用户的问题是：“我想了解在鸿蒙系统中未使用PersistentStorage进行数据持久化可能引发的问题。请问鸿蒙系统onWindowStageCreate不使用PersistentStorage持久化数据会引发什么问题？”用户的问题集中在鸿蒙系统（HarmonyOS）中，如果不使用PersistentStorage进行数据持久化，特别是在onWindowStageCreate方法中，会引发什么问题。从提供的引用中，我可以提取关键信息：-引用[1]：PersistentStorage提供状态变量持久化的能力，持久化和读回UI的能力都需要依赖AppStorage。建议阅读AppStorage和PersistentStorageAPI文档。-引用[2]：PersistentStorage.persistProp用于在PersistentStorage中查找和写入属性值。-引用[3]：PersistentStorage和UI实例相关联，持久化操作必须在UI实例初始化成功后（即loadContent传入的回调被调用时）才能调用。早于该时机调用会导致持久化失败。示例代码显示在onWindowStageCreate的loadContent回调中调用PersistentStorage.persistProp。-引用[4]：描述了应用启动时PersistentStorage如何工作：查询本地文件，写入AppStorage，并在Index组件中使用。-引用[5]：提到了鸿蒙开发的学习资源，但不直接相关。核心点是：PersistentStorage用于持久化存储UI状态，确保数据在应用重启后保留。如果不使用它，数据不会持久化，导致应用状态在重启后丢失。具体到onWindowStageCreate：如果不在这里调用PersistentStorage.persistProp，数据不会被持久化。引用[3]强调了持久化操作必须在loadContent回调中被调用，否则会失败。因此，未使用PersistentStorage可能引发的问题包括：1.**数据丢失**：UI状态（如用户设置、应用偏好）不会在应用重启后保留。用户每次打开应用时，状态恢复到初始值。2.**状态不一致**：如果应用依赖持久化数据（如登录状态、主题设置），未持久化会导致不一致的用户体验。3.**性能或正确性问题**：引用[3]提到，如果早于UI实例初始化调用持久化操作，会导致失败。如果不使用PersistentStorage，但尝试在错误时机访问AppStorage或其他存储，可能引发错误。4.**依赖AppStorage**：PersistentStorage依赖于AppStorage。如果不使用PersistentStorage，AppStorage中的数据不会自动持久化，需要手动处理。5.**最佳实践缺失**：鸿蒙推荐使用PersistentStorage来管理UI状态的持久化，避免手动处理文件存储或数据库操作。现在，构建回答结构：-**清晰结构**：逐步解释问题。先介绍PersistentStorage的作用，然后讨论未使用的后果。-**使用中文**：回答必须使用中文。-**引用标识**：在回答中自然地添加引用标识，如[^1]，基于提供的引用。-**生成相关问题**：在结尾添加相关问题。-**LaTeX格式**：如果涉及数学表达式，但用户问题没有明显数学内容，所以可能不需要。专注于文本描述。回答大纲：1.**引言**：简要解释PersistentStorage的作用。2.**主要问题**：详述未使用PersistentStorage在onWindowStageCreate中的问题。-数据不持久化，状态丢失。-可能导致初始化错误。3.**具体场景**：基于引用，描述正确使用方式（在loadContent回调中调用）。4.**后果总结**。5.**相关问题**：生成几个相关问题。最后，添加相关问题：-例如：如何正确使用PersistentStorage？PersistentStorage与其他存储方式有何区别？如何优化持久化性能？确保回答真实可靠，基于引用。</think>### 鸿蒙系统中未使用 PersistentStorage 持久化数据的问题分析 在鸿蒙（HarmonyOS）开发中，`PersistentStorage` 是用于持久化存储 UI 状态的关键组件，它通过与 `AppStorage` 集成，确保应用状态（如用户偏好、设置或变量）在应用重启后得以保留。`onWindowStageCreate` 方法是应用窗口初始化的入口点，持久化操作通常在此方法的 `loadContent` 回调中被调用（如引用[3]所示）。如果不使用 `PersistentStorage`，特别是在 `onWindowStageCreate` 中未正确调用持久化方法，会引发一系列问题。下面我将逐步分析这些问题，确保回答清晰可靠。 #### 1. **UI 状态丢失，导致用户体验不一致** - **问题描述**：`PersistentStorage` 的核心功能是将 `AppStorage` 中的状态变量（如主题颜色、计数器值或用户配置）持久化到本地文件中。如果未在 `onWindowStageCreate` 的 `loadContent` 回调中调用 `PersistentStorage.persistProp` 方法，应用状态无法保存到本地存储中。这意味着每次应用重启时，UI 状态会恢复到初始值，而不是上次退出时的状态。 - **具体后果**： - 用户设置（如语言偏好或主题模式）不会保留，每次打开应用都需要重新配置，降低用户体验[^1][^4]。 - 对于依赖状态的应用（如游戏进度或表单数据），数据丢失可能导致用户操作中断或错误。 - **示例场景**：假设应用中有一个计数器变量 `aProp`，初始值为 47。如果未使用 `PersistentStorage`，用户修改值后退出应用，再次启动时 `aProp` 会重置为 47，而不是持久化的值[^2][^4]。 #### 2. **初始化时序错误，引发运行时故障** - **问题描述**：`PersistentStorage` 的操作必须严格在 UI 实例初始化成功后执行，即在 `loadContent` 回调被调用时（引用[3]）。如果未在 `onWindowStageCreate` 中正确使用 `PersistentStorage`，但尝试在其他地方（如过早的全局初始化）访问或修改状态变量，可能导致持久化失败或数据不一致。 - **具体后果**： - **持久化失败**：如果早于 `loadContent` 回调调用持久化方法（例如在 `onWindowStageCreate` 的开头），系统无法关联 UI 实例，导致写入本地文件的操作无效，状态无法恢复[^3]。 - **数据竞争风险**：`AppStorage` 依赖 `PersistentStorage` 进行数据同步。未使用持久化时，直接访问 `AppStorage` 可能读取到过时或未初始化的值，引发逻辑错误或崩溃[^1][^4]。 - **代码健壮性下降**：开发者可能需要手动实现文件存储（如 SQLite 或 Preferences），增加代码复杂度和维护成本，且易出错。 #### 3. **性能与效率降低** - **问题描述**：`PersistentStorage` 优化了数据的读取和写入过程，它只在应用启动时从本地文件加载数据到 `AppStorage`，并在状态变化时异步持久化。如果不使用它，开发者需自行处理持久化逻辑，可能导致频繁 I/O 操作。 - **具体后果**： - **启动延迟**：应用启动时需手动加载数据，增加初始化时间，影响用户体验。 - **资源浪费**：重复实现持久化逻辑可能消耗更多内存和 CPU 资源，降低应用性能[^1][^4]。 - **同步问题**：在多组件场景下，状态不一致的风险更高，例如一个组件修改了状态但未持久化，其他组件访问时数据不同步。 #### 4. **违背鸿蒙最佳实践，增加维护难度** - **问题描述**：鸿蒙框架设计 `PersistentStorage` 是为了简化状态管理，它与 `AppStorage` 和 UI 组件（如 `@StorageLink`）深度集成。未使用它意味着偏离官方推荐模式，可能引入兼容性问题。 - **具体后果**： - **升级兼容性风险**：鸿蒙系统更新时，手动实现的持久化方案可能与新 API 不兼容，导致应用崩溃或行为异常。 - **调试困难**：状态丢失或错误更难追踪，因为缺乏 `PersistentStorage` 的内置日志和错误处理机制[^3][^4]。 - **开发效率低下**：开发者需额外关注存储细节，而非专注于业务逻辑，违反鸿蒙的声明式 UI 设计原则[^5]。 ### 总结与建议 未在 `onWindowStageCreate` 中使用 `PersistentStorage` 会导致数据丢失、初始化错误、性能下降和维护困难等问题。为了避免这些，应严格在 `loadContent` 回调中调用 `PersistentStorage.persistProp` 方法（如引用[3]所示），确保状态持久化与 UI 生命周期同步。例如： ```typescript onWindowStageCreate(windowStage: window.WindowStage): void { windowStage.loadContent('pages/Index', (err) => { if (err.code) { return; } // 必须在 loadContent 回调中调用，确保持久化成功 PersistentStorage.persistProp('aProp', 47); // 持久化状态变量 }); } ``` 这样，应用重启时能从本地文件恢复状态，提供一致的用户体验[^3][^4]。如果您有具体代码场景，我可以进一步分析优化方案。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

谭祖爱

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值