UIAbility組件基本用法

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

指定UIAbility的啟動頁面

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

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中創(chuàng)建的UIAbility中，該UIAbility實例默認(rèn)會加載Index頁面，根據(jù)需要將Index頁面路徑替換為需要的頁面路徑即可。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

獲取UIAbility的上下文信息

UIAbility類擁有自身的上下文信息，該信息為[UIAbilityContext]類的實例，[UIAbilityContext]類擁有abilityInfo、currentHapModuleInfo等屬性。通過UIAbilityContext可以獲取UIAbility的相關(guān)配置信息，如包代碼路徑、Bundle名稱、Ability名稱和應(yīng)用程序需要的環(huán)境狀態(tài)等屬性信息，以及可以獲取操作UIAbility實例的方法（如startAbility()、connectServiceExtensionAbility()、terminateSelf()等）。 如果需要在頁面中獲得當(dāng)前Ability的Context，可調(diào)用[getContext]接口獲取當(dāng)前頁面關(guān)聯(lián)的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實例的上下文信息，包括導(dǎo)入依賴資源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參數(shù)信息
      };
      this.context.startAbility(want);
    }
  
    // 頁面展示
    build() {
      // ...
    }
  }
  

  也可以在導(dǎo)入依賴資源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參數(shù)信息
      };
      context.startAbility(want);
    }
  
    // 頁面展示
    build() {
      // ...
    }
  }
  

審核編輯 黃宇