UIAbility組件基本用法

UIAbility組件的基本用法包括：指定UIAbility的啟動頁面以及獲取UIAbility的上下文[UIAbilityContext]。

指定UIAbility的啟動頁面

應用中的UIAbility在啟動過程中，需要指定啟動頁面，否則應用啟動后會因為沒有默認加載頁面而導致白屏。可以在UIAbility的onWindowStageCreate()生命周期回調中，通過[WindowStage]對象的loadContent()方法設置啟動頁面。

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage): void {
    // Main window is created, set main page for this ability
    windowStage.loadContent('pages/Index', (err, data) = > {
      // ...
    });
  }
  // ...
}

說明： 在DevEco Studio中創建的UIAbility中，該UIAbility實例默認會加載Index頁面，根據需要將Index頁面路徑替換為需要的頁面路徑即可。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

獲取UIAbility的上下文信息

UIAbility類擁有自身的上下文信息，該信息為[UIAbilityContext]類的實例，[UIAbilityContext]類擁有abilityInfo、currentHapModuleInfo等屬性。通過UIAbilityContext可以獲取UIAbility的相關配置信息，如包代碼路徑、Bundle名稱、Ability名稱和應用程序需要的環境狀態等屬性信息，以及可以獲取操作UIAbility實例的方法（如startAbility()、connectServiceExtensionAbility()、terminateSelf()等）。 如果需要在頁面中獲得當前Ability的Context，可調用[getContext]接口獲取當前頁面關聯的UIAbilityContext或ExtensionContext。

• 在UIAbility中可以通過this.context獲取UIAbility實例的上下文信息。

  import UIAbility from '@ohos.app.ability.UIAbility';
  import AbilityConstant from '@ohos.app.ability.AbilityConstant';
  import Want from '@ohos.app.ability.Want';
  
  export default class EntryAbility extends UIAbility {
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
      // 獲取UIAbility實例的上下文
      let context = this.context;
      // ...
    }
  }
  

• 在頁面中獲取UIAbility實例的上下文信息，包括導入依賴資源context模塊和在組件中定義一個context變量兩個部分。

  import common from '@ohos.app.ability.common';
  import Want from '@ohos.app.ability.Want';
  
  @Entry
  @Component
  struct Page_EventHub {
    private context = getContext(this) as common.UIAbilityContext;
  
    startAbilityTest() : void {
      let want: Want = {
        // Want參數信息
      };
      this.context.startAbility(want);
    }
  
    // 頁面展示
    build() {
      // ...
    }
  }
  

  也可以在導入依賴資源context模塊后，在具體使用[UIAbilityContext]前進行變量定義。

  import common from '@ohos.app.ability.common';
  import Want from '@ohos.app.ability.Want';
  
  @Entry
  @Component
  struct Page_UIAbilityComponentsBasicUsage {
  
    startAbilityTest(): void {
      let context = getContext(this) as common.UIAbilityContext;
      let want: Want = {
        // Want參數信息
      };
      context.startAbility(want);
    }
  
    // 頁面展示
    build() {
      // ...
    }
  }
  

審核編輯 黃宇