HarmonyOS 状态管理示例项目

这是一个 HarmonyOS（鸿蒙）应用开发的学习示例项目，主要用于演示 ArkUI 中各种状态管理机制的使用方法。

项目信息

属性	内容
平台	HarmonyOS（鸿蒙）
开发语言	ArkTS
UI 框架	ArkUI
SDK 版本	5.0.0(12)
应用包名	com.example.myapplication

项目结构

entry/src/main/ets/
├── components/          # 可复用组件
│   ├── InfoBottom.ets
│   ├── InfoItem.ets
│   ├── InfoTop.ets
│   ├── LinkChild.ets
│   ├── ObservedChild.ets
│   ├── PropChild.ets
│   ├── ProvideChild.ets
│   ├── ProvideParent.ets
│   ├── RequireChild.ets
│   └── WatchChild.ets
├── models/              # 数据模型
│   ├── CommentData.ets
│   ├── Goods.ets
│   └── GoodsComment.ets
├── pages/               # 页面
│   ├── Index.ets
│   ├── PropPage.ets
│   ├── LinkPage.ets
│   ├── ProvideGrand.ets
│   ├── ObservedPage.ets
│   ├── RequirePage.ets
│   ├── WatchPage.ets
│   ├── TrackPage.ets
│   ├── AppStoragePage.ets
│   ├── LocalStoragePage.ets
│   ├── LifePage1.ets
│   ├── LifePage2.ets
│   ├── CommentListPage.ets
│   ├── MainPay.ets
│   ├── PayIndex.ets
│   └── Demo.ets
├── storages/            # 存储相关
│   └── User.ets
├── entryability/        # 入口 Ability
│   └── EntryAbility.ets
└── payability/          # 支付 Ability
    └── PayAbility.ets

状态管理示例

1. 组件内状态

页面	说明
Index.ets	@State - 组件内部状态管理

2. 父子组件通信

页面	装饰器	说明
PropPage.ets	@Prop	父子组件单向数据同步（父→子）
LinkPage.ets	@Link	父子组件双向数据同步
RequirePage.ets	@Require	必传参数验证

3. 跨层级组件通信

页面	装饰器	说明
ProvideGrand.ets	@Provide/@Consume	跨层级组件数据共享（祖先与后代）

4. 嵌套对象观察

页面	装饰器	说明
ObservedPage.ets	@Observed/@ObjectLink	嵌套对象的响应式观察

5. 状态监听

页面	装饰器	说明
WatchPage.ets	@Watch	监听状态变化回调
TrackPage.ets	@Track	精准控制观察的属性

6. 全局状态存储

页面	API	说明
AppStoragePage.ets	AppStorage	应用级全局状态存储
LocalStoragePage.ets	LocalStorage	页面级状态存储

7. 生命周期

页面	说明
LifePage1.ets	组件生命周期演示（页面1）
LifePage2.ets	组件生命周期演示（页面2）

8. 综合示例

页面	说明
CommentListPage.ets	评论列表（综合状态管理应用）
MainPay.ets / PayIndex.ets	支付相关页面示例

适用场景

本项目适合用于：

• 📚 学习 HarmonyOS ArkUI 的状态管理机制
• 🔍 理解不同装饰器的使用场景和区别
• 📋 作为实际项目开发的参考模板
• 🎯 快速查阅各种状态管理方案的用法

运行环境

• DevEco Studio
• HarmonyOS SDK 5.0.0(12) 或更高版本

参考资料

• HarmonyOS 官方文档
• ArkUI 状态管理指南