harmony 鸿蒙ApplicationInfo

2025-06-12
浏览 (3)

ApplicationInfo

The ApplicationInfo module defines the application information. A third-party application can obtain its own application information through bundleManager.getBundleInfoForSelf, with GET_BUNDLE_INFO_WITH_APPLICATION passed in to bundleFlags.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

ApplicationInfo

System capability: SystemCapability.BundleManager.BundleFramework.Core

Name	Type	Read-Only	Optional	Description
name	string	Yes	No	Application name. Atomic service API: This API can be used in atomic services since API version 11.
description	string	Yes	No	Description of the application, for example, “description”: $string: mainability_description”. For details, see the description of the descriptionResource field below. Atomic service API: This API can be used in atomic services since API version 11.
descriptionId	number	Yes	No	ID of the application description. Atomic service API: This API can be used in atomic services since API version 11.
enabled	boolean	Yes	No	Whether the application is enabled. The value true means that the application is enabled, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 11.
label	string	Yes	No	Application name, for example, “label”: “$string: mainability_description”. For details, see the description of the labelResource field below. Atomic service API: This API can be used in atomic services since API version 11.
labelId	number	Yes	No	ID of the application label. Atomic service API: This API can be used in atomic services since API version 11.
icon	string	Yes	No	Application icon, for example, “icon”: “$media:icon”. For details, see the description of the iconResource field below. Atomic service API: This API can be used in atomic services since API version 11.
iconId	number	Yes	No	ID of the application icon. Atomic service API: This API can be used in atomic services since API version 11.
process	string	Yes	No	Process name. Atomic service API: This API can be used in atomic services since API version 11.
permissions	Array<string>	Yes	No	Permissions required for accessing the application. The permissions can be obtained by passing in GET_BUNDLE_INFO_WITH_APPLICATION and GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION to the bundleFlags parameter of getBundleInfoForSelf. Atomic service API: This API can be used in atomic services since API version 11.
codePath	string	Yes	No	Installation directory of the application. Atomic service API: This API can be used in atomic services since API version 11.
metadata^(deprecated)	Map<string, Array<Metadata>>	Yes	No	Metadata of the application. The information can be obtained by passing in GET_BUNDLE_INFO_WITH_APPLICATION and GET_BUNDLE_INFO_WITH_METADATA to the bundleFlags parameter of getBundleInfoForSelf. NOTE The metadata field is deprecated since API version 10. You are advised to use metadataArray instead.
metadataArray¹⁰⁺	Array<ModuleMetadata>	Yes	No	Metadata of the application. The information can be obtained by passing in GET_BUNDLE_INFO_WITH_APPLICATION and GET_BUNDLE_INFO_WITH_METADATA to the bundleFlags parameter of getBundleInfoForSelf. Atomic service API: This API can be used in atomic services since API version 11.
removable	boolean	Yes	No	Whether the application is removable. The value true means that the application is removable, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 11.
accessTokenId	number	Yes	No	Access token ID of the application, which is used in the application access control verification API. Atomic service API: This API can be used in atomic services since API version 11.
uid	number	Yes	No	UID of the application. Atomic service API: This API can be used in atomic services since API version 11.
iconResource	Resource	Yes	No	Resource information of the application icon. The resource information obtained contains the bundle name, module name, and ID of the resource. You can call getMediaContent to obtain the resource details. Atomic service API: This API can be used in atomic services since API version 11.
labelResource	Resource	Yes	No	Resource information of the application label. The resource information obtained contains the bundle name, module name, and ID of the resource. You can call getMediaContent to obtain the resource details. Atomic service API: This API can be used in atomic services since API version 11.
descriptionResource	Resource	Yes	No	Resource information of the application description. The resource information obtained contains the bundle name, module name, and ID of the resource. You can call getMediaContent to obtain the resource details. Atomic service API: This API can be used in atomic services since API version 11.
appDistributionType	string	Yes	No	Distribution type of the application signing certificate. The options are as follows: app_gallery: application distributed by AppGallery. enterprise: enterprise application that can be installed on personal devices. enterprise_mdm: enterprise Mobile Device Management (MDM) application, which can be installed only on enterprise devices. The applications of this type must have device management privileges, such as remote locking devices and installing common enterprise applications on devices. enterprise_normal: common enterprise application, which can be installed on enterprise devices only through an enterprise MDM application. The applications of this type do not require device management privileges. os_integration: preset application in the system. crowdtesting: crowdtesting application. internaltesting: application under internal testing of AppGallery. none: other applications. Atomic service API: This API can be used in atomic services since API version 11.
appProvisionType	string	Yes	No	Type of the application signing certificate file. The options are debug and release. Atomic service API: This API can be used in atomic services since API version 11.
systemApp	boolean	Yes	No	Whether the application is a system application. The value true means that the application is a system application, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 11.
bundleType	bundleManager.BundleType	Yes	No	Bundle type, which can be APP (application) or ATOMIC_SERVICE (atomic service). Atomic service API: This API can be used in atomic services since API version 11.
debug¹⁰⁺	boolean	Yes	No	Whether the application is running in debug mode. The value true means that the application is running in debug mode, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 11.
dataUnclearable¹¹⁺	boolean	Yes	No	Whether the application data is unclearable. The value true means that the application data is unclearable, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 11.
nativeLibraryPath¹²⁺	string	Yes	No	Local library file path of the application.
multiAppMode¹²⁺	MultiAppMode	Yes	No	Multi-app mode.
appIndex¹²⁺	number	Yes	No	Index of an application clone. It takes effect only for cloned applications.
installSource¹²⁺	string	Yes	No	Installation source of the application. The options are as follows: - pre-installed: The application is a preset application installed at initial device startup. - ota: The application is a preset application added during system upgrade. - recovery: The preset application is uninstalled and then restored. - bundleName: The application corresponding to the bundle name is installed. - unknown: The installation source is unknown. Atomic service API: This API can be used in atomic services since API version 12.
releaseType¹²⁺	string	Yes	No	Release type of the SDK used for application packing. Currently, the SDK release types include Canary, Beta, and Release. Each of the Canary and Beta releases can be distinguished by a sequential number, such as Canary1, Canary2, Beta1, and Beta2. You can compare the SDK release type on which application packaging depends and the OS release type (specified by deviceInfo.distributionOSReleaseType) to determine the compatibility. Atomic service API: This API can be used in atomic services since API version 12.
cloudFileSyncEnabled¹²⁺	boolean	Yes	No	Whether device-cloud file synchronization is enabled for the application. The value true means that device-cloud file synchronization is enabled, and false means the opposite. Atomic service API: This API can be used in atomic services since API version 12.

MultiAppMode¹²⁺

Defines the multi-app mode.

System capability: SystemCapability.BundleManager.BundleFramework.Core

Parameters

Name	Type	Read-Only	Optional	Description
multiAppModeType	bundleManager.MultiAppModeType	Yes	No	Type of the multi-app mode.
maxCount	number	Yes	No	Maximum number of accounts that can log in to the application at the same time.