使用FeatureAbility模塊啟動其他Ability

1 前言

在HarmonyOS/OpenHarmony應用程序中一切皆Ability(能力),即是每個界面都可以是Ability,每個功能都可以是Ability,又將Ability分為FA(FeatureAbility)和PA(ParticleAbility)兩種類型。其中FA唯一支持的模板Page Ability,其用于提供與用戶交互能力,在設備主界面上有可見的桌面圖標,能夠通過圖標啟動應用程序進行交互操作;而PA又分為Service Ability和Data Ability,前者用于提供后臺運行任務的能力,后者用于應用管理自身和其他應用存儲數據的訪問能力,因此PA是無界面的,用戶無法對其直接操作,可以和FA配合使用。

在JS/eTS語言中,Ability框架又被分為FA模型和Stage模型(該模型目前僅支持OpenHarmony API9)。在DevEco Studio 3.0 Beta4中HarmonyOS使用了OpenHarmony API8,因此可以大膽猜測一下后續(xù)API版本會不會以OpenHarmony API版本為主。 本節(jié)以API8為主,關于Stage模型的詳細介紹將在今后的章節(jié)中介紹。此處的FA是一種模型,其中的Ability分為PageAbility、ServiceAbility、DataAbility、FormAbility,與FA(FeatureAbility不能混淆)。

  • PageAbility 是用戶可見并可交互的Ability實例,可開發(fā)在設備主界面上具有入口圖標的應用程序;
  • ServiceAbility 運行在后臺的、無界面的,用戶不可直接操作的,可以通過Page Ability調起;
  • DataAbility 為其他Ability提供數據訪問的支撐,也是運行在后臺的、無界面的;
  • FormAbility 是卡片Ability,是一種新型的Ability,用于呈現特定信息的入口界面。

JS/eTS語言是方舟開發(fā)框架(ArkUI)為開發(fā)者開發(fā)應用程序提供的兩種開發(fā)范式,前者是基于JS擴展的類Web開發(fā)范式,若開發(fā)者具備小程序開發(fā)經驗則可直接上手,更傾向于Web前端開發(fā)人員;而后者則是基于TS擴展的聲明式開發(fā)范式,與Flutter開發(fā)應用程序類似,更傾向于移動系統(tǒng)應用和系統(tǒng)應用開發(fā)人員。

2 準備工作

  • 開發(fā)工具:DevEco Studio 3.0 Beta4
  • 運行設備:P50(HarmonyOS3.0) / DAYU200(OpenHarmony 3.0 Beta2)
  • 桌面工具:Scrcpy(用于在PC桌面上共享P50界面,OpenHarmony暫無)
  • 使用DevEco Studio創(chuàng)建開發(fā)語言為eTS語言,編譯版本為8,項目名稱為FaeTSSample的HarmonyOS應用程序(由于DevEco Studio 3.0 Beta4特性,HarmonyOS和OpenHarmony互通,當前HarmonyOS的應用程序可以直接運行在OpenHarmony操作系統(tǒng)的設備上)

3 有界面的PageAbility

通過DevEco Studio創(chuàng)建Application(應用程序)會默認創(chuàng)建PageAbility模板代碼,在ArkUI框架中,PageAbility相關能力是通過單獨的featureAbility模塊實現的,其由于為用戶提供了可交互的界面,因此生命周期較于其他Ability復雜度較高,PageAbility生命周期回調通過app.js/app.ets中的函數實現,當前app.js僅支持onCreateonDestroy回調,而app.ets支持全量生命周期回調,本節(jié)以eTS語言為主,主要介紹eTS語言開發(fā)中PageAbility生命周期回調,如下圖所示:

image.png

可以在app.ets中將所有的聲明周期函數重寫,并運行應用程序查看聲明周期回調信息,代碼如下所示:

export default {
  onCreate() {
    console.info('FaeTSSample Application onCreate')
  },
  onActive() {
    console.info('FaeTSSample Application onActive')
  },
  onInactive() {
    console.info('FaeTSSample Application onInactive')
  },
  onHide() {
    console.info('FaeTSSample Application onHide')
  },
  onShow() {
    console.info('FaeTSSample Application onShow')
  },
  onDestroy() {
    console.info('FaeTSSample Application onDestroy')
  },
}
image.png

3.1 使用featureAbility模塊啟動本地PageAbility

HarmonyOS/OpenHarmony為用戶提供了路由跳轉方式,而路由跳轉方式是頁面間跳轉,可以利用featureAbility模塊進行Ability之間的跳轉,并且featureAbility僅能在PageAbility類型的Ability中調用。

使用featureAbility模塊需要先在具體的業(yè)務邏輯界面使用以下代碼引入模塊:

import featureAbility from '@ohos.ability.featureAbility';

featureAbility模塊提供了多個方法用于啟動新的Ability、獲取dataAbilityHelper、設置此PageAbility、獲取當前Ability對應的窗口、連接服務等能力。featureAbility提供的啟動新Ability能力如下表所示:

名稱 描述
startAbility 啟動新的Ability
startAbilityForResult 啟動新的Ability,并在該Ability被銷毀時返回執(zhí)行結果

接下來聊聊在應用程序中如何啟動新的Ability,首先在項目entry目錄右鍵New-->Ability --> Page Ability,填寫Ability相關信息如下圖所示。

image.png

目錄結構如下圖所示:

image.png

startAbility方法有兩種調用形式,一種是callback,另一種是Promise,都需要傳遞StartAbilityParameter參數設定目標Ability。

startAbility(StartAbilityParameter, AsyncCallback<number>): void
startAbility(StartAbilityParameter): Promise<number>

其中StartAbilityParameter參數由Want(包含有關目標Ability信息)和abilityStartSetting(可以通過該屬性攜帶參數,不是必須條件)。其中國Want參數提供系統(tǒng)的基本通信能力,比如在打開時指定新啟動的Ability信息,或者銷毀啟動的Ability后返回的額外信息。點擊MainAbility中的按鈕啟動SecondAbility,修改代碼如下所示:

// MainAbility/page/index.ets
featureAbility.startAbility({
  want: {
    bundleName: "com.tetcl.fts", // 包描述,對應config.json中的app.bundleName,當然也可以是本機其他應用的包名
    abilityName: "com.example.entry.SecondAbility" // 目標Ability名稱,對應config.json中的module.package.類名
  }
})

使用真機設備運行應用程序,點擊按鈕,查看是否跳轉到Second Ability界面。

image.png

3.2 使用featureAbility模塊啟動遠程PageAbility

在Want模塊中,有一個deviceId屬性,該屬性表示運行指定Ability的設備ID,也就是若我們知道了其他設備的標識碼和包名稱以及具體的Ability名稱,我們就可以啟動其他設備的應用程序。該屬性的值需要使用DeviceManager模塊的接口獲取,當前僅對系統(tǒng)應用開放,也就是自定義的應用程序是無法調起它的Ability。由于設備有限,無法提供測試,因此具體的操作詳見官方文檔。

?著作權歸作者所有,轉載或內容合作請聯系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容