HarmonyOS NEXT应用开发：ArkTS语言状态管理-PersistentStorage：持久化存储UI状态

最新推荐文章于 2025-06-28 12:10:09 发布
原创 最新推荐文章于 2025-06-28 12:10:09 发布 · 743 阅读 · 29 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#harmonyos #华为 #android #前端 #鸿蒙系统 #ArkUI #ArkTS

 往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

PersistentStorage：持久化存储UI状态

前两个小节介绍的LocalStorage和AppStorage都是运行时的内存，但是在应用退出再次启动后，依然能保存选定的结果，是应用开发中十分常见的现象，这就需要用到PersistentStorage。

PersistentStorage是应用程序中的可选单例对象。此对象的作用是持久化存储选定的AppStorage属性，以确保这些属性在应用程序重新启动时的值与应用程序关闭时的值相同。

PersistentStorage提供状态变量持久化的能力，但是需要注意，其持久化和读回UI的能力都需要依赖AppStorage。

概述

PersistentStorage将选定的AppStorage属性保留在设备磁盘上。应用程序通过API，以决定哪些AppStorage属性应借助PersistentStorage持久化。UI和业务逻辑不直接访问PersistentStorage中的属性，所有属性访问都是对AppStorage的访问，AppStorage中的更改会自动同步到PersistentStorage。

PersistentStorage和AppStorag

最低0.47元/天 解锁文章

200万优质内容无限畅学
HarmonyOS NEXT应用开发之PersistentStorage：持久化存储UI状态
1
04-03 2699
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。应用程序通过API，以决定哪些AppStorage属性应借助PersistentStorage持久化。UI和业务逻辑不直接访问PersistentStorage中的属性，所有属性访问都是对AppStorage的访问，AppStorage中的更改会自动同步到PersistentStorage。PersistentStorage和AppStorage中的属性建立双向同步。
鸿蒙HarmonyOS开发之UI数据持久化存储PersistentStorage
qq_14863717的博客
05-11 787
是HarmonyOS提供的一个用于数据持久化的类，它通过键值对的方式存储数据，支持存储基本数据类型和对象。使用可以方便地将应用中的数据保存到本地，并在需要时读取。是HarmonyOS提供的一个强大的数据持久化工具，它使得开发者能够轻松地实现数据的本地存储和读取。通过合理地使用，可以提升应用的用户体验，确保用户数据的安全和连续性。在开发过程中，开发者应当遵循数据最小化原则，合理规划持久化数据的存储和使用。
鸿蒙——数据持久化存储（AppStorage、PersitentStoreage、数据库、首选项）
热门推荐
priest44的博客
06-16 1万+
1.localStorage是页面级数据存储，在页面中创建实例，组件中使用@LocalStorageLink和@LocalStorageProp装饰器修饰对应的状态变量，绑定对应的组件使用比状态属性更灵活。appStorage是进程级数据存储，进程启动时自动创建了唯一实例，在各个页面组件中@StorageProp和@StorageLink装饰器修饰对应的状态变量。localStorage和appStorage数据存取都是在主线程进行的，且api只提供了同步接口，存取数据时要注意数据的大小。
HarmonyOS5/ArkTs 两句话带你零门槛入门持久化存储（面试加分项）
最新发布
SailorMoon.彦的博客
06-28 548
提供了createTransaction()对事务的ACID（原子性、一致性、隔离性、持久性）的支持。事务类型有DEFERRED、IMMEDIATE和EXCLUSIVE，默认为DEFERRED。exclusive：该类型的事务在WAL模式下和IMMEDIATE相同，但在其他日志模式下能够防止事务期间有其他连接读取数据库。提供了对数据的复杂的查询语句和数据过滤，适合需要频繁查询和统计的应用场景。deferred：创建事务的时候不会真正开始事务，只有在事务对象中进行第一次的读或写操作才会开始事务。
鸿蒙持久化存储----PersistentStorage详解
I456456的博客
03-15 884
对PersistentStorage，LocalStorage和AppStorage进行解释
鸿蒙Harmony-PersistentStorage--持久化存储UI状态储详解
袁震的博客
01-13 1966
用简单的心境，对待复杂的人生，方能看淡得失，从容入世，潇洒自如，心变得简单了，世界也就简单了
HarmonyOS NEXT应用开发：ArkTS语言状态管理-AppStorage：应用全局的UI状态存储
ZPYQAQ的博客
01-16 684
本文仅介绍AppStorage使用场景和相关的装饰器：@StorageProp和@StorageLink。
华为HarmonyOS NEXT 原生应用开发: 页面级状态管理 - LocalStorage 和应用级别状态管 - AppStorage && 状态持久化 - PersistentStorage -
Forever_Hopeful的博客
12-10 355
华为HarmonyOS NEXT 原生应用开发: 页面级状态管理 - LocalStorage 和应用级别状态管 - AppStorage && 状态持久化 - PersistentStorage -
HarmonyOS NEXT开发笔记：PersistentStorage持久化存储UI状态
wewqeqwrqw的博客
09-10 1201
PersistentStorage和AppStorage中的属性建立双向同步。应用开发通常通过AppStorage访问PersistentStorage，另外还有一些接口可以用于管理持久化属性，但是业务逻辑始终是通过AppStorage获取和设置属性的。
鸿蒙HarmonyOS 5.0开发：PersistentStorage：持久化存储UI状态
m0_73088370的博客
12-10 1344
PersistentStorage将选定的AppStorage属性保留在设备磁盘上。
鸿蒙应用开发--PersistentStorage在应用启动的时候初始化AppStorage,修改Appstorage会触发PersistentStorage的持久化
2401_88846919的博客
03-06 926
通过持久化关键 UI 状态到AppStorage，开发者可以无缝衔接内存与本地存储，实现应用状态的高效管理和恢复。初始化绑定：通过关联AppStorage属性。组件访问：使用或装饰器读写数据。自动同步：数据修改即时保存，无需手动干预。
【Harmony OS - 应用数据持久化】
weixin_44273311的博客
12-28 2037
鸿蒙系统支持数据持久化的三种方式的基本流程和使用：用户首选项、键值型数据库、关系型数据库
鸿蒙学习-PersistentStorage持久化存储
qq_21434809的博客
11-15 535
PersistentStorage虽然名字和AppStorage、LocalStorage很像，但实际上他不负责存储相关的操作。它的作用其实是声明、或者标记。2.因为是AppStorage中该数据变成持久化存储，所以针对该数据的操作都通过AppStorage来进行操作。通过persistProp声明一个键值对，然后AppStorage存储的该数据就变成了持久化存储了。这句话有几个注意点。1.因为是声明：所以声明一次就好了，建议在 app 启动后就声明。3.声明一定要在 AppStorage使用之前！
[鸿蒙开发] HarmonyOS应用中如何实现数据持久化存储
yihanss的博客
04-28 5088
用户首选项为应用提供Key-Value键值型的数据处理能力，支持应用持久化轻量级数据，并对其修改和查询。其会将数据缓存放在内存中，当用户读取的时候，能够从内存中快速获取数据，当需要持久化的时候可以使用flush接口将内存中的数据写入持久化文件中。为了提升数据读写效率，用户首选项会将所有数据存到内存，随着数据量越多，会导致应用占用的内存越大，因此不适合存放过多的数据，适用的场景一般为应用保存用户的个性化设置等。
鸿蒙（HarmonyOS）网络请求封装，以及token值的持久化存储（AppStorage）
m0_68716163的博客
04-09 1800
外部调用的话就是先导入request这个类，然后直接用类名去调用里面的静态方法以下是我用async，await转成了同步，当然也可以不转直接.then方法也可以，这个看需求。这里可能说的有点绕，所以我直接把那一串枚举截图下来了给大家参考，查看源码也是可以让自己的编程水平还有问题分析能力更上一层楼，这个也是我在一个视频博主那里学到的。网络封装有很多种封装法，这个看个人了，我的话比较习惯拦截器这种的，因为不管后面做什么认证或者一些其他的需求也可以加一些条件进行就可以达到效果了。
HarmonyOS实战开发：PersistentStorage-持久化存储UI状态
2401_84194030的博客
04-22 966
PersistentStorage是应用程序中的可选单例对象
【HarmonyOS NEXT】应用状态：LocalStorage/AppStorage/PersistentStorage
weixin_71403100的博客
03-04 3834
如果要实现应用级的，或者多个页面的状态数据共享，就需要用到应用级别的状态管理的概念。
鸿蒙开发笔记(八):应用状态管理,PersistentStorage,Environment,@Watch, $$的使用
Waruler的博客
01-16 2630
应用状态管理,PersistentStorage,Environment,@Watch, $$的使用
鸿蒙笔记——axios基础封装+PersistentStorage持久化存储登录信息
priest44的博客
06-10 626
【代码】鸿蒙笔记——axios基础封装+PersistentStorage持久化存储登录信息。
鸿蒙AppStorage
03-29
<think>好的，我现在需要回答用户关于HarmonyOS中AppStorage的使用说明及示例的问题。首先，我得回忆一下AppStorage的相关知识，确保自己理解正确。 AppStorage是鸿蒙系统中用于应用全局UI状态存储的机制，应该类似于其他框架中的全局状态管理工具。用户提到需要结合@StorageProp和@StorageLink装饰器使用，这应该是关键点。根据提供的引用，我需要重点介绍这两个装饰器的作用和区别。 接下来，我得组织回答的结构。用户可能需要先了解AppStorage的基本概念，然后是使用场景，接着是具体的使用方法，最后是示例代码。这样结构清晰，逐步深入。 需要注意用户提供的引用中提到，AppStorage与PersistentStorage和Environment配合使用时需要注意一些事项。虽然用户主要问的是AppStorage，但可能需要简要提及这些配合使用的注意事项，不过如果没有具体信息，可能需要避免深入，以免误导。 关于示例部分，应该提供一个实际的代码示例，展示如何定义AppStorage中的属性，并在组件中使用@StorageProp和@StorageLink装饰器来绑定这些属性。需要确保代码语法正确，并解释每一步的作用。 此外，用户的问题可能还涉及到如何实现数据同步、如何持久化存储等方面，但根据引用内容，重点应放在AppStorage本身的使用，所以可能需要强调其作为全局状态存储的角色，而不是持久化细节。 最后，生成的相关问题需要围绕AppStorage的扩展使用、装饰器区别以及与其他模块的协作，这样可以帮助用户进一步探索相关知识。 现在需要检查是否有遗漏点，比如装饰器的具体用法、示例的正确性，以及是否覆盖了用户的需求。同时确保遵循了系统级指令，如正确使用LaTeX格式（虽然这个问题可能不需要数学公式），使用中文回答，结构清晰等。</think>### HarmonyOS AppStorage 使用说明及示例 #### 1. 核心概念 AppStorage 是鸿蒙系统中用于管理 **应用全局UI状态** 的存储机制，通过 `@StorageProp` 和 `@StorageLink` 装饰器实现组件与全局状态的双向或单向绑定[^2]。其特点包括： - **全局唯一性**：所有组件共享同一份状态数据。 - **响应式更新**：状态变化自动触发关联组件的UI刷新。 - **数据类型支持**：支持基础类型（如 `string`、`number`、`boolean`）和复杂对象。 #### 2. 装饰器功能对比 | 装饰器 | 数据流向 | 组件内修改权限 | |----------------|----------------|----------------| | `@StorageProp` | 单向（父→子） | 不可直接修改 | | `@StorageLink` | 双向（父↔子） | 可直接修改 | #### 3. 使用步骤 **步骤1：初始化全局状态** 在 `EntryAbility` 中预定义 AppStorage 的初始值： ```typescript // EntryAbility.ets AppStorage.SetOrCreate<string>('userName', 'HarmonyUser'); AppStorage.SetOrCreate<number>('fontSize', 16); ``` **步骤2：组件绑定状态** 在UI组件中通过装饰器绑定数据： ```typescript // IndexPage.ets @Entry @Component struct IndexPage { @StorageLink('userName') userName: string = ''; @StorageProp('fontSize') fontSize: number = 0; build() { Column() { Text(`用户名: ${this.userName}`) .fontSize(this.fontSize) Button('修改用户名') .onClick(() => { this.userName = 'NewUser'; // 触发全局更新 }) } } } ``` **步骤3：跨组件同步** 其他组件绑定相同键值即可自动同步： ```typescript // ProfilePage.ets @Component struct ProfilePage { @StorageLink('userName') userName: string = ''; build() { Text(`当前用户: ${this.userName}`) // 自动显示最新值 } } ``` #### 4. 持久化扩展 若需持久化存储，可通过 `PersistentStorage` 关联 AppStorage： ```typescript PersistentStorage.PersistProp('userName', 'defaultUser'); ``` 此时 `userName` 在应用重启后仍保留值[^1]。 #### 5. 注意事项 - **数据类型一致性**：需确保组件中变量类型与 AppStorage 定义一致。 - **性能优化**：避免在 AppStorage 中存储过大或高频更新的数据。 - **生命周期**：AppStorage 状态随应用进程终止而销毁，需持久化数据需显式配置。 §§ 相关问题§§ 1. `@StorageProp` 和 `@StorageLink` 在跨组件通信中的具体差异是什么？ 2. 如何通过 AppStorage 实现深层次嵌套组件的状态共享？ 3. AppStorage 与 LocalStorage 在作用域上有何区别？ : HarmonyOS NEXT - AppStorage 与持久化存储的协作 : HarmonyOS 官方文档 - AppStorage 核心功能解析
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值