AbilityStage Component Container

AbilityStage is a component container at the module level. When the HAP of an application is loaded for the first time, an AbilityStage instance is created. You can perform operations such as initialization on the instance.

An AbilityStage instance corresponds to a module.

AbilityStage is not automatically generated in the default project of DevEco Studio. To use AbilityStage, you can manually create an AbilityStage file. The procedure is as follows:

  1. In the ets directory of the Module project, right-click and choose New > Directory to create a directory named myabilitystage.

  2. In the myabilitystage directory, right-click and choose New > TypeScript File to create a file named MyAbilityStage.ts.

  3. Open the MyAbilityStage.ts file, and import the dependency package of AbilityStage. Customize a class that inherits from AbilityStage, and add the required lifecycle callbacks. The following code snippet adds the onCreate() lifecycle callback.

    import AbilityStage from '@ohos.app.ability.AbilityStage';
    
    export default class MyAbilityStage extends AbilityStage {
      onCreate() {
        // When the HAP of the application is loaded for the first time, initialize the module.
      }
      onAcceptWant(want) {
        // Triggered only for the ability with the specified launch type.
        return "MyAbilityStage";
      }
    }
    
  4. Set srcEntry in the module.json5 file to the code path of the module.

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

AbilityStage has the lifecycle callback onCreate() and the event callbacks onAcceptWant(), onConfigurationUpdated(), and onMemoryLevel().

  • onCreate() lifecycle callback: Before the first UIAbility instance of a module is loaded, an AbilityStage instance is created. This callback is invoked when the AbilityStage instance is created. The AbilityStage module notifies you of when you can perform module initialization such as resource pre-loading and thread creation during module loading.

  • onAcceptWant() event callback: triggered when the UIAbility is started in specified mode. For details, see UIAbility Component Launch Type.

  • onConfigurationUpdated() event callback: triggered when the global system configuration changes. The global system configuration, such as the system language and theme, are defined in the Configuration class before project configuration.

  • onMemoryLevel() event callback: triggered when the system adjusts the memory.

When an application is switched to the background, it is cached in the background. This adversely affects the overall system performance. When system resources are insufficient, the system reclaims memory from applications in multiple ways. For example, the system may stop applications to release memory for executing key tasks. To further maintain the balance of the system memory and prevent the system from stopping application processes, you can subscribe to the system memory changes in the onMemoryLevel() lifecycle callback of AbilityStage to release unnecessary resources.

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

export default class MyAbilityStage extends AbilityStage {
  onMemoryLevel(level) {
    // Release unnecessary memory based on the change of available system memory.
  }
}