1# 页面布局检查器ArkUI Inspector使用指导
2
3DevEco Studio内置ArkUI Inspector工具，开发者可以使用ArkUI Inspector，在DevEco Studio上查看应用在真机上的UI显示效果。利用ArkUI Inspector工具，开发者可以快速定位布局问题或其他UI相关问题，同时也可以观察和了解不同组件之间的布局关系和属性，学习如何通过布局属性来控制组件的显示方式。
4
5## 使用约束
6
7已通过USB连接设备并在设备上打开需要调试的设备。
8
9仅在应用为debug编译模式时使用。
10
11仅支持OpenHarmony API 9及以上版本的Stage工程。
12
13## 场景示例
14
15示例代码使用Grid组件来实现网格布局，在子组件Text组件的外层嵌套了3层Stack容器。
16
17```ts
18@Entry
19@Component
20struct ArkUIInspectorExample {
21 @State children: Number[] = Array.from(Array(900), (_, k) => k);
22
23 build() {
24  Scroll() {
25   Grid() {
26    ForEach(this.children, (item: Number) => {
27     GridItem() {
28      Stack() {
29       Stack() {
30        Stack() {
31         Text(item.toString()).border({ width: 2, color: Color.Green })
32        }
33       }
34      }
35     }
36    }, (item: Number) => item.toString())
37   }
38   .columnsTemplate('1fr 1fr 1fr 1fr')
39   .columnsGap(0)
40   .rowsGap(0)
41   .size({ width: "100%", height: "100%" })
42  }
43 }
44}
45```
46
47## 如何使用页面布局检查器
48
49以DevEco Studio 4.0.0.400版本为例，在DevEco Studio菜单栏上单击***\*View\**** > ***\*Tool Windows\**** >***\*ArkUI Inspector\****，或者在DevEco Studio底部工具栏单击![img](./figures/profiler_inspector_button.jpg)
50
51打开ArkUI Inspector工具，如下图所示：
52
53![img](./figures/profiler_inspector.jpg)
54
551. 进程选择栏，选择已经在设备上打开的应用进程。点击右侧![img](./figures/profiler_refresh.jpg)“Refresh”按钮以刷新当前页面快照，请注意，设备需要处于亮屏状态并且应用需要处于前台运行。
56
572. 页面组件树区，用于查看组件嵌套状态，当前显示为Text组件。
58
593. 页面快照区，点击Text组件后，页面组件列表跳转至选中的Text组件。点击右下角![img](./figures/profiler_pan_screen.jpg)“Pan Screen”按钮以拖移屏幕；点击![img](./figures/profiler_plus.jpg) 、![img](./figures/profiler_minus.jpg) 按钮来缩放页面；点击![img](./figures/profiler_zoom.jpg)“Zoom to Fit Screen”按钮使页面居中并适应屏幕大小。
60
614. 组件详情区，展示当前选中Text组件的属性信息，包括组件的坐标、布局信息（Spacing）、尺寸信息（Size）、边框信息（Border）、背景信息（Background）、蒙版信息（Effect）、所有其他属性（All Attributes）。如需精准查找单个属性，可通过页面上方搜索栏进行搜索。
62
63## 问题分析
64
65从页面布局检查器中可以清晰看出，Text组件外部有3层冗余的Stack容器，属于嵌套过多场景。
66
67![img](./figures/profiler_inspector_analysis.jpg)
68
69## 代码优化
70
71针对在页面布局检查器中发现的冗余Stack容器问题，在应用代码中删除多余的Stack容器。
72
73```ts
74@Entry
75@Component
76struct ArkUIInspectorExample {
77 @State children: Number[] = Array.from(Array(900), (_, k) => k);
78
79 build() {
80  Scroll() {
81   Grid() {
82    ForEach(this.children, (item: Number) => {
83     GridItem() {
84      Text(item.toString()).border({ width: 2, color: Color.Green })
85     }
86    }, (item: Number) => item.toString())
87   }
88   .columnsTemplate('1fr 1fr 1fr 1fr')
89   .columnsGap(0)
90   .rowsGap(0)
91   .size({ width: "100%", height: "100%" })
92  }
93 }
94}
95```
96
97## 优化结果
98
99布局优化后，使用页面布局检查器可以看到页面上的冗余项已经去除。经过测试，页面滑动时刷新一帧的平均时间比优化前减少1ms。
100
101![img](./figures/profiler_inspector_result.jpg)
102