HarmonyOS开发实战（ Beta5版）状态变量组件定位工具最佳实践

概述

自定义组件中的变量被状态装饰器（@State，@Prop等）装饰后成为状态变量，而状态变量的改变会引起使用该变量的UI组件渲染刷新。状态变量的不合理使用可能会带来冗余刷新等性能问题。开发者可以使用状态变量组件定位工具获取状态管理相关信息，例如自定义组件拥有的状态变量、状态变量的同步对象和关联组件等，了解状态变量影响UI的范围，写出高性能应用代码。

本文将通过场景示例为开发者提供状态变量组件定位工具的实践指导，并对工具相关的调试命令和输出结果作解释说明。

使用流程

状态变量组件定位工具是通过使用HiDumper工具中特定的命令来获取组件和状态管理相关的信息。开发者可以使用工具查看指定自定义组件拥有的状态变量信息，了解其中各个状态变量影响的组件范围。

工具的使用流程可以分为以下几步：

1、设备上打开组件所在页面。

2、获取应用的窗口Id。

3、基于应用窗口Id获取应用的自定义组件树，找到目标组件和它的节点Id。

4、根据上一步获取的组件节点Id获取组件拥有的状态变量信息。

5、找到目标状态变量，查看它影响的组件范围。

在明确目标组件包含的状态变量和变量影响的组件刷新范围后，开发者可以根据需求分析是否存在状态变量的不合理使用，并对相应代码分析和优化。

场景示例

下面通过一个点击按钮更改状态变量引起组件刷新的场景示例，为开发者提供工具的实践指导。场景示例仅展示部分关键代码。

在以下代码中，创建了自定义组件ComponentA、SpecialImage，每个组件都拥有一些状态变量和UI组件。组件ComponentA中存在Move和Scale两个按钮，在按钮的点击回调中改变状态变量的值刷新相应的组件。

  1. // 常量声明
  2. // ... 
  3. // 样式属性类  
  4. class UIStyle {  
  5.   public translateX: number = 0;  
  6.   public translateY: number = 0;  
  7.   public scaleX: number = 0.3;  
  8.   public scaleY: number = 0.3;  
  9. }  
  10. @Component  
  11. struct ComponentA {  
  12.   @Link uiStyle: UIStyle; // uiStyle的属性被多个组件使用  
  13.   build() {  
  14.     Column() {  
  15.       // 使用状态变量的组件  
  16.       SpecialImage({ specialImageUiStyle: this.uiStyle })  
  17.       Stack() {  
  18.         Column() {  
  19.           Image($r('app.media.icon'))  
  20.             .scale({  
  21.               x: this.uiStyle.scaleX,  
  22.               y: this.uiStyle.scaleY  
  23.             })  
  24.         }  
  25.         Stack() {  
  26.           Text('Hello World')  
  27.         }  
  28.       }  
  29.       .translate({  
  30.         x: this.uiStyle.translateX,  
  31.         y: this.uiStyle.translateY  
  32.       })  
  33.   
  34.       // 通过按钮点击回调修改状态变量的值，引起相应的组件刷新  
  35.       Column() {  
  36.         Button('Move')  
  37.           .onClick(() => {  
  38.             animateTo({ duration: animationDuration }, () => {  
  39.               this.uiStyle.translateY = (this.uiStyle.translateY + translateYChangeValue) % translateYChangeRange;  
  40.             })  
  41.           })  
  42.         Button('Scale')  
  43.           .onClick(() => {  
  44.             this.uiStyle.scaleX = (this.uiStyle.scaleX + scaleXChangeValue) % scaleXChangeRange;  
  45.           })  
  46.       }  
  47.     }  
  48.   }  
  49. }  
  50. @Component  
  51. struct SpecialImage {  
  52.   @Link specialImageUiStyle: UIStyle;  
  53.   private opacityNum: number = 0.5; // 默认透明度  
  54.   private isRenderSpecialImage(): number {  
  55.     // Image每次渲染时透明度增加0.1, 在0-1之间循环  
  56.     this.opacityNum = (this.opacityNum + opacityChangeValue) % opacityChangeRange;  
  57.     return this.opacityNum;  
  58.   }  
  59.   build() {  
  60.     Column() {  
  61.       Image($r('app.media.icon'))  
  62.         .scale({  
  63.           x: this.specialImageUiStyle.scaleX,  
  64.           y: this.specialImageUiStyle.scaleY  
  65.         })  
  66.         .opacity(this.isRenderSpecialImage())  
  67.       Text("SpecialImage")  
  68.     }  
  69.   }  
  70. }  
  71. // 页面根组件，ComponentA的父组件

运行上述示例并分别点击按钮，可以看到点击Move按钮和Scale按钮时组件SpecialImage都出现了刷新，运行效果图如下。

下面以自定义组件ComponentA和其中的状态变量uiStyle为例介绍工具的使用过程。

1、首先在设备上打开应用，进入ComponentA组件所在的页面。

2、使用以下命令获取示例应用的窗口Id。当前运行的示例应用包名为performancelibrary，可以在输出结果中找到对应窗口名performancelibrary0的WinId，即为应用的窗口Id。或者当应用正处于前台运行时，Focus window的值就是应用的窗口Id。此处示例应用的窗口Id为11，后面的流程中使用的命令都需要指定窗口Id。

hdc shell "hidumper -s WindowManagerService -a '-a'"

3、基于上一步获取的窗口Id 11，使用-viewHierarchy命令携带-r 参数递归打印应用的自定义组件树。从结果中找到目标组件ComponentA，后面括号中的内容即为组件ComponentA的节点Id 70。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -viewHierarchy -r'"
  2. -----------------ViewPU Hierarchy-----------------  
  3. [-viewHierarchy, viewId=4, isRecursive=true]  
  4. |--Index[4]  
  5. -----------------ViewPU Hierarchy-----------------  
  6. [-viewHierarchy, viewId=53, isRecursive=true]  
  7. |--DFXStateManagementPage[53]  
  8.   |--DFXStateManagementHome[55]  
  9. -----------------ViewPU Hierarchy-----------------  
  10. [-viewHierarchy, viewId=65, isRecursive=true]  
  11. |--DFXStateBeforeOptimizationPage[65]  
  12.   |--DFXStateBeforeOptimization[67]  
  13.     |--ComponentA[70]  
  14.       |--SpecialImage[73]

4、使用命令-stateVariables携带参数-viewId（参数的值为ComponentA的节点Id）获取自定义组件ComponentA中的状态变量信息。结果显示ComponentA拥有@Link/@Consume类型的状态变量uiStyle。每条状态变量的详细信息都包含状态变量的所属组件、同步对象和关联组件。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -stateVariables -viewId=70'"
  2. --------------ViewPU State Variables--------------  
  3. [-stateVariables, viewId=70, isRecursive=false]  
  4. |--ComponentA[70]  
  5.   @Link/@Consume (class SynchedPropertyTwoWayPU) 'uiStyle'[71]  
  6.   |--Owned by @Component 'ComponentA'[70]  
  7.   |--Sync peers: {  
  8.     @Link/@Consume (class SynchedPropertyTwoWayPU) 'specialImageUiStyle'[74] <@Component 'SpecialImage'[73]>  
  9.   }  
  10.   |--Dependent components: 2 elmtIds: 'Stack[75]', 'Image[77]'

5、以状态变量uiStyle为例。

① Sync peers表示uiStyle在自定义组件SpecialImage中存在@Link/@Consume类型的状态变量specialImageUiStyle订阅数据变化。

② Dependent components表示在ComponentA组件中存在组件Stack[79]和Image[81]使用了状态变量uiStyle，关联组件的数量为2。

所以当uiStyle变化时，影响的组件范围为自定义组件SpecialImage以及系统组件Stack[79]和Image[81]。

示例中组件SpecialImage仅使用了uiStyle传递到specialImageUiStyle中的属性scaleX、scaleY，但是点击Move按钮修改uiStyle中的属性translateY时引起的uiStyle变化也会导致组件SpecialImage的刷新，所以可以将uiStyle中的属性scaleX、scaleY提取到状态变量scaleStyle中，属性translateX和translateY提取到状态变量translateStyle中，仅传递scaleStyle给组件SpecialImage，避免不必要的刷新。

由于提取后存在Class的嵌套，所以需要使用@Observed/@ObjectLink装饰器装饰相应的Class和状态变量。修改后的部分代码如下。

  1. // 常量声明
  2. // ...
  3. // 样式属性类，嵌套ScaleStyle, TranslateStyle  
  4. @Observed  
  5. class UIStyle {  
  6.   translateStyle: TranslateStyle = new TranslateStyle();  
  7.   scaleStyle: ScaleStyle = new ScaleStyle();  
  8. }  
  9. // 缩放属性类  
  10. @Observed  
  11. class ScaleStyle {  
  12.   public scaleX: number = 0.3;  
  13.   public scaleY: number = 0.3;  
  14. }  
  15. // 位移属性类  
  16. @Observed  
  17. class TranslateStyle {  
  18.   public translateX: number = 0;  
  19.   public translateY: number = 0;  
  20. }  
  21. @Component  
  22. struct ComponentA {  
  23.   @ObjectLink scaleStyle: ScaleStyle;  
  24.   @ObjectLink translateStyle: TranslateStyle;  
  25.   
  26.   build() {  
  27.     Column() {  
  28.       SpecialImage({  
  29.         specialImageScaleStyle: this.scaleStyle  
  30.       })  
  31.       // 其他UI组件  
  32.     }  
  33.   }  
  34. }  
  35.   
  36. @Component  
  37. struct SpecialImage {  
  38.   @Link specialImageScaleStyle: ScaleStyle;  
  39.   // isRenderSpecialImage函数  
  40.   build() {  
  41.     Column() {  
  42.       Image($r('app.media.icon'))  
  43.         .scale({  
  44.           x: this.specialImageScaleStyle.scaleX,  
  45.           y: this.specialImageScaleStyle.scaleY  
  46.         })  
  47.         .opacity(this.isRenderSpecialImage())   
  48.       Text("SpecialImage")  
  49.     }
  50.   }  
  51. }
  52. // 页面根组件，ComponentA的父组件

修改后的示例运行效果图如下，只有点击Scale按钮时SpecialImage产生刷新现象，点击Move按钮时SpecialImage不会刷新。

可以使用上文步骤再次获取ComponentA组件的状态变量信息如下，可以看到ComponentA中状态变量scaleStyle影响组件SpecialImage[74]和Image[78]，状态变量translateStyle影响组件Stack[76]，translateStyle的变化不会再导致SpecialImage的刷新。

  1. --------------ViewPU State Variables--------------  
  2. [-stateVariables, viewId=70, isRecursive=false]  
  3.   
  4. |--ComponentA[70]  
  5.   @ObjectLink (class SynchedPropertyNestedObjectPU) 'scaleStyle'[71]  
  6.   |--Owned by @Component 'ComponentA'[70]  
  7.   |--Sync peers: {  
  8.     @Link/@Consume (class SynchedPropertyTwoWayPU) 'specialImageScaleStyle'[75] <@Component 'SpecialImage'[74]>  
  9.   }  
  10.   |--Dependent components: 1 elmtIds: 'Image[78]'  
  11.   @ObjectLink (class SynchedPropertyNestedObjectPU) 'translateStyle'[72]  
  12.   |--Owned by @Component 'ComponentA'[70]  
  13.   |--Sync peers: none  
  14.   |--Dependent components: 1 elmtIds: 'Stack[76]'

调试命令和输出详解

下面通过一个自定义组件三层嵌套的简单示例程序，对工具的调试命令和输出结果作详细说明。

  1. @Entry  
  2. @Component  
  3. struct Index {  
  4.   @State indexMessage: string = 'Hello World';  
  5.   build() {  
  6.     Row() {  
  7.       Column() {  
  8.         Text(this.indexMessage)  
  9.         ComponentA({ componentAMessage: this.indexMessage })  
  10.       }  
  11.       .width('100%')  
  12.     }  
  13.     .height('100%')  
  14.   }  
  15. }  
  16. @Component  
  17. struct ComponentA {  
  18.   @Link componentAMessage: string;  
  19.   build() {  
  20.     Column() {  
  21.       ComponentB({ componentBMessage: this.componentAMessage })  
  22.     }  
  23.   }  
  24. }  
  25. @Component  
  26. struct ComponentB {  
  27.   @Link componentBMessage: string;  
  28.   build() {  
  29.     Column() {  
  30.       Text(this.componentBMessage)  
  31.     }  
  32.   }  
  33. }

1、查看应用窗口Id。可以通过窗口列表中应用的WindowName（示例应用的包名为dfxdemo，默认的WindowName为dfxdemo0）找到其WinId，即应用窗口Id。结果中的Focus window为当前界面展示的窗口Id。当应用处于前台运行时，Focus window的值即为应用窗口Id。

hdc shell "hidumper -s WindowManagerService -a '-a'"

2、打印自定义组件树。

默认只打印根节点和它子级的自定义组件。其中 11 表示查看的窗口Id，可使用查看应用窗口Id命令获取。结果中形如Index[4]格式的，前面为自定义组件的名称，[]中的数字为组件的节点Id。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -viewHierarchy'"
  2. -----------------ViewPU Hierarchy-----------------  
  3. [-viewHierarchy, viewId=4, isRecursive=false]  
  4. |--Index[4]  
  5.   |--ComponentA[9]

携带-viewId参数可以打印指定viewId的自定义组件和该组件子级的自定义组件。只有自定义组件的节点Id可以作为参数-viewId的值使用。以-viewId=9为例，可以获取到viewId为9的自定义组件ComponentA和它子级的自定义组件ComponentB。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -viewHierarchy -viewId=9'"
  2. -----------------ViewPU Hierarchy-----------------  
  3. [-viewHierarchy, viewId=9, isRecursive=false]  
  4. |--ComponentA[9]  
  5.   |--ComponentB[12]

携带-r参数从根节点开始递归打印自定义组件树。例如下面命令的输出结果为根节点Index和它拥有的每一级自定义组件，以树状结构展示。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -viewHierarchy -r'"
  2. -----------------ViewPU Hierarchy-----------------  
  3. [-viewHierarchy, viewId=4, isRecursive=true]  
  4. |--Index[4]  
  5.   |--ComponentA[9]  
  6.     |--ComponentB[12]

3、打印自定义组件的状态变量信息，每条信息包含该变量的所属组件、Sync peers（同步对象）和Dependent components（关联组件）。当该状态变量改变时，它的Dependent components和Sync peers的Dependent components都是脏节点。默认打印根节点。

  1. hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -stateVariables'"
  2. --------------ViewPU State Variables--------------  
  3. --Index[4]  
  4.   @State/@Provide (class ObservedPropertyPU) 'indexMessage'[5]  
  5.   |--Owned by @Component 'Index'[4]  
  6.   |--Sync peers: {  
  7.     @Link/@Consume (class SynchedPropertyTwoWayPU) 'componentAMessage'[9] <@Component 'ComponentA'[8]>  
  8.   }  
  9.   |--Dependent components: 1 elmtIds: 'Text[8]'
  • @State/@Provide：状态变量的装饰器类型。
  • 'message'[5]：状态变量的名称和节点Id，但是不能使用-viewId=5来获取相应的dump信息。
  • Owned by @Component 'Index'[4]：状态变量所属组件。
  • Sync peers： 要同步的其他状态变量和其所属的组件。
  • Dependent components：当前状态变量在此组件中关联的节点Id，即依赖该变量的系统或自定义组件的节点Id。

注意：

-stateVariables只支持打印指定viewId的状态变量信息，不支持递归打印。所以只能获取单个自定义组件的状态变量信息进行逐级分析，目前无法从全局查看某个状态变量影响到的所有组件。

4、打印所有信息，包含自定义组件树和状态变量信息。未指定节点时默认打印根节点，携带-viewId参数打印指定节点信息，携带-r参数递归打印。

hdc shell "hidumper -s WindowManagerService -a '-w 11 -jsdump -dumpAll'"

输出结果如下图：

1、自定义组件树，对应命令-viewHierarchy。

2、状态变量信息，对应命令-stateVariables。

dumpAll命令携带-r和-viewId参数时，输出结果中对应各个命令的部分与单独使用该命令携带相应参数时的结果相同。

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.视频学习教程+学习PDF文档

HarmonyOS Next 最新全套视频教程

  纯血版鸿蒙全套学习文档（面试、文档、全套视频等）       

​​

总结

参与鸿蒙开发，你要先认清适合你的方向，如果是想从事鸿蒙应用开发方向的话，可以参考本文的学习路径，简单来说就是：为了确保高效学习，建议规划清晰的学习路线

文章知识点与官方知识档案匹配，可进一步学习相关知识
CS入门技能树Linux入门初识Linux42834 人正在系统学习中
鸿蒙NEXT全套学习资料
微信名片
注：本文转载自blog.csdn.net的让开，我要吃人了的文章"https://blog.csdn.net/weixin_55362248/article/details/141789469"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！