1# 包管理子系统ChangeLog
2## cl.bundlemanager.1 包管理底层能力变更,仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。
3
4仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。包管理在解析HAP时,仅支持解析资源HAP(包名为:ohos.global.systemres)的配置文件中的definePermissions字段,该字段用来定义权限。其它HAP中配置的definePermissions字段将不会解析。
5如果有应用需要自定义权限,可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。
6
7
8**变更影响**<br>
9升级新版本镜像后,应用自定义的权限将不会生效,使用方在申请该权限时,会授权失败。
10
11**关键的接口/组件变更**<br>
12包管理底层能力变更,仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。
13
14**适配指导**<br>
15如果有应用需要自定义权限,可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。
16
17## cl.bundlemanager.2 包管理二级模块文件名称变更,修改为文件内对应的接口名称
18
19包管理二级模块文件名称变更,修改为文件内对应的接口名称,变更文件如下:
20
21| 原文件名称 |变更后文件名称 |
22|----|----|
23| bundleManager/abilityInfo.d.ts |  bundleManager/AbilityInfo.d.ts |
24| bundleManager/applicationInfo.d.ts |  bundleManager/ApplicationInfo.d.ts |
25| bundleManager/bundleInfo.d.ts |  bundleManager/BundleInfo.d.ts |
26| bundleManager/dispatchInfo.d.ts |  bundleManager/DispatchInfo.d.ts |
27| bundleManager/elementName.d.ts |  bundleManager/ElementName.d.ts |
28| bundleManager/extensionAbilityInfo.d.ts |  bundleManager/ExtensionAbilityInfo.d.ts |
29| bundleManager/hapModuleInfo.d.ts |  bundleManager/HapModuleInfo.d.ts |
30| bundleManager/launcherAbilityInfo.d.ts |  bundleManager/LauncherAbilityInfo.d.ts |
31| bundleManager/metadata.d.ts |  bundleManager/Metadata.d.ts |
32| bundleManager/packInfo.d.ts |  bundleManager/BundlePackInfo.d.ts |
33| bundleManager/permissionDef.d.ts |  bundleManager/PermissionDef.d.ts |
34| bundleManager/remoteAbilityInfo.d.ts |  bundleManager/RemoteAbilityInfo.d.ts |
35| bundleManager/shortcutInfo.d.ts |  bundleManager/ShortcutInfo.d.ts |
36
37除了免安装相关的BundlePackInfo文件名称增加了Bundle,其余文件名称均是修改为大写开头。
38
39**变更影响**<br>
40仅修改二级模块文件名称,不会影响一级模块的使用。在使用之前已发布的API 9各beta版本时,如果在ts文件中直接导入了bundleManager下面二级模块接口的,IDE中编译报错的话,需要修改导入的文件名称。
41
42**关键的接口/组件变更**<br>
43变更bundleManager文件夹下面的d.ts名称,修改为文件中的接口名称。
44
45**适配指导**<br>
46使用新的sdk后,正常情况下应用无需适配该变更。如果在应用中直接导入了bundleManager文件夹下面的文件,则需要修改导入的文件名称。可以按照如下的修改方式:
47
48**修改前:**
49```ts
50import {AbilityInfo} from 'bundleManger/abilityInfo';
51import {ExtensionAbilityInfo} from 'bundleManger/extensionAbilityInfo';
52import {BundlePackInfo} from 'bundleManger/packInfo';
53```
54**修改后:**
55```ts
56import {AbilityInfo} from 'bundleManger/AbilityInfo';
57import {ExtensionAbilityInfo} from 'bundleManger/ExtensionAbilityInfo';
58import {BundlePackInfo} from 'bundleManger/BundlePackInfo';
59```
60
61## cl.bundlemanager.3 包管理LaunchType枚举类型名称变更,由STANDARD修改为MULTITON,枚举值不变。
62
63包管理[LaunchType](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts)枚举类型变更,由STANDARD修改为MULTITON,枚举值不变,表示多实例类型。
64
65**变更影响**<br>
66使用之前已发布的API 9各beta版本且使用到了LaunchType.STANDARD的,需要改为使用LaunchType.MULTITON接口。
67
68**关键的接口/组件变更**<br>
69LaunchType枚举类型名称变更,由LaunchType.STANDARD修改为LaunchType.MULTITON70
71**适配指导**<br>
72LaunchType.STANDARD修改为LaunchType.MULTITON73
74## cl.bundlemanager.4 包管理AbilityInfo结构体中isVisible字段修改为exported,类型不变。
75
76包管理[AbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
77
78**变更影响**<br>
79使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
80
81**关键的接口/组件变更**<br>
82包管理[AbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变。
83
84**适配指导**<br>
85由isVisible修改为exported。
86
87## cl.bundlemanager.5 包管理ExtensionAbilityInfo结构体中isVisible字段修改为exported,类型不变。
88
89包管理[ExtensionAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
90
91**变更影响**<br>
92使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。
93
94**关键的接口/组件变更**<br>
95包管理[ExtensionAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变。
96
97**适配指导**<br>
98由isVisible修改为exported。
99
100## cl.bundlemanager.6 包管理ModuleAbilityInfo结构体中visible字段修改为exported,类型不变。
101
102包管理[ModuleAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts)结构体中visible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。
103
104**变更影响**<br>
105使用之前已发布的API 9各beta版本且使用到了visible的,需要改为使用exported。
106
107**关键的接口/组件变更**<br>
108包管理[ModuleAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts)结构体中visible字段修改为exported,类型不变。
109
110**适配指导**<br>
111由visible修改为exported。
112