UIAbility 組件間交互（設(shè)備內(nèi)）

在設(shè)備內(nèi)，UIAbility（用戶界面能力）是系統(tǒng)調(diào)度的最小單元，它們負(fù)責(zé)展示用戶界面和執(zhí)行相關(guān)的業(yè)務(wù)邏輯。設(shè)備內(nèi)的不同功能模塊之間的交互是應(yīng)用程序開(kāi)發(fā)中的重要部分。本文將探討設(shè)備內(nèi) UIAbility 之間的交互方式，包括啟動(dòng)應(yīng)用內(nèi)的 UIAbility、啟動(dòng)其他應(yīng)用的 UIAbility 以及通過(guò) Call 調(diào)用實(shí)現(xiàn) UIAbility 交互。

啟動(dòng)應(yīng)用內(nèi)的 UIAbility

在一個(gè)應(yīng)用內(nèi)部存在多個(gè) UIAbility 時(shí)，可能需要從一個(gè) UIAbility 啟動(dòng)另一個(gè) UIAbility。例如，在支付應(yīng)用中，從主界面 UIAbility 啟動(dòng)收款 UIAbility。下面是一個(gè)示例代碼，演示了如何在 EntryAbility 中啟動(dòng) FuncAbility：

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必選
    parameters: { // 自定義信息
        info: '來(lái)自EntryAbility Index頁(yè)面',
    },
};

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbility(wantInfo).then(() => {
    // 處理啟動(dòng)成功后的邏輯
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

在 FuncAbility 中，可以通過(guò)生命周期回調(diào)方法 onCreate 接收來(lái)自 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傳過(guò)來(lái)的參數(shù)
        let funcAbilityWant = want;
        let info = funcAbilityWant?.parameters?.info;
        // ...
    }
}

啟動(dòng)應(yīng)用內(nèi)的 UIAbility 并獲取返回結(jié)果

有時(shí)候，我們希望從一個(gè) UIAbility 啟動(dòng)另一個(gè) UIAbility，并在后者完成業(yè)務(wù)后獲取返回結(jié)果。例如，在登錄 UIAbility 完成登錄操作后，將登錄結(jié)果返回給主界面 UIAbility。下面是一個(gè)示例代碼：

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    bundleName: 'com.example.myapplication',
    abilityName: 'FuncAbility',
    moduleName: 'module1', // moduleName非必選
    parameters: { // 自定義信息
        info: '來(lái)自EntryAbility Index頁(yè)面',
    },
};

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbilityForResult(wantInfo).then((data) => {
    // 處理從FuncAbility返回的結(jié)果
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

在 FuncAbility 中，完成業(yè)務(wù)后需要調(diào)用 terminateSelfWithResult 方法返回結(jié)果：

const RESULT_CODE: number = 1001;
let abilityResult = {
    resultCode: RESULT_CODE,
    want: {
        bundleName: 'com.example.myapplication',
        abilityName: 'FuncAbility',
        moduleName: 'module1',
        parameters: {
            info: '來(lái)自FuncAbility Index頁(yè)面',
        },
    },
};

// context為被調(diào)用方UIAbility的AbilityContext
this.context.terminateSelfWithResult(abilityResult, (err) => {
    // 處理停止自身后的邏輯
});

在調(diào)用方的回調(diào)中可以獲取返回的結(jié)果：

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;
        // 處理返回的結(jié)果
    }
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

啟動(dòng)其他應(yīng)用的 UIAbility

有時(shí)候，我們需要啟動(dòng)其他應(yīng)用的 UIAbility。這可以通過(guò)隱式 Want 啟動(dòng)實(shí)現(xiàn)，系統(tǒng)會(huì)根據(jù)調(diào)用方提供的條件匹配適當(dāng)?shù)?UIAbility。

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    action: 'ohos.want.action.viewData',
    entities: ['entity.system.default'],
};

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbility(wantInfo).then(() => {
    // 處理啟動(dòng)成功后的邏輯
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

啟動(dòng)其他應(yīng)用的 UIAbility 并獲取返回結(jié)果

如果需要獲取其他應(yīng)用 UIAbility 的返回結(jié)果，可以使用 startAbilityForResult 方法：

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    action: 'ohos.want.action.editData',
    entities: ['entity.system.default'],
};

// context為調(diào)用方UIAbility的AbilityContext
this.context.startAbilityForResult(wantInfo).then((data) => {
    // 處理從其他應(yīng)用UIAbility返回的結(jié)果
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

在被調(diào)用方的 UIAbility 中，需要調(diào)用 terminateSelfWithResult 方法返回結(jié)果：

const RESULT_CODE: number = 1001;
let abilityResult = {
    resultCode: RESULT_CODE,
    want: {
        bundleName: 'com.example.myapplication',
        abilityName: 'EntryAbility',
        moduleName: 'entry',
        parameters: {
            payResult: 'OKay',
        },
    },
};

// context為被調(diào)用方UIAbility的AbilityContext
this.context.terminateSelfWithResult(abilityResult, (err) => {
    // 處理停止自身后的邏輯
});

在調(diào)用方的回調(diào)中可以獲取返回的結(jié)果：

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 payResult = data.want?.parameters?.payResult;
        // 處理返回的結(jié)果
    }
}).catch((err) => {
    // 處理啟動(dòng)失敗后的邏輯
});

這些示例展示了在設(shè)備

內(nèi)進(jìn)行 UIAbility 之間交互的常見(jiàn)場(chǎng)景和方法，希望對(duì)您的應(yīng)用程序開(kāi)發(fā)有所幫助。

通過(guò) Call 調(diào)用實(shí)現(xiàn) UIAbility 交互（僅對(duì)系統(tǒng)應(yīng)用開(kāi)放）

在某些情況下，需要通過(guò) Call 調(diào)用來(lái)實(shí)現(xiàn) UIAbility 之間的交互。這種方式通常僅對(duì)系統(tǒng)應(yīng)用開(kāi)放。以下是一個(gè)簡(jiǎn)單的示例，演示了如何通過(guò) Call 調(diào)用實(shí)現(xiàn) UIAbility 的交互：

let wantInfo = {
    deviceId: '', // deviceId為空表示本設(shè)備
    abilityName: 'SystemAbility',
    parameters: {
        operation: 'performTask',
        task: 'someTask',
    },
};

// context為調(diào)用方UIAbility的AbilityContext
this.context.call(wantInfo).then((data) => {
    // 處理Call調(diào)用返回的結(jié)果
}).catch((err) => {
    // 處理Call調(diào)用失敗后的邏輯
});

在被調(diào)用方的 UIAbility 中，需要實(shí)現(xiàn) onCall 方法來(lái)處理 Call 調(diào)用：

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

export default class SystemAbility extends UIAbility {
    onCall(message) {
        // 處理Call調(diào)用傳遞過(guò)來(lái)的信息
        let operation = message?.operation;
        let task = message?.task;
        // ...
        
        // 返回Call調(diào)用的結(jié)果
        return {
            result: 'Task performed successfully',
        };
    }
}

這里使用了 onCall 方法來(lái)處理調(diào)用傳遞過(guò)來(lái)的信息，并返回相應(yīng)的結(jié)果。

總體而言，通過(guò) startAbility、startAbilityForResult、call 等方法，UIAbility 之間可以實(shí)現(xiàn)靈活的交互，滿足各種應(yīng)用場(chǎng)景的需求。在實(shí)際開(kāi)發(fā)中，需要根據(jù)具體業(yè)務(wù)需求選擇合適的方式進(jìn)行 UIAbility 之間的通信，并確保良好的用戶體驗(yàn)和應(yīng)用的穩(wěn)定性。

注意事項(xiàng)與最佳實(shí)踐

在進(jìn)行 UIAbility 之間的交互時(shí)，開(kāi)發(fā)者應(yīng)該注意一些重要的事項(xiàng)和最佳實(shí)踐，以確保應(yīng)用程序的性能、穩(wěn)定性和用戶體驗(yàn)。

1.權(quán)限和安全性： 確保對(duì)敏感信息和操作進(jìn)行適當(dāng)?shù)臋?quán)限檢查，以保障用戶隱私和應(yīng)用的安全性。合理使用能力分級(jí)和權(quán)限管理機(jī)制。

2.錯(cuò)誤處理： 對(duì)于 UIAbility 之間的交互，及時(shí)而有效的錯(cuò)誤處理是至關(guān)重要的。在使用 catch 捕獲錯(cuò)誤時(shí)，可以提供友好的用戶提示或記錄詳細(xì)的日志以便追蹤和調(diào)試。

3.業(yè)務(wù)場(chǎng)景設(shè)計(jì)： 在設(shè)計(jì) UIAbility 之間的交互時(shí)，充分考慮業(yè)務(wù)場(chǎng)景和用戶行為。確保交互邏輯符合用戶的預(yù)期，提高用戶體驗(yàn)。

4.數(shù)據(jù)傳遞： 良好的數(shù)據(jù)傳遞機(jī)制是 UIAbility 之間交互的核心。在傳遞數(shù)據(jù)時(shí)，要確保數(shù)據(jù)的準(zhǔn)確性、完整性，并進(jìn)行必要的驗(yàn)證。

5.生命周期管理： 注意 UIAbility 的生命周期管理，合理使用 startAbilityForResult 和 terminateSelfWithResult 等方法，確保 UIAbility 的啟動(dòng)和停止順序合理。

6.異步編程： 由于 UIAbility 之間的交互通常是異步的，確保在合適的時(shí)機(jī)處理異步回調(diào)，避免阻塞用戶界面。

7.性能優(yōu)化： 對(duì)于頻繁啟動(dòng)和停止 UIAbility 的情況，考慮性能優(yōu)化，減少資源消耗，提高應(yīng)用響應(yīng)速度。

8.代碼規(guī)范： 遵循良好的代碼規(guī)范和開(kāi)發(fā)規(guī)范，使代碼易讀、易維護(hù)，并且能夠適應(yīng)未來(lái)的擴(kuò)展和更新。

在實(shí)際應(yīng)用中，以上這些建議可以根據(jù)具體的業(yè)務(wù)需求進(jìn)行調(diào)整和擴(kuò)展。通過(guò)合理的 UIAbility 之間的交互，開(kāi)發(fā)者可以實(shí)現(xiàn)更加豐富和復(fù)雜的應(yīng)用功能，為用戶提供更好的使用體驗(yàn)。

審核編輯 黃宇