1# Bundle Manager Subsystem Changelog 2 3## cl.bundlemanager.1 Specifications of Entry Icons and Entry Labels Changed 4 5**Access Level** 6 7Public API 8 9**Reason for Change** 10 11The [entry icon and entry name](../../../application-dev/application-models/application-component-configuration-stage.md#configuring-the-entry-icon-and-entry-label), configured under **abilities** in the **module.json5** file, are the icon and name displayed on the home screen after the application is installed. The [application icon and application name](../../../application-dev/application-models/application-component-configuration-stage.md#configuring-the-application-icon-and-application-label), configured in the **app.json5** file, are the icon and name displayed in the application list of Settings or notification bar after the application is installed. 12 13If an application is configured with the application icon, application name, entry icon, and entry name, the icon and name displayed on the home screen are different from those displayed in Settings. To prevent malicious applications from forging the icons and names, an application should always display the same icon and name in different places of the device. 14 15**Change Impact** 16 17This change is a compatible change. If an application has an entry UIAbility with the entry icon and entry label configured, that entry icon and entry label are displayed. If an application is not configured with an entry icon or entry label, the application icon and application label are displayed. 18 19Before change: 20 21| Position | Icon and Name Displayed | Description | 22| ----- | ---------- | --------- | 23| Home screen | Entry icon and name | If an application does not have an entry UIAbility, the application icon and application name are displayed. | 24| Settings | Application icon and name | The fields for configuring the application icon and name are mandatory. The default icon and name are provided during project creation. | 25 26 27After change: 28| Position | Icon and Name Displayed | Description | 29| ----- | ---------- | --------- | 30| Home screen | Entry icon and name | If an application does not have an entry UIAbility, the application icon and application name are displayed. | 31| Settings | Entry icon and name | If an application has an entry UIAbility with the entry icon and entry label configured, the entry icon and entry label are displayed. If an application does not have an entry UIAbility or is not configured with an entry icon or entry label, the application icon and application label are displayed. If an application has multiple entry UIAbilities, the icon and name configured in the UIAbility corresponding to the mainElement of the entry type HAP are displayed. | 32 33**Start API Level** 34 35N/A 36 37**Change Since** 38 39OpenHarmony SDK 5.0.0.31 40 41**Key API/Component Changes** 42 43The icons and labels returned by the query interface provided by the bundleManager module are returned by priority. 44 45**Adaptation Guide** 46 47You are advised to keep the application icon, application label, entry icon, and entry label consistent. 48 49## cl.bundlemanager.2 Only One Entry UIAbility Is Supported by for an Application 50 51**Access Level** 52 53System API 54 55**Reason for Change** 56 57If an application has multiple entry icons, different icons and names will be displayed on the home screen after the application is installed. Malicious applications may forge the icons and names of others, bringing security and privacy leakage risks. After the application is modified to support only one entry UIAbility, only one icon and name are displayed on the home screen after the application is installed. If multiple entry UIAbilities are configured for an application, only the mainElement in the HAP of the entry type takes effect. 58 59Entry UIAbility configuration fields: 60For **skills** under **abilities** in **module.json5**, **entities** contains **entity.system.home**, and **actions** contains **action.system.home**. 61 62 63 64**Change Impact** 65 66This change is a non-compatible change. An application supports only one entry UIAbility. 67 68Before change: 69 70Multiple entry UIAbilities can be configured for an application. After the application is installed, multiple icons and names are displayed on the home screen. 71 72After change: 73 74Only one entry UIAbility can be configured for an application. After the application is installed, only one icon and name are displayed on the home screen. If multiple entry UIAbilities are configured for an application, only the entry UIAbility corresponding to the mainElement of the HAP of the entry type is returned. 75 76**Start API Level** 77 787 79 80**Change Since** 81 82OpenHarmony SDK 5.0.0.31 83 84**Key API/Component Changes** 85 86The **getLauncherAbilityInfo** API provided by the bundleManager module returns only one entry UIAbility information. 87 88**Adaptation Guide** 89 90You are advised to configure only one entry UIAbility. 91
