!17935 应用支持快速修复撤销

Merge pull request !17935 from xinking129/revoke0506

zh-cn/application-dev/reference/apis/commonEventManager-definitions.md

@@ -908,4 +908,8 @@ Wi-Fi P2P群组信息已更改。
 表示屏幕解锁的公共事件。
 
 - 值：usual.event.SCREEN_UNLOCKED
-- 订阅者所需权限：无
\ No newline at end of file
+- 订阅者所需权限：无
+
+## [COMMON_EVENT_QUICK_FIX_REVOKE_RESULT<sup>10+<sup>](./common_event/commonEvent-ability.md#common_event_quick_fix_revoke_result10)
+
+指示撤销快速修复的动作。
\ No newline at end of file

zh-cn/application-dev/reference/apis/common_event/commonEvent-ability.md

@@ -36,3 +36,12 @@
 - 订阅方需要的权限：无
 
 在设备上指定用户快速修复应用，将会触发事件通知服务发布该系统公共事件。
+
+## COMMON_EVENT_QUICK_FIX_REVOKE_RESULT<sup>10+<sup>
+
+指示撤销快速修复的动作。
+
+- 常量值："usual.event.QUICK_FIX_REVOKE_RESULT"
+- 订阅方需要的权限：无
+
+在设备上撤销快速修复时，将会触发事件通知服务发布该系统公共事件。

zh-cn/application-dev/reference/apis/js-apis-app-ability-quickFixManager.md

@@ -249,4 +249,101 @@ getApplicationQuickFixInfo(bundleName: string): Promise\<ApplicationQuickFixInfo
   } catch (paramError) {
     console.error('error: ${paramError.code}, ${paramError.message}');
   }
-  ```
\ No newline at end of file
+  ```
+
+## quickFixManager.revokeQuickFix<sup>10+<sup>
+
+revokeQuickFix(bundleName: string, callback: AsyncCallback\<void>): void;
+
+撤销快速修复的接口，使用callback方式返回结果。
+
+**需要权限**：ohos.permission.INSTALL_BUNDLE 与 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix
+
+**系统API**：此接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 |
+  | -------- | -------- | -------- | -------- |
+  | bundleName | string | 是 | 需要撤销补丁的应用Bundle名称。 |
+  | callback | AsyncCallback\<void> | 是 | 表示指定的回调方法。 |
+
+**错误码**：
+
+以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------- |
+| 18500001 | The bundle is not exist or no patch has applied. |
+| 18500009 | The application has a apply quick fix task that is being processed. |
+
+在撤销补丁过程中发生的错误，其错误码及错误信息通过公共事件[COMMON_EVENT_QUICK_FIX_REVOKE_RESULT](./common_event/commonEvent-ability.md#common_event_quick_fix_revoke_result10)的参数返回给应用开发者。这部分错误码及错误信息如下：
+
+| 错误码ID | 错误信息 |
+| ------- | -------- |
+| 18500004 | Switch hqf failed. |
+| 18500005 | Delete hqf failed. |
+| 18500007 | Unload patch failed. |
+
+**示例：**
+
+```ts
+  let bundleName = "com.example.myapplication";
+  quickFixManager.revokeQuickFix(bundleName, (err) => {
+    console.info("revokeQuickFix " + bundleName + " " + JSON.stringify(err));
+  });
+```
+
+## quickFixManager.revokeQuickFix<sup>10+<sup>
+
+revokeQuickFix(bundleName: string): Promise\<void>;
+
+撤销快速修复的接口，使用Promise方式返回结果。
+
+**需要权限**：ohos.permission.INSTALL_BUNDLE 与 ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+
+**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.QuickFix
+
+**系统API**：此接口为系统接口，三方应用不支持调用。
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 |
+  | -------- | -------- | -------- | -------- |
+  | bundleName | string | 是 | 需要撤销补丁的应用Bundle名称。 |
+
+**返回值：**
+
+  | 类型 | 说明 |
+  | -------- | -------- |
+  | Promise\<void> | 返回相应结果。 |
+
+**错误码**：
+
+以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。
+
+| 错误码ID | 错误信息 |
+| ------- | -------- |
+| 18500001 | The bundle is not exist or no patch has applied. |
+| 18500009 | The application has a apply quick fix task that is being processed. |
+
+在撤销补丁过程中发生的错误，其错误码及错误信息通过公共事件[COMMON_EVENT_QUICK_FIX_REVOKE_RESULT](./common_event/commonEvent-ability.md#common_event_quick_fix_revoke_result10)的参数返回给应用开发者。这部分错误码及错误信息如下：
+
+| 错误码ID | 错误信息 |
+| ------- | -------- |
+| 18500004 | Switch hqf failed. |
+| 18500005 | Delete hqf failed. |
+| 18500007 | Unload patch failed. |
+
+**示例：**
+
+```ts
+  let bundleName = "com.example.myapplication";
+  quickFixManager.revokeQuickFix(bundleName).then(() => {
+    console.info("revokeQuickFix " + bundleName +" ok");
+  }).catch((err) => {
+    console.info("revokeQuickFix " + bundleName +" failed, error code is ", JSON.stringify((err)));
+  });
+```
\ No newline at end of file

zh-cn/application-dev/reference/errorcodes/errorcode-ability.md

@@ -733,3 +733,21 @@ Internal error.
 **处理步骤**
 
 确认系统内存是否足够。
+
+## 18500009 该应用当前有正在处理的快速修复任务
+
+**错误信息**
+
+The application has a apply quick fix task that is being processed.
+
+**错误描述**
+
+该应用当前有正在处理的快速修复任务时，方法将返回该错误码。
+
+**可能原因**
+
+指定要撤销快速修复的应用，有正在处理的快速修复任务。
+
+**处理步骤**
+
+等待快速修复任务处理完成。
\ No newline at end of file