1# 包管理子系统ChangeLog 2 3## cl.bundlemanager.1 包管理删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口,可以使用@ohos.resourceManager.d.ts中的getMediaContent替换。 4 5包管理删除[@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替换。 6 7**变更影响**<br> 8使用之前已发布的API 9各beta版本且使用到了getAbilityIcon接口的,需要改为使用getMediaContent接口。 9 10**关键的接口/组件变更**<br> 11删除@ohos.bundle.bundleManager.d.ts中的getAbilityIcon接口。 12 13**适配指导**<br> 14使用@ohos.bundle.bundleManager.d.ts下面的getAbilityIcon,需要修改为@ohos.resourceManager.d.ts中的getMediaContent。需要提前获取到图标的资源ID值,可参考该接口的[使用指导](../../../application-dev/reference/apis/js-apis-resource-manager.md#getmediacontent9)。 15 16## cl.bundlemanager.2 包管理底层能力变更,仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。 17 18仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。包管理在解析HAP时,仅支持解析资源HAP(包名为:ohos.global.systemres)的配置文件中的definePermissions字段,该字段用来定义权限。其它HAP中配置的definePermissions字段将不会解析。 19如果有应用需要自定义权限,可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。 20 21 22**变更影响**<br> 23升级新版本镜像后,应用自定义的权限将不会生效,使用方在申请该权限时,会授权失败。 24 25**关键的接口/组件变更**<br> 26包管理底层能力变更,仅支持系统资源HAP自定义权限,其它HAP均不支持自定义权限。 27 28**适配指导**<br> 29如果有应用需要自定义权限,可以在资源HAP的[配置文件](https://gitee.com/openharmony/utils_system_resources/blob/master/systemres/main/config.json)中definePermissions字段下面新增定义权限。格式可参考[定义权限](../../../application-dev/quick-start/module-structure.md#definepermissions对象内部结构)。 30 31## cl.bundlemanager.3 包管理二级模块文件名称变更,修改为文件内对应的接口名称 32 33包管理二级模块文件名称变更,修改为文件内对应的接口名称,变更文件如下: 34 35| 原文件名称 |变更后文件名称 | 36|----|----| 37| bundleManager/abilityInfo.d.ts | bundleManager/AbilityInfo.d.ts | 38| bundleManager/applicationInfo.d.ts | bundleManager/ApplicationInfo.d.ts | 39| bundleManager/bundleInfo.d.ts | bundleManager/BundleInfo.d.ts | 40| bundleManager/dispatchInfo.d.ts | bundleManager/DispatchInfo.d.ts | 41| bundleManager/elementName.d.ts | bundleManager/ElementName.d.ts | 42| bundleManager/extensionAbilityInfo.d.ts | bundleManager/ExtensionAbilityInfo.d.ts | 43| bundleManager/hapModuleInfo.d.ts | bundleManager/HapModuleInfo.d.ts | 44| bundleManager/launcherAbilityInfo.d.ts | bundleManager/LauncherAbilityInfo.d.ts | 45| bundleManager/metadata.d.ts | bundleManager/Metadata.d.ts | 46| bundleManager/packInfo.d.ts | bundleManager/BundlePackInfo.d.ts | 47| bundleManager/permissionDef.d.ts | bundleManager/PermissionDef.d.ts | 48| bundleManager/remoteAbilityInfo.d.ts | bundleManager/RemoteAbilityInfo.d.ts | 49| bundleManager/shortcutInfo.d.ts | bundleManager/ShortcutInfo.d.ts | 50 51除了免安装相关的BundlePackInfo文件名称增加了Bundle,其余文件名称均是修改为大写开头。 52 53**变更影响**<br> 54仅修改二级模块文件名称,不会影响一级模块的使用。在使用之前已发布的API 9各beta版本时,如果在ts文件中直接导入了bundleManager下面二级模块接口的,IDE中编译报错的话,需要修改导入的文件名称。 55 56**关键的接口/组件变更**<br> 57变更bundleManager文件夹下面的d.ts名称,修改为文件中的接口名称。 58 59**适配指导**<br> 60使用新的sdk后,正常情况下应用无需适配该变更。如果在应用中直接导入了bundleManager文件夹下面的文件,则需要修改导入的文件名称。可以按照如下的修改方式: 61 62**修改前:** 63```ts 64import {AbilityInfo} from 'bundleManger/abilityInfo'; 65import {ExtensionAbilityInfo} from 'bundleManger/extensionAbilityInfo'; 66import {BundlePackInfo} from 'bundleManger/packInfo'; 67``` 68**修改后:** 69```ts 70import {AbilityInfo} from 'bundleManger/AbilityInfo'; 71import {ExtensionAbilityInfo} from 'bundleManger/ExtensionAbilityInfo'; 72import {BundlePackInfo} from 'bundleManger/BundlePackInfo'; 73``` 74 75## cl.bundlemanager.4 包管理LaunchType枚举类型名称变更,由STANDARD修改为MULTITON,枚举值不变。 76 77包管理[LaunchType](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/@ohos.bundle.bundleManager.d.ts)枚举类型变更,由STANDARD修改为MULTITON,枚举值不变,表示多实例类型。 78 79**变更影响**<br> 80使用之前已发布的API 9各beta版本且使用到了LaunchType.STANDARD的,需要改为使用LaunchType.MULTITON接口。 81 82**关键的接口/组件变更**<br> 83LaunchType枚举类型名称变更,由LaunchType.STANDARD修改为LaunchType.MULTITON。 84 85**适配指导**<br> 86由LaunchType.STANDARD修改为LaunchType.MULTITON。 87 88## cl.bundlemanager.5 包管理AbilityInfo结构体中isVisible字段修改为exported,类型不变。 89 90包管理[AbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。 91 92**变更影响**<br> 93使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。 94 95**关键的接口/组件变更**<br> 96包管理[AbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/AbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变。 97 98**适配指导**<br> 99由isVisible修改为exported。 100 101## cl.bundlemanager.6 包管理ExtensionAbilityInfo结构体中isVisible字段修改为exported,类型不变。 102 103包管理[ExtensionAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。 104 105**变更影响**<br> 106使用之前已发布的API 9各beta版本且使用到了isVisible的,需要改为使用exported。 107 108**关键的接口/组件变更**<br> 109包管理[ExtensionAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ExtensionAbilityInfo.d.ts)结构体中isVisible字段修改为exported,类型不变。 110 111**适配指导**<br> 112由isVisible修改为exported。 113 114## cl.bundlemanager.7 包管理ModuleAbilityInfo结构体中visible字段修改为exported,类型不变。 115 116包管理[ModuleAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts)结构体中visible字段修改为exported,类型不变,表示当前ability是否支持导出,被其他的ability使用。 117 118**变更影响**<br> 119使用之前已发布的API 9各beta版本且使用到了visible的,需要改为使用exported。 120 121**关键的接口/组件变更**<br> 122包管理[ModuleAbilityInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/BundlePackInfo.d.ts)结构体中visible字段修改为exported,类型不变。 123 124**适配指导**<br> 125由visible修改为exported。 126 127## cl.bundlemanager.8 app.json配置文件删除distributedNotificationEnabled标签 128删除配置文件app.json中[distributedNotificationEnabled](../../../application-dev/quick-start/app-configuration-file.md)标签 129 130**变更影响**<br> 131删除配置文件app.json中[distributedNotificationEnabled](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 132 133**适配指导**<br> 134删除[distributedNotificationEnabled](../../../application-dev/quick-start/app-configuration-file.md)标签 135 136## cl.bundlemanager.9 app.json配置文件删除entityType标签 137删除配置文件app.json中[entityType](../../../application-dev/quick-start/app-configuration-file.md)标签 138 139**变更影响**<br> 140删除配置文件app.json中[entityType](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 141 142**适配指导**<br> 143删除[entityType](../../../application-dev/quick-start/app-configuration-file.md)标签 144 145## cl.bundlemanager.10 app.json配置文件删除keepAlive标签 146删除配置文件app.json中[keepAlive](../../../application-dev/quick-start/app-configuration-file.md)标签 147 148**变更影响**<br> 149删除配置文件app.json中[keepAlive](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 150 151**适配指导**<br> 152删除[keepAlive](../../../application-dev/quick-start/app-configuration-file.md)标签 153 154## cl.bundlemanager.11 app.json配置文件删除removable标签 155删除配置文件app.json中[removable](../../../application-dev/quick-start/app-configuration-file.md)标签 156 157**变更影响**<br> 158删除配置文件app.json中[removable](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 159 160**适配指导**<br> 161删除[removable](../../../application-dev/quick-start/app-configuration-file.md)标签 162 163## cl.bundlemanager.12 app.json配置文件删除singleton标签 164删除配置文件app.json中[singleton](../../../application-dev/quick-start/app-configuration-file.md)标签 165 166**变更影响**<br> 167删除配置文件app.json中[singleton](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 168 169**适配指导**<br> 170删除[singleton](../../../application-dev/quick-start/app-configuration-file.md)标签 171 172## cl.bundlemanager.13 app.json配置文件删除userDataClearable标签 173删除配置文件app.json中[userDataClearable](../../../application-dev/quick-start/app-configuration-file.md)标签 174 175**变更影响**<br> 176删除配置文件app.json中[userDataClearable](../../../application-dev/quick-start/app-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 177 178**适配指导**<br> 179删除[userDataClearable](../../../application-dev/quick-start/app-configuration-file.md)标签 180 181## cl.bundlemanager.14 module.json配置文件中module的name标签不再支持配置中文 182module.json配置文件中的module的[name](../../../application-dev/quick-start/module-configuration-file.md)不再支持配置中文 183 184**变更影响**<br> 185删除配置文件module.json中module的[name](../../../application-dev/quick-start/module-configuration-file.md)标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错 186 187**适配指导**<br> 188使用英文语言配置module.json中module的[name](../../../application-dev/quick-start/module-configuration-file.md)标签 189 190## cl.bundlemanager.15 module.json配置文件中ability的name标签不再支持配置中文 191module.json配置文件中的ability的[name](../../../application-dev/quick-start/module-configuration-file.md)不再支持配置中文 192 193**变更影响**<br> 194删除配置文件module.json中ability的[name](../../../application-dev/quick-start/module-configuration-file.md)标签不再支持配置中文,IDE中配置该标签为中文,会导致IDE编译报错 195 196**适配指导**<br> 197使用英文语言配置module.json中ability的[name](../../../application-dev/quick-start/module-configuration-file.md)标签 198 199## cl.bundlemanager.16 module.json配置文件删除uiSyntax标签 200删除配置文件module.json中[uiSyntax](../../../application-dev/quick-start/module-configuration-file.md)标签 201 202**变更影响**<br> 203删除配置文件module.json中[uiSyntax](../../../application-dev/quick-start/module-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 204 205**适配指导**<br> 206删除module.json中[uiSyntax](../../../application-dev/quick-start/module-configuration-file.md)标签 207 208## cl.bundlemanager.17 module.json配置文件中module及ability中的srcEntrance标签修改为srcEntry 209配置文件module.json中[srcEntrance](../../../application-dev/quick-start/module-configuration-file.md)标签修改为srcEntry 210 211**变更影响**<br> 212删除配置文件module.json中[srcEntrance](../../../application-dev/quick-start/module-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 213 214**适配指导**<br> 215删除module.json中[srcEntrance](../../../application-dev/quick-start/module-configuration-file.md)标签,使用srcEntry替代 216 217## cl.bundlemanager.18 删除module.json配置文件中distroFilter的apiVersion标签 218删除配置文件module.json中[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)的apiVersion标签 219 220**变更影响**<br> 221删除配置文件module.json[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)的apiVersion标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 222 223**适配指导**<br> 224删除module.json中[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)的apiVersion标签 225 226## cl.bundlemanager.19 module.json配置文件中distroFilter修改为distributionFilter 227配置文件module.json中[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)标签修改为distributionFilter 228 229**变更影响**<br> 230删除配置文件module.json[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 231 232**适配指导**<br> 233删除module.json中[distroFilter](../../../application-dev/quick-start/module-configuration-file.md)标签,使用distributionFilter替代 234 235## cl.bundlemanager.20 module.json配置文件中launchTypede标签standard模式修改为multiton 236删除module.json中[launchType](../../../application-dev/quick-start/module-configuration-file.md)标签的standard模式修改为multiton 237 238**适配指导**<br> 239删除module.json中[launchType](../../../application-dev/quick-start/module-configuration-file.md)标签的standard模式,使用multiton替代 240 241## cl.bundlemanager.21 app.json配置文件删除atomicService标签 242删除配置文件app.json中atomicService标签 243 244**变更影响**<br> 245删除配置文件app.json中atomicService标签,IDE中不再支持配置该标签,使用该标签会导致IDE编译报错 246 247**适配指导**<br> 248删除atomicService标签 249 250## cl.bundlemanager.22 app.json配置文件新增bundleType标签 251配置文件app.json中新增bundleType标签 252 253**变更影响**<br> 254现存的元服务([installationFree](../../../application-dev/quick-start/module-configuration-file.md)为true),必须在app.json中指定bundleType为atomicService,否则打包失败。 255 256**适配指导**<br> 257新增[bundleType](../../../application-dev/quick-start/app-configuration-file.md)标签。该标签为可缺省(缺省值为app)。该标签需要和module.json中[installationFree](../../../application-dev/quick-start/module-configuration-file.md)字段保持一一对应,其相应规则为: 258- 当bundleType为app时,installationFree必须为false。 259- 当bundleType为atomicService时,installationFree必须为true。 260 261## cl.bundlemanager.23 包管理ApplicationInfo结构体中删除split字段。 262 263包管理[ApplicationInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ApplicationInfo.d.ts)结构体中删除split字段。 264 265**变更影响**<br> 266使用之前已发布的API 9各beta版本且使用到了split的,会编译失败。 267 268**关键的接口/组件变更**<br> 269包管理[ApplicationInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/ApplicationInfo.d.ts)结构体中删除split字段。 270 271**适配指导**<br> 272删除ApplicationInfo结构体中的split字段。目前元服务中stage模型强制分包,不支持不分包。 273 274## cl.bundlemanager.24 包管理HapModuleInfo结构体中删除atomicServiceModuleType字段。 275 276包管理[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中删除atomicServiceModuleType字段。 277 278**变更影响**<br> 279使用之前已发布的API 9各beta版本且使用到了atomicServiceModuleType的,会编译失败。 280 281**关键的接口/组件变更**<br> 282包管理[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中删除atomicServiceModuleType字段。 283 284**适配指导**<br> 285删除[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中的atomicServiceModuleType字段。判断atomicServiceModuleType字段的部分,用[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中的moduleType代替。 286 287## cl.bundlemanager.25 包管理删除AtomicServiceModuleType枚举值。 288 289包管理[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中删除atomicServiceModuleType字段。 290 291**变更影响**<br> 292使用之前已发布的API 9各beta版本且使用到了atomicServiceModuleType的,会编译失败。 293 294**关键的接口/组件变更**<br> 295包管理[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中删除atomicServiceModuleType字段。 296 297**适配指导**<br> 298删除[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中的atomicServiceModuleType字段。判断atomicServiceModuleType字段的部分,用[HapModuleInfo](https://gitee.com/openharmony/interface_sdk-js/blob/master/api/bundleManager/HapModuleInfo.d.ts)结构体中的moduleType代替。