HarmonyOS | 状态管理(七) | AppStorage(应用级UI状态存储)

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

#harmonyos #华为 #AppStorage

系列文章目录

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

文章目录

前言

上一篇文章讲解了页面级状态存储，本篇文章我们来看看应用级状态存储。

一、AppStorage 是什么？

AppStorage是应用全局的UI状态存储，是和应用的进程绑定的，由UI框架在应用程序启动时创建，为应用程序UI状态属性提供中央存储。

二、AppStorage关联的两个装饰器

@StorageProp:@StorageProp(key) 和AppStorage中key对应的属性建立单向数据同步
@StorageLink:@StorageLink(key) 和AppStorage中key对应的属性建立双向数据同步

1.@StorageProp

AppStorage.SetOrCreate('Prop',60)

@Entry
@Component
struct StoragePropPage {
最低0.47元/天 解锁文章

200万优质内容无限畅学
HarmonyOS NEXT应用开发之AppStorage：应用全局的UI状态存储
1
04-03 2043
AppStorage是在应用启动的时候会被创建的单例。它的目的是为了提供应用状态数据的中心存储，这些状态数据在应用级别都是可访问的。AppStorage将在应用运行过程保留其属性。属性通过唯一的键字符串值访问。AppStorage可以和UI组件同步，且可以在应用业务逻辑中被访问。AppStorage支持应用的 主线程 内多个UIAbility实例间的状态共享。
HarmonyOS实战开发：AppStorage-应用全局的UI状态存储
2401_84194030的博客
04-22 2151
AppStorage是应用全局的UI状态存储，是和应用的进程绑定的，由UI框架在应用程序启动时创建，为应用程序UI状态属性提供中央存储。
聊聊鸿蒙开发里的 AppStorageV2：全局状态管理好帮手
最新发布
2401_86731168的博客
07-10 1009
首先咱们定义一个要共享的数据类，用 @ObservedV2 装饰，这样数据变化时 UI 才能同步更新。// 用@Trace装饰的属性，修改时会触发UI刷新// 没有@Trace，修改时不会自动刷新UI这里 p1 用 @Trace 装饰了，p2 没有，后面咱们会看到它们的区别。AppStorageV2 作为 API 12 新增的全局状态管理工具，给鸿蒙应用开发带来了很多便利。全局唯一的 UI 状态存储，从 API 12 开始支持。
【HarmonyOS NEXT】应用状态：LocalStorage/AppStorage/PersistentStorage
weixin_71403100的博客
03-04 3860
如果要实现应用级的，或者多个页面的状态数据共享，就需要用到应用级别的状态管理的概念。
鸿蒙Harmony--AppStorage--应用全局的UI状态存储详解
袁震的博客
01-13 5174
无所求必满载而归，当你降低期待，降低欲望，往往会得到比较好的结果，把行动交给现在，用心甘情愿的态度，过随遇而安的生活，无论结果如何，都是一场惊喜的获得!
HarmonyOS 应用级状态管理（LocalStorage、AppStorage、PersistentStorage）
weixin_46087056的博客
10-16 2150
【代码】HarmonyOS 应用级状态管理（LocalStorage、AppStorage、PersistentStorage）
鸿蒙HarmonyOS 5.0开发：AppStorage：应用全局的UI状态存储
m0_73088370的博客
12-10 1250
本文仅介绍AppStorage使用场景和相关的装饰器：@StorageProp和@StorageLink。
玩转HarmonyOS NEXT之AppStorage应用全局UI状态存储
断线的风筝
07-16 1270
AppStorage是应用全局的UI状态存储，是和应用的进程绑定的，由UI框架在应用程序启动时创建，为应用程序UI状态属性提供中央存储。AppStorage是在应用启动的时候会被创建的单例。它的目的是为了提供应用状态数据的中心存储，这些状态数据在应用级别都是可访问的。AppStorage将在应用运行过程保留其属性。属性通过唯一的键字符串值访问。和。
HarmonyOS | 状态管理(八) | PersistentStorage(持久化存储UI状态)
让 学习 成为一种 习惯 ( 谭祖爱 & 技术博客 )
02-29 2362
PersistentStorage的作用是：应用退出再次启动后，依然能保存选定的结果。
HarmonyOS-AppStorage：应用全局的UI状态存储
2301_81624474的博客
01-15 2099
AppStorage是在应用启动的时候会被创建的单例。它的目的是为了提供应用状态数据的中心存储，这些状态数据在应用级别都是可访问的。AppStorage将在应用运行过程保留其属性。属性通过唯一的键字符串值访问。AppStorage可以和UI组件同步，且可以在应用业务逻辑中被访问。AppStorage中的属性可以被双向同步，数据可以是存在于本地或远程设备上，并具有不同的功能，比如数据持久化（详见这些数据是通过业务逻辑中实现，与UI解耦，如果希望这些数据在UI中使用，需要用到和。
AppStorage：应用全局的UI状态存储
2302_77228054的博客
06-10 622
AppStorage是与应用进程绑定的全局UI状态存储中心，由UI框架在应用启动时创建，将UI状态数据存储于运行内存，实现应用级全局状态共享。 作为应用的“中枢”，AppStorage是持久化数据PersistentStorage和环境变量Environment与UI交互的中转桥梁。其核心价值在于为开发者提供跨ability的大范围UI状态数据共享能力。
OpenHarmony 应用全局的 UI 状态存储：AppStorage
OpenHarmony_dev的博客
10-18 1275
AppStorage 是在应用启动的时候会被创建的单例。它的目的是为了提供应用状态数据的中心存储，这些状态数据在应用级别都是可访问的。AppStorage 将在应用运行过程保留其属性。属性通过唯一的键字符串值访问。AppStorage 可以和 UI 组件同步，且可以在应用业务逻辑中被访问。AppStorage 中的属性可以被双向同步，数据可以是存在于本地或远程设备上，并具有不同的功能，比如数据持久化（详见这些数据是通过业务逻辑中实现，与 UI 解耦，如果希望这些数据在 UI 中使用，需要用到和。
鸿蒙应用开发-应用状态存储（LocalStorage、AppStorage..）
m0_56255097的博客
03-06 2041
`LocalStorage` 是页面级的UI状态存储，通过 `@Entry` 装饰器接收的参数可以在页面内共享同一个 `LocalStorage` 实例。 `LocalStorage` 也可以在 `UIAbility` 内，页面间共享状态
鸿蒙——数据持久化存储（AppStorage、PersitentStoreage、数据库、首选项）
热门推荐
priest44的博客
06-16 1万+
1.localStorage是页面级数据存储，在页面中创建实例，组件中使用@LocalStorageLink和@LocalStorageProp装饰器修饰对应的状态变量，绑定对应的组件使用比状态属性更灵活。appStorage是进程级数据存储，进程启动时自动创建了唯一实例，在各个页面组件中@StorageProp和@StorageLink装饰器修饰对应的状态变量。localStorage和appStorage数据存取都是在主线程进行的，且api只提供了同步接口，存取数据时要注意数据的大小。
第6章第16节：使用@AppStorage将属性的值同步到UserDefaults [SwiftUI快速入门到实战]
互动教程网[www.hdjc8.com]
09-08 560
SwiftUI 2.0带来的@AppStorage属性包装器，可以很方便的将属性的值同步到UserDefaults中。 定义一个属性，它拥有一个默认值，并且使用了@AppStorage属性包装器，这样对该属性的存储和读取操作，都将映射到键名为nickname的UserDefaults中。 添加一个文本视图，用来显示属性的值。 接着添加一个按钮，并设置按钮的标题。 当点击这个按钮时，给属性设置一个新的值。并打印位于UserDefaults中的键名为nickname的值。 增加..
【鸿蒙开发】应用状态管理LocalStorage，AppStorage，PersistentStorage
d312697510的博客
04-10 1851
鸿蒙开发arkts，应用状态管理，LocalStorage页面级UI状态存储，AppStorage应用全局的UI状态存储，PersistentStorage持久化存储
[HarmonyOS] 鸿蒙开发中的状态管理
m0_64365896的博客
04-08 2591
组件树的根节点（被@Entry装饰的@Component），可以被分配一个LocalStorage实例，其所有的子组件将自动获得对该LocalStorage实例的访问权限；LocalStorage支持UIAbility实例内多个页面间状态共享；应用程序可以创建多个LocalStorage实例，LocalStorage实例可以在页面内共享，也可以通过GetShared接口，实现跨页面、UIAbility实例内共享；
HarmonyOS | 状态管理(六) | LocalStorage(页面级UI状态存储)
让 学习 成为一种 习惯 ( 谭祖爱 & 技术博客 )
02-28 2658
1.LocalStorage实例可以在页面内共享，也可以通过GetShared接口，实现跨页面、UIAbility实例内共享。 2.@LocalStorageProp 装饰的变量与LocalStorage中给定属性建立单向同步关系。 3.@LocalStorageLink 装饰的变量与LocalStorage中给定属性建立双向同步关系。 4.通过windowStage.loadContent设置LocalStorage的属性，可以在多个页面共享该属性值。
系统架构设计图 分层架构 应用层：ArkUI实现跨设备界面适配 业务逻辑层：Java/JS实现核心功能模块 数据层：使用HarmonyOS的RelationalDB关系型数据库存储图书/用户数据 服务层：通过分布式调度实现多设备协同（如手机预约座位→大屏显示） 分布式能力应用 图书信息同步：利用分布式数据管理实现手机/平板/PC多端数据同步 电子书服务：基于分布式文件系统实现跨设备文件共享 座位状态更新：使用分布式软总线实时同步座位占用状态
03-25
<think>嗯，用户想了解分层系统架构设计，特别是基于HarmonyOS的几个层次：应用层、业务逻辑层、数据层和服务层，以及分布式能力的应用。首先，我需要明确每个层次的具体职责和使用的技术。应用层提到ArkUI跨设备适配，ArkUI是华为的UI框架，支持不同设备的界面适配，可能需要解释如何利用其响应式布局和组件库来适应不同屏幕尺寸。接下来是业务逻辑层，用户提到了Java和JS，这部分需要说明核心功能模块如何用这两种语言实现，比如业务逻辑处理和数据转换。数据层的HarmonyOS RelationalDB，需要介绍它的特点，比如关系型数据库，支持分布式数据管理，如何存储图书和用户数据。服务层涉及分布式调度和多设备协同，可能需要解释分布式任务调度如何分配任务，以及如何利用分布式软总线进行实时通信。 然后，分布式能力部分，用户提到了图书信息同步、电子书服务的分布式文件系统，以及座位状态更新的实时同步。这里需要结合HarmonyOS的分布式数据管理、分布式文件系统和软总线来具体说明。比如，分布式数据管理如何实现跨设备的数据同步，分布式文件系统如何管理电子书资源，软总线如何保证低延迟的状态同步。 还需要考虑引用站内的资料。引用[1]提到了公共能力层，包括UI组件、数据管理等，可以对应到应用层和数据层的设计。引用[3]的三层架构优缺点，可能帮助解释分层架构的好处，比如解耦和可维护性。引用[4]的Stage模型涉及组件共享和内存优化，可能与应用层的ArkUI设计有关联，说明如何优化跨设备应用的内存使用。 用户可能的需求是构建一个跨设备的图书管理系统，比如电子书阅读和座位状态同步，所以需要强调各层如何协作实现分布式功能。需要确保每个层次的技术选型解释清楚，比如为什么选择RelationalDB，分布式调度如何工作，ArkUI如何适配不同设备。同时，生成的相关问题要围绕分层架构和分布式技术展开，帮助用户深入理解可能遇到的挑战和优化点。</think>### 分层系统架构设计与HarmonyOS实践 #### 一、应用层：ArkUI跨设备适配 1. **跨设备UI设计** 使用ArkUI的响应式布局能力，通过自适应网格系统与百分比布局实现界面元素动态调整。例如，在不同屏幕尺寸下自动切换导航栏模式（平板采用侧边栏，手机采用底部导航）[^4]。 2. **组件化开发** 通过ArkUI的原子化组件库（如`<Text>`、`<Button>`）和自定义组件封装，配合`@Extend`装饰器实现多设备样式扩展： ```typescript @Extend(Text) function adaptiveFont(size: number) { .fontSize(size * vp2px) .fontFamily(this.deviceType === 'wearable' ? 'Sans' : 'Serif') } ``` 3. **状态同步机制** 利用`AppStorage`实现跨设备UI状态管理，结合分布式数据对象（DistributedObject）同步阅读进度等数据[^4]。 #### 二、业务逻辑层：Java/JS核心模块 1. **功能模块划分** ```plaintext ┌──────────────┐ │ 图书管理模块 │ - ISBN解析/书籍元数据获取 │ 用户服务模块 │ - 认证/权限控制/偏好设置 │ 阅读引擎模块 │ - EPUB解析/排版渲染 └──────────────┘ ``` 2. **跨语言交互** 使用NAPI（Native API）实现JS与Java的通信，例如调用硬件相关功能： ```js const sensor = requireNapi('sensor'); sensor.subscribeAccelerometer(data => { handleDeviceTilt(data.x, data.y); }); ``` 3. **性能优化** 关键路径采用Java实现（如EPUB文件解析），UI交互逻辑使用JS开发，通过Worker线程处理耗时操作[^1]。 #### 三、数据层：HarmonyOS RelationalDB 1. **数据建模** ```sql CREATE TABLE Book ( id INTEGER PRIMARY KEY AUTOINCREMENT, isbn TEXT UNIQUE, metadata BLOB, -- 包含封面/作者/出版社等 last_read_position REAL DEFAULT 0 ); CREATE TABLE User ( uid TEXT PRIMARY KEY, preferences TEXT -- JSON格式存储主题/字体等设置 ); ``` 2. **分布式同步** 启用`SyncMode.FLEXIBLE`实现多设备数据自动同步： ```java RelationalStoreConfig config = new RelationalStoreConfig(context); config.setDistributedSyncMode(SyncMode.FLEXIBLE); config.addConflictResolutionPolicy(ConflictPolicy.LOCAL_WINS); ``` 3. **安全机制** 通过`DataShare`模块实现跨应用数据访问控制，结合HAP签名分级保护敏感数据。 #### 四、服务层：分布式能力整合 1. **多设备协同架构** ```mermaid graph TD A[手机] -->|分布式软总线| B(智慧屏) A -->|分布式调度| C(平板) C -->|分布式文件系统| D(云端存储) ``` 2. **典型场景实现** - **图书信息同步**：使用`DistributedData`模块的KV数据管理 ```java KvManagerConfig config = new KvManagerConfig(context); KvManager manager = KvManagerFactory.getInstance().createKvManager(config); ``` - **电子书服务**：基于`DistributedFile`的跨设备文件访问 ```js const fileURL = 'dfile://device_id/path/to/book.epub'; fs.open(fileURL).then(fd => { readEpubMetadata(fd); }); ``` - **座位状态更新**：通过`DistributedSchedule`实现毫秒级同步 ```java DistributedScheduler.getInstance().register(this, new StatusCallback() { @Override public void onChanged(DeviceStatus status) { updateSeatMap(status); } }); ``` #### 五、性能优化策略 1. **渲染优化** 使用ArkUI的`LazyForEach`实现动态列表懒加载，配合`RecycleView`复用机制降低内存占用。 2. **数据同步优化** 采用差异同步策略，通过`RelationalDB`的`ChangeTracker`监听数据变更： ```java db.registerObserver(tableName, new DataChangeListener() { void onChange(ChangeEvent event) { if (event.getType() == ChangeType.UPDATE) { sendDeltaChanges(event.getModifiedRows()); } } }); ``` 3. **分布式调度QoS** 根据任务类型动态调整优先级： ```java DistributedTaskRequest request = new DistributedTaskRequest.Builder() .setPriority(TaskPriority.HIGH) // 实时座位状态更新 .setNetworkType(NetworkType.WIFI_P2P) .build(); ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

打赏作者

谭祖爱

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

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

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

打赏作者

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

抵扣说明：

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

余额充值