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

appRecovery模块提供了应用在故障状态下的恢复能力。

说明
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。当前版本仅支持单进程中单Ability的应用恢复。

导入模块

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

appRecovery.RestartFlag

应用重启标志，enableAppRecovery接口重启选项参数，该类型为枚举。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

appRecovery.SaveOccasionFlag

保存条件标志，enableAppRecovery接口状态保存时的选项参数，该类型为枚举。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

appRecovery.SaveModeFlag

状态保存标志，enableAppRecovery接口状态保存方式的参数，该类型为枚举。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

appRecovery.enableAppRecovery

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

使能应用恢复功能，参数按顺序填入。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

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;

重启当前App进程，可以配合errorManager相关接口使用。

系统能力：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;

保存当前App状态，可以配合errorManager相关接口使用

系统能力：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);
}

审核编辑 黄宇