1# Bundle Manager Subsystem Changelog 2 3## cl.bundlemanager.1 zlib.unzipFile and zlib.decompressFile Changed 4 5**Access Level** 6 7Public API 8 9**Reason for Change** 10 11During file decompression, the system intercepts compressed packages that do not meet the format requirements to avoid unexpected decompressed files. 12 13 14**Change Impact** 15 16This change requires application adaptation. 17 18Before the change, incorrectly formatted compressed packages can be decompressed, but the decompressed content does not meet expectations. 19 20After the change, decompression of incorrectly formatted compressed packages fails, and an error code indicating incorrect file format is thrown. 21 22**Start API Level** 23 249 25 26**Change Since** 27 28OpenHarmony SDK 6.0.0.39 29 30**Key API/Component Changes** 31 32[zlib.unzipFile](../../../application-dev/reference/apis-basic-services-kit/js-apis-zlib.md#zlibunzipfiledeprecated) and [zlib.decompressFile](../../../application-dev/reference/apis-basic-services-kit/js-apis-zlib.md#zlibdecompressfile10). 33 34 35**Adaptation Guide** 36 37When calling the **zlib.unzipFile** and **zlib.decompressFile** APIs, you need to catch interface exceptions, handle them based on the returned error code, and check for errors in the input compressed package. 38 39 40## cl.bundlemanager.2 Parameter Type Changed for getDeveloperIds and sharedBundleDirPaths 41 42**Access Level** 43 44System API 45 46**Reason for Change** 47 48The return type of [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) and the parameter type of [sharedBundleDirPaths](../../../application-dev/reference/apis-ability-kit/js-apis-installer-sys.md#installparam) are actually Array\<string>, but the APIs are declared as Array\<String>, which does not match the actual types and needs to be corrected. 49 50 51**Change Impact** 52 53This change requires application adaptation. 54 55Before the change, the return type of [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) and the parameter type of [sharedBundleDirPaths](../../../application-dev/reference/apis-ability-kit/js-apis-installer-sys.md#installparam) are Array\<String>. Applications can call them with the Array\<String> type, and the compilation can pass, but an exception is thrown at runtime. 56 57After the change, the return type of [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) and the parameter type of [sharedBundleDirPaths](../../../application-dev/reference/apis-ability-kit/js-apis-installer-sys.md#installparam) are Array\<string>. Applications can only call them with the Array\<string> type, and both compilation and runtime execution are normal. 58 59**Start API Level** 60 6110 62 63**Change Since** 64 65OpenHarmony SDK 6.0.0.39 66 67**Key API/Component Changes** 68 69| Name| Before Change| After Change| 70| -------- | -------- | ---| 71| [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) | function getDeveloperIds(appDistributionType?: number): Array\<String> | function getDeveloperIds(appDistributionType?: number): Array\<string> | 72| [InstallParam.sharedBundleDirPaths](../../../application-dev/reference/apis-ability-kit/js-apis-installer-sys.md#installparam) | sharedBundleDirPaths?: Array\<String> | sharedBundleDirPaths?: Array\<string> | 73 74 75**Adaptation Guide** 76 771. If the application uses the return value of [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) as an [getDeveloperIds](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagergetdeveloperids12) object, it needs to be changed to use it as an Array\<string>. 782. If the application uses the parameter of [InstallParam.sharedBundleDirPaths](../../../application-dev/reference/apis-ability-kit/js-apis-installer-sys.md#installparam) as an Array\<String> object, it needs to be changed to use it as an Array\<string>. 79 80 81## cl.bundlemanager.3 enableDynamicIcon Changed 82 83**Access Level** 84 85System API 86 87**Reason for Change** 88 89To ensure that custom theme application icons have a higher priority than dynamic icons, after the change, if the application has a custom theme icon, calling the enable dynamic icon interface will fail, and the application icon on the home screen will not switch to a dynamic icon. 90 91 92**Change Impact** 93 94This change requires application adaptation. 95 96Before the change, when custom theme application icon resources exist, the application can successfully call the **enableDynamicIcon** API. 97 98After the change, when custom theme application icon resources exist, calling the **enableDynamicIcon** API fails, and error code 17700307 is thrown. 99 100 101**Start API Level** 102 10312 104 105**Change Since** 106 107OpenHarmony SDK 6.0.0.39 108 109**Key API/Component Changes** 110 111[enableDynamicIcon](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md#bundlemanagerenabledynamicicon12) 112 113 114**Adaptation Guide** 115 116Applications need to catch the newly added error code 17700307 and handle it. 117 118 119## cl.bundlemanager.4 Behavior Changed and Control Increased for Ability Kit Related Common Events 120 121**Access Level** 122 123Public API 124 125**Reason for Change** 126 127Some common events in Ability Kit contain application information, which poses a security risk of information leakage and requires increased control. 128 129**Change Impact** 130 131This change requires application adaptation. 132 133Controls are added for subscribers of the following common events: [COMMON_EVENT_PACKAGE_ADDED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_added), [COMMON_EVENT_PACKAGE_REMOVED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_removed), [COMMON_EVENT_PACKAGE_CHANGED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_changed), [COMMON_EVENT_PACKAGE_RESTARTED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_restarted), [COMMON_EVENT_PACKAGE_DATA_CLEARED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_data_cleared), [COMMON_EVENT_PACKAGE_CACHE_CLEARED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_cache_cleared), and [COMMON_EVENT_QUICK_FIX_APPLY_RESULT](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_quick_fix_apply_result). 134 135Before the change, both system applications and third-party applications can listen for these events. 136 137After the change, system applications can listen for events for their own applications and other applications, whereas third-party applications can only listen for events for their own applications. 138 139**Start API Level** 140 1419 142 143**Change Since** 144 145OpenHarmony SDK 6.0.0.39 146 147**Key API/Component Changes** 148 149Changed common events: 150| Event Name| Description| 151| -------- | -------- | 152| [COMMON_EVENT_PACKAGE_ADDED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_added) | Event indicating that an application is installed.| 153| [COMMON_EVENT_PACKAGE_REMOVED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_removed) | Event indicating that an application is uninstalled.| 154| [COMMON_EVENT_PACKAGE_CHANGED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_changed) | Event indicating that an application is updated.| 155| [COMMON_EVENT_PACKAGE_RESTARTED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_restarted) | Event indicating that an application is restarted.| 156| [COMMON_EVENT_PACKAGE_DATA_CLEARED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_data_cleared) | Event indicating that the application data is cleared.| 157| [COMMON_EVENT_PACKAGE_CACHE_CLEARED](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_package_cache_cleared) | Event indicating that the application cache data is cleared.| 158| [COMMON_EVENT_QUICK_FIX_APPLY_RESULT](../../../application-dev/reference/apis-basic-services-kit/common_event/commonEventManager-definitions.md#common_event_quick_fix_apply_result) | Event indicating that the application enables the quick fix package.| 159 160 161**Adaptation Guide** 162 163If you use the above common events to determine whether an application is installed, switch to using the [canOpenLink](../../../application-dev/reference/apis-ability-kit/js-apis-bundleManager.md#bundlemanagercanopenlink12) API to check whether the application exists. 164