diff --git a/zh-cn/application-dev/ability/fa-pageability.md b/zh-cn/application-dev/ability/fa-pageability.md index 8433c7604ef2fd9250d976c972a0bdaa431c8f2e..be05ac164e0c7d39c4f409b122fe5178f07f1a94 100644 --- a/zh-cn/application-dev/ability/fa-pageability.md +++ b/zh-cn/application-dev/ability/fa-pageability.md @@ -19,9 +19,9 @@ Page模板(以下简称“Page”)是FA唯一支持的模板,用于提供 - **INITIAL**:初始化状态,也表示停止状态,表示当前Ability未运行,Ability被启动后由INITIAL态进入INACTIVE状态。 - - **INACTIVE**:未激活状态,表示当前窗口已显示但是无焦点状态,由于Window暂未支持焦点的概念,当前状态与ACTIVE一致。 + - **INACTIVE**:失去焦点状态,表示当前窗口已显示但是无焦点状态。 - - **ACTIVE**:前台激活状态,表示当前窗口已显示,并获取焦点,Ability在退到后台之前先由ACTIVE状态进入INACTIVE状态。 + - **ACTIVE**:前台激活状态,表示当前窗口已显示,并获取焦点。 - **BACKGROUND**: 后台状态,表示当前Ability退到后台,Ability在被销毁后由BACKGROUND状态进入INITIAL状态,或者重新被激活后由BACKGROUND状态进入ACTIVE状态。 @@ -29,7 +29,56 @@ Page模板(以下简称“Page”)是FA唯一支持的模板,用于提供 ![fa-pageAbility-lifecycle](figures/fa-pageAbility-lifecycle.png) - +PageAbility提供如下生命周期回调,开发者可以在 app.js/app.ets 中重写生相关命周期函数 。 + +* onShow() + + Ability由后台不可见状态切换到前台可见状态调用onShow方法,此时用户在屏幕可以看到该Ability。 + +* onHide() + + Ability由前台切换到后台不可见状态时调用onHide方法,此时用户在屏幕看不到该Ability。 + +* onDestroy() + + 应用退出,销毁Ability对象前调用onDestroy方法,开发者可以在该方法里做一些回收资源、清空缓存等应用退出前的准备工作。 + +* onCreate() + + Ability第一次启动创建Ability时调用onCreate方法,开发者可以在该方法里做一些应用初始化工作。 + +* onInactive() + + Ability失去焦点时调用onInactive方法,Ability在进入后台状态时会先失去焦点,再进入后台。 + +* onActive() + + Ability切换到前台,并且已经获取焦点时调用onActive方法。 + +* 示例 + +```javascript +export default { + onCreate() { + console.info('Application onCreate') + }, + onDestroy() { + console.info('Application onDestroy') + }, + onShow(){ + console.info('Application onShow') + }, + onHide(){ + console.info('Application onHide') + }, + onInactive(){ + console.info('Application onInactive') + }, + onActive(){ + console.info('Application onActive') + }, +} +``` ## 启动本地PageAbility diff --git a/zh-cn/application-dev/ability/figures/fa-pageAbility-lifecycle.png b/zh-cn/application-dev/ability/figures/fa-pageAbility-lifecycle.png index 269d06b73dde7c952b56cd76f1842a856dde3c01..75c61991a79e17ece3d800f9440f1dfcd9b6804d 100644 Binary files a/zh-cn/application-dev/ability/figures/fa-pageAbility-lifecycle.png and b/zh-cn/application-dev/ability/figures/fa-pageAbility-lifecycle.png differ diff --git a/zh-cn/application-dev/ability/figures/page-ability-lifecycle.png b/zh-cn/application-dev/ability/figures/page-ability-lifecycle.png old mode 100644 new mode 100755 index 30160c8129c6556c2784a3bb893ad4cc67332339..edb49acd0647f3af7355ceda987c5ca812866128 Binary files a/zh-cn/application-dev/ability/figures/page-ability-lifecycle.png and b/zh-cn/application-dev/ability/figures/page-ability-lifecycle.png differ