一、
在鸿蒙应用开发中，跨页面、跨组件的数据共享是一个常见需求。
想象一下使用者登录后他的使用者名需要在个人中心、订单页面、消息列表等多个地方展示。如果不使用全局状态管理，你需要把使用者名一层层通过路由参数、函数参数等方式传递下去。代码会变得非常冗长且难以维护。话说回来，AppStorage 就是为了解决这类问题而生的。它让你的组件可以随时"连接"到一个全局的数据仓库，直接读写，无需繁琐的中间传递。
AppStorage——一个应用级别的全局 UI 状态存储中心，由 UI 框架在应用启动时自动创建。它的主要作用是让不同页面、不同组件之间能够方便地共享和响应式更新数据。
二、基本用法
初始化与设置
使用 AppStorage.setOrCreate 在应用启动时初始化一个全局状态。如果该 key 已存在则不会覆盖；如果不存在则创建，
onCreate {
// 设置一个全局的登录状态，默认为 false
AppStorage.setOrCreate;// 设置使用者信息
AppStorage.setOrCreate;}
绑定到组件
AppStorage 提供了两种装饰器来将组件变量与全局状态绑定：
-
@StorageProp: 将组件变量与 AppStorage 中的属性进行单向绑定。组件内部修改该变量不会同步回 AppStorage,适合只读场景.
-
@StorageLink:实现双向绑定<./strong>.组件内部修改该变量会自动同步回AppStorage。并触发所有绑定该属性的组件更新.
`@Entry@Component
struct MyComponent {
至于//单向绑定，组件内修改不会影响全局
@storageProp me:string='light';//双向绑定:组件内修改会同步到全局
@storageLink isLoggedIn:boolean=false;}
外部修改
在组件外部,可以通过
`AppStorag.e.set`
`
`直接修改状态。所有绑定了该状态的组件会自动刷新.
`
`//任意位置修改全局状态
`appStorag.e.set;`appStorag.e.set;
`
`
`三,示例:管理使用者登录状态`
`
`以下示例展示如何使用
`appstoragee`
`
`@storageLink`
`<实现一个全局登录状态管理,实现跨页面状态同步.
`
`在应用入口初始化全局状态`
`
`登陆页面建立"
`
`{
#修改@storagelink变量自动同步至appstorag.e this.isLoggedIn=false;}
else{
button
.width
.onclick=>{
#修改@storagelink变量自动同步至appstorag.e this.isLoggedIn=true;router.push({
url这方面，"pages/ProfilePage"
}
Button
.width
.onClick => {
router.push({
说到url。"pages/ProfilePage"
}
}
}
})
}
.width
.height
.justifyContent
}
四、进阶用法与注意事项
删除状体
使用
`appstorae.delete`可以删除某个全局状体.
appStorae.delete&/body&/html&&&&&&&&
注意的观点是，只要通过 @storageProp 或 @storageLink 引了某个键，那么这个键就无法被 delete方法删除。这是为了防止因数据源被意外删除导致UI显异常。此时可以通过 appStorae.set更新其值。
清空与获取所有键
清空所有状体
使用 appStorae.clear可清空 AppStorae中所有状体，此操作不可逆请谨慎使用。typescript
//清空全部球状体
appStorae.clear;
获取所有键名
使用 appStorae.keys获取当前 AppStorae 中所有已存储键名，返回字符串数返便于调试或遍历处理。typescript
//获取全部键名const allKeys:string = appStorae.keys;console.info);
注意事项
-
应程周期的观点是，ApPstoaee在程启动时创建程退出时销毁适合存储程级别球状体。
-
再看数据类型，支持基本类型及Object Array等复杂类型但复杂类型修改需要替换整个对象才能触发响应式更新。按理说，
-
性能考虑这方面。不要大量数据或频繁变化数据全部放入 ApPstoaee建议只存储跨页面共享关键状体。按理说，
-
LocalStoage区别：ApPstoae是程级球单例而LocalStoage是页面级共享存储作域不同。
五
ApPstoae是鸿蒙ArkTs中非常实球状管工具通过 @storageProp和 @storageLink装饰器可比较容易做到跨页面跨构造据分享响应式更新合理使 ApPstoae显著简化程状管逻辑提高开效率。
