鴻蒙之@ohos.app.ability.appRecovery (appRecovery)

appRecovery模塊提供了應(yīng)用在故障狀態(tài)下的恢復(fù)能力。

說明
本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。當(dāng)前版本僅支持單進(jìn)程中單Ability的應(yīng)用恢復(fù)。

導(dǎo)入模塊

import appRecovery from ‘@ohos.app.ability.appRecovery’;

appRecovery.RestartFlag

應(yīng)用重啟標(biāo)志，enableAppRecovery接口重啟選項參數(shù)，該類型為枚舉。

系統(tǒng)能力：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

appRecovery.SaveOccasionFlag

保存條件標(biāo)志，enableAppRecovery接口狀態(tài)保存時的選項參數(shù)，該類型為枚舉。

系統(tǒng)能力：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

appRecovery.SaveModeFlag

狀態(tài)保存標(biāo)志，enableAppRecovery接口狀態(tài)保存方式的參數(shù)，該類型為枚舉。

系統(tǒng)能力：以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Ability.AbilityRuntime.Core

appRecovery.enableAppRecovery

enableAppRecovery(restart?: RestartFlag, saveOccasion?: SaveOccasionFlag, saveMode?: SaveModeFlag) : void;

使能應(yīng)用恢復(fù)功能，參數(shù)按順序填入。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

參數(shù)：

示例：

import appRecovery from '@ohos.app.ability.appRecovery';
import AbilityStage from '@ohos.app.ability.AbilityStage';

export default class MyAbilityStage extends AbilityStage {
    onCreate() {
        appRecovery.enableAppRecovery(
            appRecovery.RestartFlag.ALWAYS_RESTART,
            appRecovery.SaveOccasionFlag.SAVE_WHEN_ERROR,
            appRecovery.SaveModeFlag.SAVE_WITH_FILE
        );
    }
}

appRecovery.restartApp

restartApp(): void;

重啟當(dāng)前App進(jìn)程，可以配合errorManager相關(guān)接口使用。

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

示例：

import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager';

let observer = {
    onUnhandledException(errorMsg) {
        console.log('onUnhandledException, errorMsg: ', errorMsg);
        appRecovery.restartApp();
    }
};

try {
    errorManager.on('error', observer);
} catch (paramError) {
    console.log('error: ' + paramError.code + ', ' + paramError.message);
}

appRecovery.saveAppState

saveAppState(): boolean;

保存當(dāng)前App狀態(tài)，可以配合errorManager相關(guān)接口使用

系統(tǒng)能力：SystemCapability.Ability.AbilityRuntime.Core

返回值：

示例：

import appRecovery from '@ohos.app.ability.appRecovery';
import errorManager from '@ohos.app.ability.errorManager';

let observer = {
    onUnhandledException(errorMsg) {
        console.log('onUnhandledException, errorMsg: ', errorMsg);
        appRecovery.saveAppState();
    }
};

try {
    errorManager.on('error', observer);
} catch (paramError) {
    console.log('error: ' + paramError.code + ', ' + paramError.message);
}

審核編輯 黃宇