HarmonyOS 应用开发之自定义组件成员属性访问限定符使用限制

最新推荐文章于 2025-03-18 13:46:25 发布

OpenHarmony_小贾

最新推荐文章于 2025-03-18 13:46:25 发布

阅读量1.4k

点赞数 5

分类专栏： HarmonyOS OpenHarmony 移动开发文章标签： harmonyos 深度学习华为移动开发鸿蒙交互

本文链接：https://blog.csdn.net/maniuT/article/details/137274061

版权

本文详细阐述了从HarmonyOSAPIversion12开始，如何在使用ArkTS开发过程中遵循访问权限规范，包括private、public和protected修饰的组件成员变量的初始化限制，以及违反规定的编译告警示例。同时提供了鸿蒙开发学习资源的相关链接。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

ArkTS会对自定义组件的成员变量使用的访问限定符private/public/protected进行校验，当不按规范使用访问限定符private/public/protected时，会产生对应的日志信息。

说明：
从API version 12开始，支持自定义组件成员属性访问限定符使用限制的规则。

使用限制

对于@State/@Prop/@Provide/@BuilderParam/常规成员变量(不涉及更新的普通变量)，当使用private修饰时，在自定义组件构造时，不允许进行赋值传参，否则会有编译告警日志提示。
对于@StorageLink/@StorageProp/@LocalStorageLink/@LocalStorageLink/@Consume变量，当使用public修饰时，会有编译告警日志提示。
对于@Link/@ObjectLink变量，当使用private修饰时，会有编译告警日志提示。
由于struct没有继承能力，上述所有的这些变量使用protected修饰时，会有编译告警日志提示。
当@Require和private同时修饰自定义组件struct的@State/@Prop/@Provide/@BuilderParam/常规成员变量(不涉及更新的普通变量)时，会有编译告警日志提示。

错误使用场景示例

1.当成员变量被private访问限定符和@State/@Prop/@Provide/@BuilderParam装饰器同时修饰时，ArkTS会进行校验并产生告警日志。

@Entry
@Component
struct AccessRestrictions {
   
  @Builder buildTest() {
   
    Text("Parent builder")
  }
  build() {
   
    Column() {
   
      ComponentsChild({
   state_value: "Hello", prop_value: "Hello", provide_value: "Hello", builder_value: this.buildTest, regular_value: "Hello"})
    }
    .width('100%')
  }
}

@Component
struct ComponentsChild {
   
  @State private state_value: string = "Hello";
  @Prop private prop_value: string = "Hello";
  @Provide private provide_value: string = "Hello";
  @BuilderParam private builder_value: () => void = this.buildTest;
  private regular_value: string = "Hello";
  @Builder buildTest() {
   
    Text("Child builder")

最低0.47元/天解锁文章