HarmonyOS鸿蒙Next中V2和V1如何跨组件传参？

V2和V1自定义组件间的数据传递：

一、V2向V1传递数据限制

1.装饰器兼容性

• V2的@Provider/@Consumer无法直接在V1中使用（V1组件使用@Component而非@ComponentV2装饰）
• V1的@Provide/@Consume无法接收V2装饰的复杂类型（如Array、Map、Date等内置类型）

2.可行传递方式

• 简单类型传递：通过@Param传递基础数据类型（boolean、number、string等）

// V2组件
[@ComponentV2](/user/ComponentV2) struct V2Component {
  @Local() message: string = "Hello V1";
  build() {
    V1Component({ msg: this.message }) // 通过[@Param](/user/Param)传递
  }
}

// V1组件
[@Component](/user/Component) struct V1Component {
  @Prop msg: string; // 接收简单类型
  build() { Text(this.msg) }
}

• 复杂类型处理：通过API实现兼容

// V2中使用enableV2Compatibility处理V1状态变量
import { UIUtils } from '@kit.ArkUI';
[@Observed](/user/Observed)
class ObservedClass { value: string = "data"; }

[@ComponentV2](/user/ComponentV2) struct V2Component {
  @Local() v1ObservedData = UIUtils.enableV2Compatibility(new ObservedClass());
  build() {
    V1Component({ data: this.v1ObservedData }) // 传递给V1组件
  }
}

二、V1向V2传递数据方案

1.简单类型直接传递

// V1组件中定义
[@Component](/user/Component) struct V1Component {
  @State count: number = 0;
  build() {
    V2Component({ count: this.count }) // 通过[@Param](/user/Param)传递
  }
}

// V2组件接收
[@ComponentV2](/user/ComponentV2) struct V2Component {
  [@Param](/user/Param) count: number;
  build() { Text(`Count: ${this.count}`) }
}

2.复杂类型需启用V2观察能力

• 关键API：UIUtils.enableV2Compatibility和UIUtils.makeV1Observed2

// V1组件中处理复杂类型
[@Observed](/user/Observed)
class V1Data { info: string = "V1 data"; }

[@Component](/user/Component) struct V1Component {
  @State data: V1Data = UIUtils.enableV2Compatibility(UIUtils.makeV1Observed(new V1Data()));
  build() {
    V2Component({ complexData: this.data })
  }
}

// V2组件通过[@Param](/user/Param)接收并处理
[@ComponentV2](/user/ComponentV2) struct V2Component {
  [@Param](/user/Param) complexData: V1Data;
  build() { Text(this.complexData.info) }
}

三、混合开发注意事项

1.版本限制

• API >= 19：必须使用enableV2Compatibility接口实现复杂类型兼容2
• API < 19：仅支持简单类型通过@Param传递1

2.数据更新规则

• V1状态变量传递到V2后，仅支持第一层属性变化触发刷新
• 若需深度观察嵌套数据，需在V2中为每个嵌套类添加@ObservedV2和@Trace

3.代码迁移建议

• 优先逐步替换：将V1组件逐步重构为V2组件，减少混用复杂度
• 避免双向依赖：混用场景下尽量通过父组件作为中间层传递数据

总结