harmony(鸿蒙)quickFixManager

2022-10-28
浏览 (717)

quickFixManager

quickFixManager模块提供快速修复的能力，快速修复是OpenHarmony提供给开发者的一种技术手段，支持开发者以远快于（小时级、分钟级）应用升级的方式进行缺陷修复。

说明：

本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import quickFixManager from '@ohos.app.ability.quickFixManager';

HapModuleQuickFixInfo

hap级别的快速修复信息。

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

系统API: 此接口为系统接口，三方应用不支持调用。

名称	读写属性	类型	必填	描述
moduleName	只读	string	是	hap包的名称。
originHapHash	只读	string	是	指示hap的哈希值。
quickFixFilePath	只读	string	是	指示快速修复文件的安装路径。

ApplicationQuickFixInfo

应用级别的快速修复信息。

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

系统API: 此接口为系统接口，三方应用不支持调用。

名称	读写属性	类型	必填	描述
bundleName	只读	string	是	应用的包名。
bundleVersionCode	只读	number	是	应用的版本号。
bundleVersionName	只读	string	是	应用版本号的文字描述。
quickFixVersionCode	只读	number	是	快速修复补丁包的版本号。
quickFixVersionName	只读	string	是	快速修复补丁包版本号的文字描述。
hapModuleQuickFixInfo	只读	Array<HapModuleQuickFixInfo>	是	hap级别的快速修复信息。

quickFixManager.applyQuickFix

applyQuickFix(hapModuleQuickFixFiles: Array<string>, callback: AsyncCallback<void>): void;

快速修复的补丁安装接口。

需要权限: ohos.permission.INSTALL_BUNDLE

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

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名	类型	必填	说明
hapModuleQuickFixFiles	Array<string>	否	快速修复补丁文件（补丁文件需包含有效的文件路径）。
callback	AsyncCallback<void>	否	表示指定的回调方法。

示例：

  import quickFixManager from '@ohos.app.ability.quickFixManager'

  let hapModuleQuickFixFiles = ["/data/storage/el2/base/entry.hqf"]
  quickFixManager.applyQuickFix(hapModuleQuickFixFiles, (error) => {
      if (error) {
          console.info( `applyQuickFix failed with error + ${error}`)
      } else {
          console.info( 'applyQuickFix success')
      }
  })

quickFixManager.applyQuickFix

applyQuickFix(hapModuleQuickFixFiles: Array<string>): Promise<void>;

快速修复的补丁安装接口。

需要权限: ohos.permission.INSTALL_BUNDLE

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

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名	类型	必填	说明
hapModuleQuickFixFiles	Array<string>	否	快速修复补丁文件（补丁文件需包含有效的文件路径）。

返回值：

类型	说明
Promise<void>	返回相应结果。

示例：

  import quickFixManager from '@ohos.app.ability.quickFixManager'

  let hapModuleQuickFixFiles = ["/data/storage/el2/base/entry.hqf"]
  quickFixManager.applyQuickFix(hapModuleQuickFixFiles).then(() => {
    console.info('applyQuickFix success')
  }).catch((error) => {
    console.info(`applyQuickFix err: + ${error}`)
  })

quickFixManager.getApplicationQuickFixInfo

getApplicationQuickFixInfo(bundleName: string, callback: AsyncCallback<ApplicationQuickFixInfo>): void;

获取应用的快速修复信息。

需要权限: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名	类型	必填	说明
bundleName	string	否	应用的包名。
callback	AsyncCallback<ApplicationQuickFixInfo>	否	应用的快速修复信息。

示例：

  import quickFixManager from '@ohos.app.ability.quickFixManager'

  let bundleName = "bundleName"
  quickFixManager.getApplicationQuickFixInfo(bundleName, (error, data) => {
    if (error) {
      console.info(`getApplicationQuickFixInfo error: + ${error}`)
    } else {
      console.info(`getApplicationQuickFixInfo success: + ${data}`)
    }
  })

quickFixManager.getApplicationQuickFixInfo

getApplicationQuickFixInfo(bundleName: string): Promise<ApplicationQuickFixInfo>;

获取应用的快速修复信息。

需要权限: ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

系统API: 此接口为系统接口，三方应用不支持调用。

参数：

参数名	类型	必填	说明
bundleName	string	否	应用的包名。

返回值：

类型	说明
Promise<ApplicationQuickFixInfo>	返回应用的快速修复信息。

示例：

  import quickFixManager from '@ohos.app.ability.quickFixManager'

  let bundleName = "bundleName"
  quickFixManager.getApplicationQuickFixInfo(bundleName).then((data) => {
    console.info(`getApplicationQuickFixInfo success: + ${data}`)
  }).catch((error) => {
    console.info(`getApplicationQuickFixInfo err: + ${error}`)
  })