@ohos.app.ability.appRecovery

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

appRecovery.RestartFlag

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

名称	值	说明
ALWAYS_RESTART	0	总是重启应用。
RESTART_WHEN_JS_CRASH	0x0001	发生JS_CRASH时重启应用。
RESTART_WHEN_APP_FREEZE	0x0002	发生APP_FREEZE时重启应用。
NO_RESTART	0xFFFF	总是不重启应用。

appRecovery.SaveOccasionFlag

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

名称	值	说明
SAVE_WHEN_ERROR	0x0001	当发生应用故障时保存。
SAVE_WHEN_BACKGROUND	0x0002	当应用切入后台时保存。

appRecovery.SaveModeFlag

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

名称	值	说明
SAVE_WITH_FILE	0x0001	每次状态保存都会写入到本地文件缓存。
SAVE_WITH_SHARED_MEMORY	0x0002	状态先保存在内存中，应用故障退出时写入到本地文件缓存。

appRecovery.enableAppRecovery

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

参数名	类型	必填	说明
restart	RestartFlag	否	枚举类型，发生对应故障时是否重启，默认为不重启。
saveOccasion	SaveOccasionFlag	否	枚举类型，状态保存时机，默认为故障时保存。
saveMode	SaveModeFlag	否	枚举类型，状态保存方式， 默认为文件缓存。

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

重启当前App进程

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

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

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);
}