ToB企服应用市场:ToB评测及商务社交产业平台

标题: HarmonyOS（五）—— 认识页面和自界说组件生命周期 [打印本页]

---

作者: 农妇山泉一亩田    时间: 2024-12-25 03:22
标题: HarmonyOS（五）—— 认识页面和自界说组件生命周期
媒介

在前面我们通过怎样创建自界说组件一文知道了怎样怎样自界说组件以及自界说组件的相干注意事项，接下来我们认识一下页面和自界说组件生命周期。
自界说组件和页面的关系

在开始之前，我们先明确自界说组件和页面的关系

• 自界说组件：@Component装饰的UI单元，可以组合多个系统组件实现UI的复用。
  
• 页面：即应用的UI页面。可以由一个或者多个自界说组件组成，@Entry装饰的自界说组件为页面的入口组件，即页面的根节点，一个页面有且仅能有一个@Entry。只有被@Entry装饰的组件才可以调用页面的生命周期。
  

生命周期

下面依次先容页面和组件的生命周期函数。
1:页面生命周期

页面生命周期，即被@Entry装饰的组件生命周期，提供以下生命周期接口：

• onPageShow：页面每次表现时触发。
  

1. onPageShow?(): void

复制代码

页面每次表现时触发一次，包括路由过程、应用进入前台等场景，仅@Entry装饰的自界说组件生效。

• onPageHide：页面每次隐蔽时触发一次。
  

1. onPageHide?(): void

复制代码

页面每次隐蔽时触发一次，包括路由过程、应用进入前后台等场景，仅@Entry装饰的自界说组件生效。

• onBackPress：当用户点击返回按钮时触发。
  

1. onBackPress?(): void

复制代码

当用户点击返回按钮时触发，仅@Entry装饰的自界说组件生效。
onPageShow，onPageHide，onBackPress生命周期简单利用列子如下：

1. // xxx.ets
2. @Entry
3. @Component
4. struct IndexComponent {
5.   @State textColor: Color = Color.Black;
7.   onPageShow() {
8.     this.textColor = Color.Blue;
9.     console.info('IndexComponent onPageShow');
10.   }
12.   onPageHide() {
13.     this.textColor = Color.Transparent;
14.     console.info('IndexComponent onPageHide');
15.   }
17.   onBackPress() {
18.     this.textColor = Color.Red;
19.     console.info('IndexComponent onBackPress');
20.   }
22.   build() {
23.     Column() {
24.       Text('Hello World')
25.         .fontColor(this.textColor)
26.         .fontSize(30)
27.         .margin(30)
28.     }.width('100%')
29.   }
30. }

复制代码

2:组件生命周期

组件生命周期，即一般用@Component装饰的自界说组件的生命周期，提供以下生命周期接口：

• aboutToAppear：组件即将出现时回调该接口，具体时机为在创建自界说组件的新实例后，在执行其build()函数之前执行。
  

1. aboutToAppear?(): void

复制代码

aboutToAppear函数在创建自界说组件的新实例后，在执行其build()函数之前执行。允许在aboutToAppear函数中改变状态变量，更改将在后续执行build()函数中生效。
   注意⚠️：从API version 9开始，该接口支持在ArkTS卡片中利用。
  

• aboutToDisappear：在自界说组件即将析构烧毁时执行。
  

1. aboutToDisappear?(): void

复制代码

aboutToDisappear函数在自界说组件析构烧毁之前执行。不允许在aboutToDisappear函数中改变状态变量，特殊是@Link变量的修改大概会导致应用步伐活动不稳定。
   注意⚠️：从API version 9开始，该接口支持在ArkTS卡片中利用。
  生命周期流程如下图所示，下图展示的是被@Entry装饰的组件生命周期。

根据上面的流程图，我们从自界说组件的初始创建、重新渲染和删除来具体表明。
自界说组件的创建和渲染流程

• 自界说组件的创建：自界说组件的实例由ArkUI框架创建。
  
• 初始化自界说组件的成员变量：通过本地默认值或者构造方法传递参数来初始化自界说组件的成员变量，初始化次序为成员变量的界说次序。
  
• 如果开发者界说了aboutToAppear，则执行aboutToAppear方法。
  
• 在初次渲染的时间，执行build方法渲染系统组件，如果子组件为自界说组件，则创建自界说组件的实例。在执行build()函数的过程中，框架会观察每个状态变量的读取状态，将保存两个map：
  

a: 状态变量 -> UI组件（包括ForEach和if）。
b: UI组件 -> 此组件的更新函数，即一个lambda方法，作为build()函数的子集，创建对应的UI组件并执行其属性方法，示意如下。

1. build() {
2.   ...
3.   this.observeComponentCreation(() => {
4.     Button.create();
5.   })
7.   this.observeComponentCreation(() => {
8.     Text.create();
9.   })
10.   ...
11. }

复制代码

当应用在后台启动时，此时应用进程并没有烧毁，以是仅需要执行onPageShow。
自界说组件重新渲染

当事件句柄被触发（比如设置了点击事件，即触发点击事件）改变了状态变量时，或者LocalStorage / AppStorage中的属性更改，并导致绑定的状态变量更改其值时：

• 框架观察到了变革，将启动重新渲染。
  
• 根据框架持有的两个map（自界说组件的创建和渲染流程中第4步），框架可以知道该状态变量管理了哪些UI组件，以及这些UI组件对应的更新函数。执行这些UI组件的更新函数，实现最小化更新。
  

自界说组件的删除

如果if组件的分支改变，或者ForEach循环渲染中数组的个数改变，组件将被删除：

• 在删除组件之前，将调用其aboutToDisappear生命周期函数，标记着该节点将要被烧毁。ArkUI的节点删除机制是：后端节点直接从组件树上摘下，后端节点被烧毁，对前端节点解引用，当前端节点已经没有引用时，将被JS虚拟机垃圾接纳。
  
• 自界说组件和它的变量将被删除，如果其有同步的变量，比如@Link、@Prop、@StorageLink，将从同步源上取消注册。
  

不建议在生命周期aboutToDisappear内利用async await，如果在生命周期的aboutToDisappear利用异步操作（Promise或者回调方法），自界说组件将被保留在Promise的闭包中，直到回调方法被执行完，这个活动阻止了自界说组件的垃圾接纳。
以下示例展示了生命周期的调用时机：

1. // Index.ets
2. import router from '@ohos.router';
4. @Entry
5. @Component
6. struct MyComponent {
7.   @State showChild: boolean = true;
9.   // 只有被@Entry装饰的组件才可以调用页面的生命周期
10.   onPageShow() {
11.     console.info('Index onPageShow');
12.   }
13.   // 只有被@Entry装饰的组件才可以调用页面的生命周期
14.   onPageHide() {
15.     console.info('Index onPageHide');
16.   }
18.   // 只有被@Entry装饰的组件才可以调用页面的生命周期
19.   onBackPress() {
20.     console.info('Index onBackPress');
21.   }
23.   // 组件生命周期
24.   aboutToAppear() {
25.     console.info('MyComponent aboutToAppear');
26.   }
28.   // 组件生命周期
29.   aboutToDisappear() {
30.     console.info('MyComponent aboutToDisappear');
31.   }
33.   build() {
34.     Column() {
35.       // this.showChild为true，创建Child子组件，执行Child aboutToAppear
36.       if (this.showChild) {
37.         Child()
38.       }
39.       // this.showChild为false，删除Child子组件，执行Child aboutToDisappear
40.       Button('create or delete Child').onClick(() => {
41.         this.showChild = false;
42.       })
43.       // push到Page2页面，执行onPageHide
44.       Button('push to next page')
45.         .onClick(() => {
46.           router.pushUrl({ url: 'pages/Page2' });
47.         })
48.     }
50.   }
51. }
53. @Component
54. struct Child {
55.   @State title: string = 'Hello World';
56.   // 组件生命周期
57.   aboutToDisappear() {
58.     console.info('[lifeCycle] Child aboutToDisappear')
59.   }
60.   // 组件生命周期
61.   aboutToAppear() {
62.     console.info('[lifeCycle] Child aboutToAppear')
63.   }
65.   build() {
66.     Text(this.title).fontSize(50).onClick(() => {
67.       this.title = 'Hello ArkUI';
68.     })
69.   }
70. }

复制代码

以上示例中，Index页面包含两个自界说组件，一个是被@Entry装饰的MyComponent，也是页面的入口组件，即页面的根节点；一个是Child，是MyComponent的子组件。只有@Entry装饰的节点才可以生效页面的生命周期方法，以是MyComponent中声明了当前Index页面的页面生命周期函数。MyComponent和其子组件Child也同时也声明了组件的生命周期函数。

• 应用冷启动的初始化流程为：MyComponent aboutToAppear --> MyComponent build --> Child aboutToAppear --> Child build --> Child build执行完毕 --> MyComponent build执行完毕 --> Index onPageShow。
  
• 点击“delete Child”，if绑定的this.showChild变成false，删除Child组件，会执行Child aboutToDisappear方法。
  
• 点击“push to next page”，调用router.pushUrl接口，跳转到另外一个页面，当前Index页面隐蔽，执行页面生命周期Index onPageHide。此处调用的是router.pushUrl接口，Index页面被隐蔽，并没有烧毁，以是只调用onPageHide。跳转到新页面后，执行初始化新页面的生命周期的流程。
  
• 如果调用的是router.replaceUrl，则当前Index页面被烧毁，执行的生命周期流程将变为：Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。上文已经提到，组件的烧毁是从组件树上直接摘下子树，以是先调用父组件的aboutToDisappear，再调用子组件的aboutToDisappear，然后执行初始化新页面的生命周期流程。
  
• 点击返回按钮，触发页面生命周期Index onBackPress，且触发返回一个页面后会导致当前Index页面被烧毁。
  
• 最小化应用或者应用进入后台，触发Index onPageHide。当前Index页面没有被烧毁，以是并不会执行组件的aboutToDisappear。应用回到前台，执行Index onPageShow。
  
• 退出应用，执行Index onPageHide --> MyComponent aboutToDisappear --> Child aboutToDisappear。
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)

Powered by Discuz! X3.4