• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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.MULTITON84
85**适配指导**<br>
86LaunchType.STANDARD修改为LaunchType.MULTITON87
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代替。