From da7f51560e508a56cb0b6b055ed4845edd3a3d12 Mon Sep 17 00:00:00 2001 From: wangtiantian Date: Wed, 1 Feb 2023 17:02:10 +0800 Subject: [PATCH] IssueNo:#I6CATE Description:delete getAbilityIcon Sig:SIG_ApplicaitonFramework Feature or Bugfix:Bugfix Binary Source:No Signed-off-by: wangtiantian --- .../reference/apis/js-apis-Bundle.md | 4 +- .../reference/apis/js-apis-bundleManager.md | 112 ------------------ .../changelogs-bundlemanager.md | 29 +++++ 3 files changed, 31 insertions(+), 114 deletions(-) create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-Bundle.md b/zh-cn/application-dev/reference/apis/js-apis-Bundle.md index 4b9d2ab507..9fbf316d05 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-Bundle.md +++ b/zh-cn/application-dev/reference/apis/js-apis-Bundle.md @@ -1603,7 +1603,7 @@ bundle.getNameForUid(uid, (err, data) => { ## bundle.getAbilityIcon8+ deprecated -> 从API version 9开始不再维护，建议使用[bundleManager.getAbilityIcon](js-apis-bundleManager.md#bundlemanagergetabilityicon)替代。 +> 从API version 9开始不再维护，建议使用[resourceManager.getMediaContent](js-apis-resource-manager.md#getmediacontent9)替代。 getAbilityIcon(bundleName: string, abilityName: string): Promise\; @@ -1646,7 +1646,7 @@ bundle.getAbilityIcon(bundleName, abilityName) ## bundle.getAbilityIcon8+ deprecated -> 从API version 9开始不再维护，建议使用[bundleManager.getAbilityIcon](js-apis-bundleManager.md#bundlemanagergetabilityicon)替代。 +> 从API version 9开始不再维护，建议使用[resourceManager.getMediaContent](js-apis-resource-manager.md#getmediacontent9)替代。 getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\): void; diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md index 92336371ae..475a0e61ec 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -2654,118 +2654,6 @@ try { } ``` -### bundleManager.getAbilityIcon - -getAbilityIcon(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback<[image.PixelMap](js-apis-image.md#pixelmap7)>): void; - -以异步的方法获取指定bundleName、moduleName和abilityName的icon，使用callback形式返回结果。 - -**系统接口：** 此接口为系统接口。 - -**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO - -**系统能力：** SystemCapability.BundleManager.BundleFramework.Resource - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ----------------------------------------------------------- | ---- | ------------------------------------------------------------ | -| bundleName | string | 是 | 表示应用程序的bundleName。 | -| moduleName | string | 是 | 表示应用程序的moduleName。 | -| abilityName | string | 是 | 表示应用程序的abilityName。 | -| callback | AsyncCallback<[image.PixelMap](js-apis-image.md#pixelmap7)> | 是 | 回调函数，当获取成功时，err为null，data为指定组件icon的PixelMap对象；否则为错误对象。 | - -**错误码：** - -以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)。 - -| 错误码ID | 错误信息 | -| -------- | -------------------------------------- | -| 17700001 | The specified bundleName is not found. | -| 17700002 | The specified moduleName is not found. | -| 17700003 | The specified abilityName is not found. | -| 17700026 | The specified bundle is disabled. | -| 17700029 | The specified ability is disabled. | - -**示例：** - -```ts -import bundleManager from '@ohos.bundle.bundleManager'; -import hilog from '@ohos.hilog'; -let bundleName = 'com.example.myapplication'; -let moduleName = 'entry'; -let abilityName = 'EntryAbility'; - -try { - bundleManager.getAbilityIcon(bundleName, moduleName, abilityName, (err, data) => { - if (err) { - hilog.error(0x0000, 'testTag', 'getAbilityIcon failed: %{public}s', err.message); - } else { - hilog.info(0x0000, 'testTag', 'getAbilityIcon successfully: %{public}s', JSON.stringify(data)); - } - }); -} catch (err) { - hilog.error(0x0000, 'testTag', 'getAbilityIcon failed: %{public}s', err.message); -} -``` - -### bundleManager.getAbilityIcon - -getAbilityIcon(bundleName: string, moduleName: string, abilityName: string): Promise<[image.PixelMap](js-apis-image.md#pixelmap7)>; - -以异步的方法获取指定bundleName、moduleName和abilityName的icon，使用Promise形式返回结果。 - -**系统接口：** 此接口为系统接口。 - -**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO - -**系统能力：** SystemCapability.BundleManager.BundleFramework.Resource - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ------ | ---- | ------------------------- | -| bundleName | string | 是 | 表示应用程序的bundleName。 | -| moduleName | string | 是 | 表示应用程序的moduleName。 | -| abilityName | string | 是 | 表示应用程序的abilityName。 | - -**返回值：** - -| 类型 | 说明 | -| ----------------------------------------------------- | ------------------------------------------- | -| Promise<[image.PixelMap](js-apis-image.md#pixelmap7)> | Promise对象，返回指定组件icon的PixelMap对象。 | - -**错误码：** - -以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)。 - -| 错误码ID | 错误信息 | -| -------- | -------------------------------------- | -| 17700001 | The specified bundleName is not found. | -| 17700002 | The specified moduleName is not found. | -| 17700003 | The specified abilityName is not found. | -| 17700026 | The specified bundle is disabled. | -| 17700029 | The specified ability is disabled. | - -**示例：** - -```ts -import bundleManager from '@ohos.bundle.bundleManager'; -import hilog from '@ohos.hilog'; -let bundleName = 'com.example.myapplication'; -let moduleName = 'entry'; -let abilityName = 'EntryAbility'; - -try { - bundleManager.getAbilityIcon(bundleName, moduleName, abilityName).then((data) => { - hilog.info(0x0000, 'testTag', 'getAbilityIcon successfully. Data: %{public}s', JSON.stringify(data)); - }).catch(err => { - hilog.error(0x0000, 'testTag', 'getAbilityIcon failed. Cause: %{public}s', err.message); - }); -} catch (err) { - hilog.error(0x0000, 'testTag', 'getAbilityIcon failed. Cause: %{public}s', err.message); -} -``` ### bundleManager.getApplicationInfoSync diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md new file mode 100644 index 0000000000..7c7acdc05d --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelogs-bundlemanager.md @@ -0,0 +1,29 @@ +# 包管理子系统ChangeLog + +## cl.bundlemanager.1 包管理删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口，可以使用@ohos.resourceManager.d.ts中的getMediaContent替换。 + +包管理删除[@ohos.bundle.bundleManager.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts)中的getAbilityIcon接口，可以使用[@ohos.resourceManager.d.ts](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.resourceManager.d.ts)中的getMediaContent替换。 + +**变更影响**
+使用之前已发布的API 9各beta版本切使用到了getAbilityIcon接口的，需要改为使用getMediaContent接口。 + +**关键的接口/组件变更**
+删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。 + +**适配指导**
+使用@ohos.bundle.bundleManager.d.ts下面的getAbilityIcon，需要修改为@ohos.resourceManager.d.ts中的getMediaContent。需要提前获取到图标的资源ID值，可参考该接口的[使用指导](../../../application-dev/reference/apis/js-apis-resource-manager.md#getmediacontent9)。 + +## cl.bundlemanager.2 包管理底层能力变更，仅支持系统资源HAP自定义权限，其它HAP均不支持自定义权限。 + +仅支持系统资源HAP自定义权限，其它HAP均不支持自定义权限。包管理在解析HAP时，仅支持解析资源HAP(包名为：ohos.global.systemres)的配置文件中的definePermissions字段，该字段用来定义权限。其它HAP中配置的definePermissions字段将不会解析。 +如果有应用需要自定义权限，可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。 + + +**变更影响**
+升级新版本镜像后，应用自定义的权限将不会生效，使用方在申请该权限时，会授权失败。 + +**关键的接口/组件变更**
+包管理底层能力变更，仅支持系统资源HAP自定义权限，其它HAP均不支持自定义权限。 + +**适配指导**
+如果有应用需要自定义权限，可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。 -- GitLab