# StatusManagementV2

**Repository Path**: harmonyos_codelabs/status-management-v2

## Basic Information

- **Project Name**: StatusManagementV2
- **Description**: 此Codelab主要介绍状态管理V2所属装饰器的含义和使用场景。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-11-13
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实现状态管理V2装饰器原子级场景

## 项目简介

本示例针对状态管理V2所属装饰器的功能和属性的介绍及单一场景案例的实现，涉及如下装饰器：

- @ObservedV2装饰器和@Trace装饰器：类属性变化观测
- @ComponentV2装饰器：自定义组件
- @Local装饰器：组件内部状态
- @Param：组件外部输入
- @Event装饰器：规范组件输出
- @Provider装饰器和@Consumer装饰器：跨组件层级双向同步
- @Monitor装饰器：状态变量修改监听
- @Computed装饰器：计算属性

## 效果预览

<img src="./screenshots/device/result.png" style="width:320px">

## 使用说明

1. 每个page页面仅描述实现单一的装饰器。
2. 使用时，选择要查看效果的page页面，点击开发工具的“预览功能”。

## 工程目录

   ```  
    ├──entry
    │  ├──build-profile.json5                               // 当前的模块信息、编译信息配置项
    │  ├──hvigorfile.ts                                     // 模块级编译构建任务脚本
    │  ├──oh-package.json5                                  // 描述三方包的包名、版本、入口文件（类型声明文件）和依赖项等信息
    │  └──src
    │     └──main
    │        ├──ets
    │        │  ├──entryability
    │        │  │  └──EntryAbility.ets                      // 程序入口类
    │        │  └──pages
    │        │     ├──ComponentInternalStatus.ets           // 组件内状态变量定义-@Local
    │        │     ├──EventCommunication.ets                // 组件间的事件通信-@Event
    │        │     ├──EventSynchronizationAfter.ets         // 跨组件事件传递优化后-@Provider&@Consumer
    │        │     ├──EventSynchronizationBefore.ets        // 跨组件事件传递优化前-@Event
    │        │     ├──Monitoring.ets                        // 监听状态变量变化-@Monitor
    │        │     ├──MonitoringBatch.ets                   // 批量监听状态变量变化-@Monitor
    │        │     ├──ParameterInput.ets                    // 组件间的数据传递-@Param
    │        │     ├──StateCacheAfter.ets                   // 状态变量数据缓存优化后-@Computed
    │        │     ├──StateCacheBefore.ets                  // 状态变量数据缓存优化前
    │        │     ├──StateSynchronizationAfter.ets         // 跨组件变量传递优化后-@Provider&@Consumer
    │        │     ├──StateSynchronizationBefore.ets        // 跨组件变量传递优化前-@Param
    │        │     ├──Status.ets                            // 开关状态&计数器
    │        │     ├──StatusOfManagementObjectsAfter.ets    // 监测类型属性变量的变化优化后-@Local+@ObservedV2和@Trace
    │        │     └──StatusOfManagementObjectsBefore.ets   // 监测类型属性变量的变化优化前-@Local
    │        ├──module.json5                                // Stage模型模块配置文件
    │        └──resources                                   // 应用静态资源目录
    ├──hvigor
    │  └──hvigor-config.json5
    ├──hvigorfile.ts                                        // 应用级编译构建任务脚本
    └──oh-package.json5                                     // 描述全局配置                                      
   ```

## 具体实现

根据每一个装饰器的特性使用相应简单的场景案例来实现其效果，使用常见组件如Text、Button等。

## 相关权限

不涉及

## 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS 6.0.0 Release及以上。
3. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。