【HarmonyOS Next】鸿蒙状态管理装饰器V1和V2混用方案

移动开发 2025-04-11 23:38:10 阅读次数: 0

【HarmonyOS Next】鸿蒙状态管理装饰器V1和V2混用方案

一、V1和V2为什么需要混用

自从api7开始，一直到api10。V1的实际使用中，开发人员发现@Observed和@ObjectLink 监听实现多层级嵌套对象的更新的方案，太过于臃肿。当需要监听处理更新的多层级对象是七八层，就需要配套创建七八层的ObjectLink，代码太过于冗余。

V2就是为了解决该问题，华为官方才提出的新状态管理装饰器方案。该方案在解决该问题的基础上，也对V1的进行加强。

但是考虑现实开发情况。基本上鸿蒙现有的应用都在24年930节点之前上架了。大量使用的都是V1方案。如果要迁移到V2上。改动量太大，不亚于重新开发界面刷新相关业务。

所以官方V1和V2目前是相关独立，也可混用。这种状态估计会持续很长时间。

但是不用V2，前面提到的嵌套更新问题又需要好的方案解决。所以就需要V1和V2混用。

当然如果是新项目，还是建议直接使用V2.

二、V1和V2混用方案

原则上，只使用@ObservedV2与@Trace装饰器来解决深层嵌套对象更新UI的问题。暂时不使用其他的V2装饰器，其他的状态管理依旧使用V1即可。
在这里插入图片描述

以下代码示例参考，只使用@ObservedV2与@Trace装饰器，解决深层嵌套对象更新UI的问题：

import {
    
     util } from '@kit.ArkTS';

/**
 * 三级数据结构
 */
@ObservedV2 
class GrandsonInfo {
    
    
 @Trace content: string = "";

}

/**
 * 二级数据结构
 */
@ObservedV2  
class ChildInfo {
    
    
 @Trace index: number;
 @Trace grandsonInfo: GrandsonInfo;

  constructor(index: number, content: string) {
    
    
    this.index = index;
    this.grandsonInfo = new GrandsonInfo();
    this.grandsonInfo.content = content;
  }
}

/**
 * 一级数据结构
 */
@ObservedV2  
class ItemInfo {
    
    
  key: string = util.generateRandomUUID(true);
 @Trace name: string;
 @Trace icon: Resource;
 @Trace childInfo: ChildInfo;
 @Trace select: boolean;

  constructor(name: string, icon: Resource, index: number, content: string) {
    
    
    this.name = name;
    this.icon = icon;
    this.childInfo = new ChildInfo(index, content);
    this.select = false;
  }
}

/**
 * 多层嵌套刷新渲染
 */
@Entry
@Component
struct ObservedPage {
    
    
  private TAG: string = "ObservedPage";
	// @State无法混用，运行时报错
   // @State mListData: Array<ItemInfo> = [];
	mListData: Array<ItemInfo> = [];

  aboutToAppear(): void {
    
    
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconA"), 1, "鹅厂1"));
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconB"), 2, "鹅厂2"));
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconA"), 3, "鹅厂3"));
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconB"), 4, "鹅厂4"));
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconA"), 5, "鹅厂5"));
    this.mListData.push(new ItemInfo('游戏', $r("app.media.iconB"), 6, "鹅厂6"));
  }

  build() {
    
    
    List() {
    
    
      ForEach(this.mListData, (item: ItemInfo, index: number) => {
    
    
        ListItem() {
    
    
        	  Row() {
    
    
			     Image(this.item.icon)
			        .width(px2vp(200))
			        .height(px2vp(200))

			      Text(this.item.name + "(" + this.item.childInfo.index + ")" + " [ " + this.item.childInfo.grandsonInfo.content + " ] ")
			        .fontSize(px2fp(52))

			      Blank()
			
			      if(this.isLog(this.item, this.index)){
    
    
			        if(this.item.select){
    
    
			          Image($r("app.media.icon_check"))
			            .size({
    
    
			              width: px2vp(72),
			              height: px2vp(72)
			            })
			        }
			      }
			    }
			    .width('100%')
			    .justifyContent(FlexAlign.Start)
			    .onClick(()=>{
    
    
			      this.item.select = !this.item.select;
			      if(this.item.select){
    
    
			        // 使用很方便，只需要直接改变item数据的任意层级属性值，变化就会同步刷新
			        this.item.childInfo.index = 666;
			        this.item.childInfo.grandsonInfo.content = "鹅厂23333"
			      }else{
    
    
			        this.item.childInfo.index = this.index;
			        this.item.childInfo.grandsonInfo.content = "鹅厂" + this.index;
			      }
			      console.log(this.TAG, " ItemView onClick: " + this.index + " item.select: " + this.item.select);
			    })
        }
      }, (item: ItemInfo) => JSON.stringify(item)) 
    }
    .width("100%")
    .height("100%")
    .padding({
    
     left: px2vp(60), right: px2vp(60) })
  }
}