From 5ca6335a2be97ead236a51544b95a05253ed61a5 Mon Sep 17 00:00:00 2001 From: zhancaijin Date: Wed, 1 Feb 2023 19:15:06 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8C=91=E5=8D=951018=20appRecovery=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E4=BC=98=E5=8C=96Changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zhancaijin --- .../dfx/apprecovery-guidelines.md | 4 +-- .../apis/js-apis-app-ability-appRecovery.md | 16 ++++----- .../changelogs-ability.md | 36 +++++++++++++++++++ 3 files changed, 45 insertions(+), 11 deletions(-) create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.6/changelogs-ability.md diff --git a/zh-cn/application-dev/dfx/apprecovery-guidelines.md b/zh-cn/application-dev/dfx/apprecovery-guidelines.md index 515bb3e23c..b7e0d4fedb 100644 --- a/zh-cn/application-dev/dfx/apprecovery-guidelines.md +++ b/zh-cn/application-dev/dfx/apprecovery-guidelines.md @@ -29,7 +29,7 @@ **restartApp:** 调用后框架会杀死当前应用进程，并重新拉起处于前台的Ability，其中启动原因为APP_RECOVERY。 -### 框架故障管理理流程示意 +### 框架故障管理流程示意 故障管理是应用提升用户体验的重要手段。应用程序框架为开发者提供了故障监听、故障恢复、以及故障查询三种方式来管理应用的故障。 @@ -133,7 +133,7 @@ callback触发appRecovery.saveAppState()调用后，会触发MainAbility的onSav - 数据恢复 -callback触发后appRecovery.restartApp()调用后，应用会重启，重启后会走到MainAbility的onSaveState(state, wantParams)函数，保存的数据会在want参数的parameters里。 +callback触发后appRecovery.restartApp()调用后，应用会重启，重启后会走到MainAbility的onCreate(want, launchParam)函数，保存的数据会在want参数的parameters里。 ```ts storage: LocalStorage diff --git a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md index 72c8116699..05fe717a32 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md +++ b/zh-cn/application-dev/reference/apis/js-apis-app-ability-appRecovery.md @@ -18,13 +18,12 @@ import appRecovery from '@ohos.app.ability.appRecovery'; **系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core -| 名称 | 值 | 说明 | -| ----------------------------- | ---- | ------------------------------------------------------------ | -| ALWAYS_RESTART | 0 | 总是重启应用。 | -| CPP_CRASH_NO_RESTART | 0x0001 | 发生CPP_CRASH时不重启应用。 | -| JS_CRASH_NO_RESTART | 0x0002 | 发生JS_CRASH时不重启应用。 | -| APP_FREEZE_NO_RESTART | 0x0004 | 发生APP_FREEZE时不重启应用。 | -| NO_RESTART | 0xFFFF | 总是不重启应用。 | +| 名称 | 值 | 说明 | +| ---------- | ---- | ---------- | +| ALWAYS_RESTART | 0 | 总是重启应用。 | +| RESTART_WHEN_JS_CRASH | 0x0001 | 发生JS_CRASH时重启应用。 | +| RESTART_WHEN_APP_FREEZE | 0x0002 | 发生APP_FREEZE时重启应用。 | +| NO_RESTART | 0xFFFF | 总是不重启应用。 | ## appRecovery.SaveOccasionFlag @@ -69,9 +68,8 @@ enableAppRecovery(restart?: [RestartFlag](#apprecoveryrestartflag), saveOccasion ```ts import appRecovery from '@ohos.app.ability.appRecovery'; import AbilityStage from '@ohos.app.ability.AbilityStage'; -import UIAbility from '@ohos.app.ability.UIAbility'; -export default class MyAbility extends UIAbility { +export default class MyAbilityStage extends AbilityStage { onCreate() { appRecovery.enableAppRecovery( appRecovery.RestartFlag::ALWAYS_RESTART, diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.6/changelogs-ability.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.6/changelogs-ability.md new file mode 100644 index 0000000000..903fbad8c7 --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.6/changelogs-ability.md @@ -0,0 +1,36 @@ +# 元能力子系统ChangeLog + +## cl.ability.1 appRecovery接口中RestartFlag属性名称变更，删除了未支持的属性 + +appRecovery接口中RestartFlag枚举命名从特定故障发生后**不重启**改成了特定故障发生后**重启**。 +删除了CPP_CRASH_NO_RESTART。 + +**变更影响** + +3.2.10.6版本之前使用CPP_CRASH_NO_RESTART/JS_CRASH_NO_RESTART/APP_FREEZE_NO_RESTART类型开发的应用，在3.2.10.6版本之后行为会发生变化。 + +**关键接口/组件变更** + +**RestartFlag** 9+ + +变更前： +| 名称 | 值 | 说明 | +| ----------------------------- | ---- | ------------------------------------------------------------ | +| ALWAYS_RESTART | 0 | 总是重启应用。 | +| CPP_CRASH_NO_RESTART | 0x0001 | 发生CPP_CRASH时**不重启**应用。 | +| JS_CRASH_NO_RESTART | 0x0002 | 发生JS_CRASH时**不重启**应用。 | +| APP_FREEZE_NO_RESTART | 0x0004 | 发生APP_FREEZE时**不重启**应用。 | +| NO_RESTART | 0xFFFF | 总是不重启应用。 | + +变更后： +| 名称 | 值 | 说明 | +| ---------- | ---- | ---------- | +| ALWAYS_RESTART | 0 | 总是重启应用。 | +| CPP_CRASH_NO_RESTART | NA | **删除**，不支持该场景的重启。 | +| RESTART_WHEN_JS_CRASH | 0x0001 | 发生JS_CRASH时**重启**应用。 | +| RESTART_WHEN_APP_FREEZE | 0x0002 | 发生APP_FREEZE时**重启**应用。 | +| NO_RESTART | 0xFFFF | 总是不重启应用。 | + +**适配指导** + +按新的语义进行适配。 \ No newline at end of file -- GitLab