AbilityStage組件容器

AbilityStage是一個[Module]級別的組件容器，應用的HAP在首次加載時會創建一個AbilityStage實例，可以對該Module進行初始化等操作。

AbilityStage與Module一一對應，即一個Module擁有一個AbilityStage。

DevEco Studio默認工程中未自動生成AbilityStage，如需要使用AbilityStage的能力，可以手動新建一個AbilityStage文件，具體步驟如下。

1. 在工程Module對應的ets目錄下，右鍵選擇“New > Directory”，新建一個目錄并命名為myabilitystage。

2. 在myabilitystage目錄，右鍵選擇“New > ArkTS File”，新建一個文件并命名為MyAbilityStage.ts。

3. 打開MyAbilityStage.ts文件，導入AbilityStage的依賴包，自定義類繼承AbilityStage并加上需要的生命周期回調，示例中增加了一個onCreate()生命周期回調。

   import AbilityStage from '@ohos.app.ability.AbilityStage';
   import type Want from '@ohos.app.ability.Want';
   
   export default class MyAbilityStage extends AbilityStage {
     onCreate(): void {
       // 應用的HAP在首次加載的時，為該Module初始化操作
     }
     onAcceptWant(want: Want): string {
       // 僅specified模式下觸發
       return 'MyAbilityStage';
     }
   }
   
   `HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
   

   

4. 在[module.json5配置文件]中，通過配置 srcEntry 參數來指定模塊對應的代碼路徑，以作為HAP加載的入口。

{
  "module": {
    "name": "entry",
    "type": "entry",
    "srcEntry": "./ets/myabilitystage/MyAbilityStage.ts",
    ...
  }
}

[AbilityStage]擁有[onCreate()]生命周期回調和[onAcceptWant()]、[onConfigurationUpdated()]、[onMemoryLevel()]事件回調。

• [onCreate()]生命周期回調：在開始加載對應Module的第一個UIAbility實例之前會先創建AbilityStage，并在AbilityStage創建完成之后執行其onCreate()生命周期回調。AbilityStage模塊提供在Module加載的時候，通知開發者，可以在此進行該Module的初始化（如資源預加載，線程創建等）能力。
• [onAcceptWant()]事件回調：UIAbility[指定實例模式（specified）]啟動時候觸發的事件回調，具體使用請參見[UIAbility啟動模式綜述]。
• [onConfigurationUpdated()]事件回調：當系統全局配置發生變更時觸發的事件，系統語言、深淺色等，配置項目前均定義在[Configuration]類中。
• [onMemoryLevel()]事件回調：當系統調整內存時觸發的事件。

應用被切換到后臺時，系統會將在后臺的應用保留在緩存中。即使應用處于緩存中，也會影響系統整體性能。當系統資源不足時，系統會通過多種方式從應用中回收內存，必要時會完全停止應用，從而釋放內存用于執行關鍵任務。為了進一步保持系統內存的平衡，避免系統停止用戶的應用進程，可以在AbilityStage中的onMemoryLevel()生命周期回調中訂閱系統內存的變化情況，釋放不必要的資源。

import AbilityStage from '@ohos.app.ability.AbilityStage';
import type AbilityConstant from '@ohos.app.ability.AbilityConstant';

export default class MyAbilityStage extends AbilityStage {
  onMemoryLevel(level: AbilityConstant.MemoryLevel): void {
    // 根據系統可用內存的變化情況，釋放不必要的內存
  }
}

審核編輯 黃宇