UIAbility組件間交互（設(shè)備內(nèi)）
UIAbility是系統(tǒng)調(diào)度的最小單元。在設(shè)備內(nèi)的功能模塊之間跳轉(zhuǎn)時，會涉及到啟動特定的UIAbility，該UIAbility可以是應(yīng)用內(nèi)的其他UIAbility，也可以是其他應(yīng)用的UIAbility（例如啟動三方支付UIAbility）。
本文將從如下場景分別介紹設(shè)備內(nèi)UIAbility間的交互方式。
啟動應(yīng)用內(nèi)的UIAbility。啟動應(yīng)用內(nèi)的UIAbility并獲取返回結(jié)果。啟動其他應(yīng)用的UIAbility。啟動其他應(yīng)用的UIAbility并獲取返回結(jié)果。啟動UIAbility的指定頁面。通過Call調(diào)用實現(xiàn)UIAbility交互（僅對系統(tǒng)應(yīng)用開放）。
一、啟動應(yīng)用內(nèi)的UIAbility
當一個應(yīng)用內(nèi)包含多個UIAbility時，存在應(yīng)用內(nèi)啟動UIAbility的場景。例如在支付應(yīng)用中從入口UIAbility啟動收付款UIAbility。
假設(shè)應(yīng)用中有兩個UIAbility：EntryAbility和FuncAbility（可以在應(yīng)用的一個Module中，也可以在的不同Module中），需要從EntryAbility的頁面中啟動FuncAbility。
1.在EntryAbility中，通過調(diào)用startAbility()方法啟動UIAbility，want為UIAbility實例啟動的入口參數(shù)，其中bundleName為待啟動應(yīng)用的Bundle名稱，abilityName為待啟動的UIAbility名稱，moduleName在待啟動的UIAbility屬于不同的Module時添加，parameters為自定義信息參數(shù)。示例中的context的獲取方式參見獲取UIAbility的Context屬性。

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必選
    parameters: { // 自定義信息
        info: '來自EntryAbility Index頁面',
    },
}
// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbility(wantInfo).then(() => {
    // ...
}).catch((err) => {
    // ...
})

2.在FuncAbility的生命周期回調(diào)文件中接收EntryAbility傳遞過來的參數(shù)。

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

export default class FuncAbility extends UIAbility {
    onCreate(want, launchParam) {
    // 接收調(diào)用方UIAbility傳過來的參數(shù)
        let funcAbilityWant = want;
        let info = funcAbilityWant?.parameters?.info;
        // ...
    }
}

3.在FuncAbility業(yè)務(wù)完成之后，如需要停止當前UIAbility實例，在FuncAbility中通過調(diào)用terminateSelf()方法實現(xiàn)。

// context為需要停止的UIAbility實例的AbilityContext
this.context.terminateSelf((err) => {
    // ...
});

二、啟動應(yīng)用內(nèi)的UIAbility并獲取返回結(jié)果
在一個EntryAbility啟動另外一個FuncAbility時，希望在被啟動的FuncAbility完成相關(guān)業(yè)務(wù)后，能將結(jié)果返回給調(diào)用方。例如在應(yīng)用中將入口功能和帳號登錄功能分別設(shè)計為兩個獨立的UIAbility，在帳號登錄UIAbility中完成登錄操作后，需要將登錄的結(jié)果返回給入口UIAbility。
1.在EntryAbility中，調(diào)用startAbilityForResult()接口啟動FuncAbility，異步回調(diào)中的data用于接收FuncAbility停止自身后返回給EntryAbility的信息。示例中的context的獲取方式參見獲取UIAbility的Context屬性。

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必選
    parameters: { // 自定義信息
        info: '來自EntryAbility Index頁面',
    },
}
// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbilityForResult(wantInfo).then((data) => {
    // ...
}).catch((err) => {
    // ...
})

2.在FuncAbility停止自身時，需要調(diào)用terminateSelfWithResult()方法，入?yún)bilityResult為FuncAbility需要返回給EntryAbility的信息。

const RESULT_CODE: number = 1001;
let abilityResult = {
    resultCode: RESULT_CODE,
    want: {
        bundleName: 'com.example.myapplication',
        abilityName: 'FuncAbility',
        moduleName: 'module1',
        parameters: {
            info: '來自FuncAbility Index頁面',
        },
    },
}
// context為被調(diào)用方UIAbility的AbilityContext
this.context.terminateSelfWithResult(abilityResult, (err) => {
    // ...
});

3.FuncAbility停止自身后，EntryAbility通過startAbilityForResult()方法回調(diào)接收被FuncAbility返回的信息，RESULT_CODE需要與前面的數(shù)值保持一致。

const RESULT_CODE: number = 1001;

// ...

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbilityForResult(want).then((data) => {
    if (data?.resultCode === RESULT_CODE) {
        // 解析被調(diào)用方UIAbility返回的信息
        let info = data.want?.parameters?.info;
        // ...
    }
}).catch((err) => {
    // ...
})

三、啟動其他應(yīng)用的UIAbility
啟動其他應(yīng)用的UIAbility，通常用戶只需要完成一個通用的操作（例如需要選擇一個文檔應(yīng)用來查看某個文檔的內(nèi)容信息），推薦使用隱式Want啟動。系統(tǒng)會根據(jù)調(diào)用方的want參數(shù)來識別和啟動匹配到的應(yīng)用UIAbility。
啟動UIAbility有顯式Want啟動和隱式Want啟動兩種方式。
顯式Want啟動：啟動一個確定應(yīng)用的UIAbility，在want參數(shù)中需要設(shè)置該應(yīng)用bundleName和abilityName，當需要拉起某個明確的UIAbility時，通常使用顯式Want啟動方式。

隱式Want啟動：根據(jù)匹配條件由用戶選擇啟動哪一個UIAbility，即不明確指出要啟動哪一個UIAbility（abilityName參數(shù)未設(shè)置），在調(diào)用startAbility()方法時，其入?yún)ant中指定了一系列的entities字段（表示目標UIAbility額外的類別信息，如瀏覽器、視頻播放器）和actions字段（表示要執(zhí)行的通用操作，如查看、分享、應(yīng)用詳情等）等參數(shù)信息，然后由系統(tǒng)去分析want，并幫助找到合適的UIAbility來啟動。當需要拉起其他應(yīng)用的UIAbility時，開發(fā)者通常不知道用戶設(shè)備中應(yīng)用的安裝情況，也無法確定目標應(yīng)用的bundleName和abilityName，通常使用隱式Want啟動方式。
本部分主要講解如何通過隱式Want啟動其他應(yīng)用的UIAbility。
1.將多個待匹配的文檔應(yīng)用安裝到設(shè)備，在其對應(yīng)UIAbility的module.json5配置文件中，配置skills的entities字段和actions字段。

{
  "module": {
    "abilities": [
      {
        // ...
        "skills": [
          {
            "entities": [
              // ...
              "entity.system.default"
            ],
            "actions": [
              // ...
              "ohos.want.action.viewData"
            ]
          }
        ]
      }
    ]
  }
}

2.在調(diào)用方want參數(shù)中的entities和action需要被包含在待匹配UIAbility的skills配置的entities和actions中。系統(tǒng)匹配到符合entities和actions參數(shù)條件的UIAbility后，會彈出選擇框展示匹配到的UIAbility實例列表供用戶選擇使用。示例中的context的獲取方式參見獲取UIAbility的Context屬性。

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    // uncomment line below if wish to implicitly query only in the specific bundle.
    // bundleName: 'com.example.myapplication',
    action: 'ohos.want.action.viewData',
    // entities can be omitted.
    entities: ['entity.system.default'],
}

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbility(wantInfo).then(() => {
    // ...
}).catch((err) => {
    // ...
})

效果示意如下圖所示，點擊“打開PDF文檔”時，會彈出選擇框供用戶選擇。
?

3.在文檔應(yīng)用使用完成之后，如需要停止當前UIAbility實例，通過調(diào)用terminateSelf()方法實現(xiàn)。

// context為需要停止的UIAbility實例的AbilityContext
this.context.terminateSelf((err) => {
    // ...
});

?文章來源地址http://www.zghlxwxcb.cn/news/detail-597155.html

到了這里，關(guān)于HarmonyOS/OpenHarmony應(yīng)用開發(fā)-Stage模型UIAbility組件使用（五）的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！