!14341 包管理删除接口增加changelog-monthly

Merge pull request !14341 from wangtiantian/distributed_month

!14341 包管理删除接口增加changelog-monthly
Merge pull request !14341 from wangtiantian/distributed_month
71c869d0 · openharmony_ci · Gitee · 4df71080 · 958bafbc · 71c869d0
3 changed file
--- 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.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>

-> 从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\<image.PixelMap>;

@@ -1646,7 +1646,7 @@ bundle.getAbilityIcon(bundleName, abilityName)

 ## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>

-> 从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\<image.PixelMap>): void;


--- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md
@@ -2654,119 +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 = 'MainAbility';
-
-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 = 'MainAbility';
-
-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

 getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: number) : [ApplicationInfo](js-apis-bundleManager-applicationInfo.md);

--- 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
+# 包管理子系统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替换。
+
+**变更影响**<br>
+使用之前已发布的API 9各beta版本切使用到了getAbilityIcon接口的，需要改为使用getMediaContent接口。
+
+**关键的接口/组件变更**<br>
+删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。
+
+**适配指导**<br>
+使用@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对象内部结构)。
+
+
+**变更影响**<br>
+升级新版本镜像后，应用自定义的权限将不会生效，使用方在申请该权限时，会授权失败。
+
+**关键的接口/组件变更**<br>
+包管理底层能力变更，仅支持系统资源HAP自定义权限，其它HAP均不支持自定义权限。
+
+**适配指导**<br>
+如果有应用需要自定义权限，可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。