1# UIAbility备份恢复
2
3## 场景介绍
4
5当应用后台运行时，可能由于系统资源管控等原因导致应用关闭、进程退出，应用直接退出可能会导致用户数据丢失。如果应用在[UIAbilityContext](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md)中启用了[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)备份恢复功能，并对临时数据进行保存，则可以在应用退出后的下一次启动时恢复先前的状态和数据（包括应用的页面栈以及[onSaveState](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityonsavestate)接口中保存的数据），从而保证用户体验的连贯性。
6
7> **说明：**
8> 
9> 应用正常关闭时，不会触发[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)备份流程。应用正常启动（例如通过startAbility接口启动或点击图标启动），不触发[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)恢复流程。
10
11## 运行机制
12- [UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)数据备份：在应用的[onBackground](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityonbackground)生命周期后，系统自动调用[onSaveState](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityonsavestate)进行备份。
13- [UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)数据恢复：恢复的[Want](../reference/apis-ability-kit/js-apis-app-ability-want.md)数据可以在应用的[onCreate](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityoncreate)生命周期中获取，页面栈数据在应用的[onWindowStageCreate](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityonwindowstagecreate)生命周期中恢复。
14
15## 约束限制
16
17- [UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)备份恢复支持多实例，备份数据保存7天，以文件的形式存储在应用的沙箱路径中。
18
19- 重启设备不支持还原备份。
20
21- [UIExtensionAbility](./uiextensionability.md)不支持备份恢复。
22
23## 接口说明
24
25[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)备份恢复接口由[UIAbilityContext](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md)模块提供，开发者可以通过在[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)中通过this.context直接调用，详见[开发步骤](#开发步骤)。
26
27| 接口名称                                                       | 说明                                                 |
28| ------------------------------------------------------------ | ---------------------------------------------------- |
29| setRestoreEnabled(enabled: boolean): void | 设置当[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)从后台切换回时是否启用恢复。|
30
31**[setRestoreEnabled](../reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontextsetrestoreenabled13):** 需要在应用初始化阶段调用（[onForeground](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityonforeground)前），比如[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)的[onCreate](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md#uiabilityoncreate)调用。
32
33
34## 开发步骤
35
36开发者需要在应用模块初始化时启用[UIAbility](../reference/apis-ability-kit/js-apis-app-ability-uiAbility.md)备份恢复功能。示例如下。
37
38```ts
39import { UIAbility } from '@kit.AbilityKit';
40
41export default class EntryAbility extends UIAbility {
42    onCreate() {
43        console.info("[Demo] EntryAbility onCreate");
44        this.context.setRestoreEnabled(true);
45    }
46}
47```
48
49开发者主动保存数据，在UIAbility启动时恢复。下面为示例。
50
51```ts
52import { AbilityConstant，UIAbility，Want } from '@kit.AbilityKit';
53
54export default class EntryAbility extends UIAbility {
55    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
56        console.info("[Demo] EntryAbility onCreate");
57        this.context.setRestoreEnabled(true);
58        if (want && want.parameters) {
59          let recoveryMyData = want.parameters["myData"];
60        }
61    }
62
63    onSaveState(state:AbilityConstant.StateType, wantParams: Record<string, Object>) {
64        // Ability has called to save app data
65        console.log("[Demo] EntryAbility onSaveState");
66        wantParams["myData"] = "my1234567";
67        return AbilityConstant.OnSaveResult.ALL_AGREE;
68    }
69}
70```