UIAbility 組件間交互（設備內）

在設備內，UIAbility（用戶界面能力）是系統調度的最小單元，它們負責展示用戶界面和執行相關的業務邏輯。設備內的不同功能模塊之間的交互是應用程序開發中的重要部分。本文將探討設備內 UIAbility 之間的交互方式，包括啟動應用內的 UIAbility、啟動其他應用的 UIAbility 以及通過 Call 調用實現 UIAbility 交互。

啟動應用內的 UIAbility

在一個應用內部存在多個 UIAbility 時，可能需要從一個 UIAbility 啟動另一個 UIAbility。例如，在支付應用中，從主界面 UIAbility 啟動收款 UIAbility。下面是一個示例代碼，演示了如何在 EntryAbility 中啟動 FuncAbility：

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

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

在 FuncAbility 中，可以通過生命周期回調方法 onCreate 接收來自 EntryAbility 傳遞的參數：

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

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

啟動應用內的 UIAbility 并獲取返回結果

有時候，我們希望從一個 UIAbility 啟動另一個 UIAbility，并在后者完成業務后獲取返回結果。例如，在登錄 UIAbility 完成登錄操作后，將登錄結果返回給主界面 UIAbility。下面是一個示例代碼：

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

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

在 FuncAbility 中，完成業務后需要調用 terminateSelfWithResult 方法返回結果：

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

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

在調用方的回調中可以獲取返回的結果：

const RESULT_CODE: number = 1001;

// ...

// context為調用方UIAbility的AbilityContext
this.context.startAbilityForResult(want).then((data) => {
    if (data?.resultCode === RESULT_CODE) {
        // 解析被調用方UIAbility返回的信息
        let info = data.want?.parameters?.info;
        // 處理返回的結果
    }
}).catch((err) => {
    // 處理啟動失敗后的邏輯
});

啟動其他應用的 UIAbility

有時候，我們需要啟動其他應用的 UIAbility。這可以通過隱式 Want 啟動實現，系統會根據調用方提供的條件匹配適當的 UIAbility。

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

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

啟動其他應用的 UIAbility 并獲取返回結果

如果需要獲取其他應用 UIAbility 的返回結果，可以使用 startAbilityForResult 方法：

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

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

在被調用方的 UIAbility 中，需要調用 terminateSelfWithResult 方法返回結果：

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

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

在調用方的回調中可以獲取返回的結果：

const RESULT_CODE: number = 1001;

// ...

// context為調用方UIAbility的AbilityContext
this.context.startAbilityForResult(want).then((data) => {
    if (data?.resultCode === RESULT_CODE) {
        // 解析被調用方UIAbility返回的信息
        let payResult = data.want?.parameters?.payResult;
        // 處理返回的結果
    }
}).catch((err) => {
    // 處理啟動失敗后的邏輯
});

這些示例展示了在設備

內進行 UIAbility 之間交互的常見場景和方法，希望對您的應用程序開發有所幫助。

通過 Call 調用實現 UIAbility 交互（僅對系統應用開放）

在某些情況下，需要通過 Call 調用來實現 UIAbility 之間的交互。這種方式通常僅對系統應用開放。以下是一個簡單的示例，演示了如何通過 Call 調用實現 UIAbility 的交互：

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

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

在被調用方的 UIAbility 中，需要實現 onCall 方法來處理 Call 調用：

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

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

這里使用了 onCall 方法來處理調用傳遞過來的信息，并返回相應的結果。

總體而言，通過 startAbility、startAbilityForResult、call 等方法，UIAbility 之間可以實現靈活的交互，滿足各種應用場景的需求。在實際開發中，需要根據具體業務需求選擇合適的方式進行 UIAbility 之間的通信，并確保良好的用戶體驗和應用的穩定性。

注意事項與最佳實踐

在進行 UIAbility 之間的交互時，開發者應該注意一些重要的事項和最佳實踐，以確保應用程序的性能、穩定性和用戶體驗。

1.權限和安全性： 確保對敏感信息和操作進行適當的權限檢查，以保障用戶隱私和應用的安全性。合理使用能力分級和權限管理機制。

2.錯誤處理： 對于 UIAbility 之間的交互，及時而有效的錯誤處理是至關重要的。在使用 catch 捕獲錯誤時，可以提供友好的用戶提示或記錄詳細的日志以便追蹤和調試。

3.業務場景設計： 在設計 UIAbility 之間的交互時，充分考慮業務場景和用戶行為。確保交互邏輯符合用戶的預期，提高用戶體驗。

4.數據傳遞： 良好的數據傳遞機制是 UIAbility 之間交互的核心。在傳遞數據時，要確保數據的準確性、完整性，并進行必要的驗證。

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

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

7.性能優化： 對于頻繁啟動和停止 UIAbility 的情況，考慮性能優化，減少資源消耗，提高應用響應速度。

8.代碼規范： 遵循良好的代碼規范和開發規范，使代碼易讀、易維護，并且能夠適應未來的擴展和更新。

在實際應用中，以上這些建議可以根據具體的業務需求進行調整和擴展。通過合理的 UIAbility 之間的交互，開發者可以實現更加豐富和復雜的應用功能，為用戶提供更好的使用體驗。

審核編輯 黃宇