BundleManager

ability_info.h

Declares structures and functions for managing ability information.

appexecfwk_errors.h

Declares error codes returned by bundle management functions.

bundle_info.h

Declares structures and functions for managing application bundle information.

bundle_manager.h

Declares functions used for managing application bundles and obtaining bundle information.

element_name.h

Declares the structure that defines the required information for querying AbilityInfo, including the device ID, bundle name, and class name, and functions for setting such information.

module_info.h

Declares structures and functions for managing HAP package information.

AbilityInfo

Defines the ability information.

BundleInfo

Defines the bundle information.

ElementName

Defines the ability information.

MetaData

Defines the metadata information in a ModuleInfo object.

ModuleInfo

Defines the HAP information.

InstallerCallback) (const uint8_t resultCode, const void *resultMessage)

typedef void(* 

Called when an application is installed, updated, or uninstalled.

AbilityType { UNKNOWN = 0, PAGE, SERVICE }

Enumerates types of templates used by an ability.

LaunchMode { SINGLETON = 0, STANDARD }

Enumerates startup modes of an ability.

AppexecfwkErrors {   ERR_OK = 0, ERR_APPEXECFWK_QUERY_PARAMETER_ERROR, ERR_APPEXECFWK_QUERY_NO_INFOS, ERR_APPEXECFWK_QUERY_INFOS_INIT_ERROR,   ERR_APPEXECFWK_OBJECT_NULL, ERR_APPEXECFWK_INSTALL_FAILED_INTERNAL_ERROR = 10, ERR_APPEXECFWK_INSTALL_FAILED_PARAM_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_FILE_PATH_INVALID,   ERR_APPEXECFWK_INSTALL_FAILED_FILE_NOT_EXISTS, ERR_APPEXECFWK_INSTALL_FAILED_INVALID_FILE_NAME, ERR_APPEXECFWK_INSTALL_FAILED_BAD_FILE, ERR_APPEXECFWK_INSTALL_FAILED_CREATE_FILE_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_CREATE_CODE_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_REMOVE_CODE_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_CREATE_PERMISSIONS_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_RENAME_DIR_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_RENAME_FILE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_REMOVE_DATA_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_CREATE_DATA_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_RECORD_INFO_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_UID_AND_GID_BACKUP_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_CHOWN_DATA_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_VERSION_DOWNGRADE, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_BUNDLE_NUMBER,   ERR_APPEXECFWK_INSTALL_FAILED_STORE_PERMISSIONS_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_FILE_DATA_INVALID, ERR_APPEXECFWK_INSTALL_FAILED_INCOMPATIBLE_SIGNATURE, ERR_APPEXECFWK_INSTALL_FAILED_INVALID_PROVISIONINFO,   ERR_APPEXECFWK_INSTALL_FAILED_OPERATE_SIGNED_FILE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_APP_SIGNATURE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_PROFILE_SIGNATURE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_INTERNAL_SIGNATURE_ERROR,   ERR_APPEXECFWK_SET_DEBUG_MODE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_PROFILE_ERROR = 40, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_BUNDLENAME_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_INVALID_BUNDLENAME,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_VENDOR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_VERSIONCODE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_VERSIONNAME_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_PERMISSIONS_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_API_VERSION_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DEVICE_CONFIG_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_KEEPALIVE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_MODULENAME_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_INVALID_MODULENAME, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_MODULE_DESCRIPTION_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DEVICETYPE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DISTRO_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DISTRO_MODULENAME_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DISTRO_MODULETYPE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DISTRO_DELIVERY_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_METADATA_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITIES_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_NAME_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_TYPE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_ICONPATH_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_LABEL_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_DESCRIPTION_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_LAUNCHTYPE_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ABILITY_VISIBLE_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_INVALID_BUNDLENAME_LENGTH, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_LABEL_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_VERSIONNAME_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_METADATA_NAME_LENGTH_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_METADATA_VALUE_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_VENDOR_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_MODULENAME_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_ABILITYNAME_LENGTH_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_ABILITY_DESCRIPTION_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXCEED_MAX_ABILITY_LABEL_LENGTH_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_EXTRACTOR_NOT_INIT, ERR_APPEXECFWK_INSTALL_FAILED_EXTRACT_HAP_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_JS_DIR_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_RESOURCE_INDEX_NOT_EXISTS, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_LABEL_RES_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_PARSE_ICON_RES_ERROR,   ERR_APPEXECFWK_INSTALL_FAILED_PARSE_DESCRIPTION_RES_ERROR, ERR_APPEXECFWK_INSTALL_FAILED_SEND_REQUEST_ERROR, ERR_APPEXECFWK_UNINSTALL_FAILED_INTERNAL_ERROR = 90, ERR_APPEXECFWK_UNINSTALL_FAILED_PARAM_ERROR,   ERR_APPEXECFWK_UNINSTALL_FAILED_BUNDLE_NOT_EXISTS, ERR_APPEXECFWK_UNINSTALL_FAILED_DELETE_DIRS_ERROR, ERR_APPEXECFWK_UNINSTALL_FAILED_DELETE_RECORD_INFO_ERROR, ERR_APPEXECFWK_UNINSTALL_FAILED_DELETE_PERMISSIONS_ERROR,   ERR_APPEXECFWK_UNINSTALL_FAILED_BUNDLE_NOT_UNINSTALLABLE, ERR_APPEXECFWK_UNINSTALL_FAILED_DELETE_UID_INFO_ERROR, ERR_APPEXECFWK_UNINSTALL_FAILED_SEND_REQUEST_ERROR, ERR_APPEXECFWK_DUMP_ERROR = 100,   ERR_APPEXECFWK_COMMAND_ERROR, ERR_APPEXECFWK_CALLBACK_REGISTER_FAILED, ERR_APPEXECFWK_CALLBACK_UNREGISTER_FAILED, ERR_APPEXECFWK_CALLBACK_GENERATE_LOCAL_SERVICEID_FAILED,   ERR_APPEXECFWK_CALLBACK_SERVICEID_TRANSMITTED_FAILED, ERR_APPEXECFWK_CALLBACK_NEVER_REGISTERED, ERR_APPEXECFWK_CALLBACK_OBTAIN_ALL_BUNDLE_FAILED, ERR_APPEXECFWK_CALLBACK_NULL_CORRESPONDING_CALLBACK,   ERR_APPEXECFWK_CALLBACK_GET_INSTALLTYPE_FAILED, ERR_APPEXECFWK_CALLBACK_GET_ERROR_INSTALLTYPE, ERR_APPEXECFWK_SERIALIZATION_FAILED, ERR_APPEXECFWK_DESERIALIZATION_FAILED,   ERR_APPEXECFWK_SYSTEM_INTERNAL_ERROR, ERR_APPEXECFWK_NO_BUNDLENAME_FOR_UID, ERR_APPEXECFWK_IPCIO_UNAVAILABLED, ERR_APPEXECFWK_INVOKE_ERROR,   ERR_APPEXECFWK_PERMISSION_DENIED }

Enumerates error codes provided by the Bundle Manager Service.

ClearAbilityInfo (AbilityInfo *abilityInfo)

void 

Clears an AbilityInfo object.

ClearBundleInfo (BundleInfo *bundleInfo)

void 

Clears a BundleInfo object.

RegisterCallback (BundleStatusCallback *BundleStatusCallback)

int32_t 

Registers a callback to monitor the installation, update, and uninstallation state changes of an application.

UnregisterCallback ()

int32_t 

Unregisters a callback previously registered for monitoring the installation, update, and uninstallation state changes of an application.

Install (const char *hapPath, const InstallParam *installParam, InstallerCallback installerCallback)

bool 

Installs or updates an application.

Uninstall (const char *bundleName, const InstallParam *installParam, InstallerCallback installerCallback)

bool 

Uninstalls an application.

QueryAbilityInfo (const Want *want, AbilityInfo *abilityInfo)

uint8_t 

Queries the AbilityInfo of an ability based on the information carried in the Want structure.

GetBundleInfo (const char *bundleName, int32_t flags, BundleInfo *bundleInfo)

uint8_t 

Obtains the BundleInfo of an application based on the specified bundle name.

GetBundleInfos (const int flags, BundleInfo **bundleInfos, int32_t *len)

uint8_t 

Obtains the BundleInfo of all bundles in the system.

QueryKeepAliveBundleInfos (BundleInfo **bundleInfos, int32_t *len)

uint8_t 

Obtains the BundleInfo of all keep-alive applications in the system.

GetBundleInfosByMetaData (const char *metaDataKey, BundleInfo **bundleInfos, int32_t *len)

uint8_t 

Obtains the BundleInfo of application bundles based on the specified MetaData.

GetBundleNameForUid (int32_t uid, char **bundleName)

uint8_t 

Obtains the bundle name of an application based on the specified UID.

ClearElement (ElementName *element)

void 

Clears the internal data of a specified ElementName.

SetElementDeviceID (ElementName *element, const char *deviceId)

bool 

Sets the device ID used to query AbilityInfo.

SetElementBundleName (ElementName *element, const char *bundleName)

bool 

Sets the bundle name used to query AbilityInfo.

SetElementAbilityName (ElementName *element, const char *abilityName)

bool 

Sets the class name of the ability used to query AbilityInfo.

ClearModuleInfo (ModuleInfo *moduleInfo)

void 

Clears a ModuleInfo object.

Unknown

Page

Service

The function is successfully called.

Incorrect parameter for querying AbilityInfo or BundleInfo.

No AbilityInfo or BundleInfo is found.

An error occurred when initializing BundleInfo or AbilityInfo during information query.

The object or pointer is null.

Failed to install the application due to an internal logic error.

Failed to install the application due to incorrect parameters.

Failed to install the application because the installation file path is invalid.

Failed to install the application because the installation file does not exist.

Failed to install the application because the installation file name is invalid.

Failed to install the application due to incorrect file content.

Failed to install the application due to a file creation error.

Failed to install the application due to a file path creation error.

Failed to install the application due to a file path deletion error.

Failed to install the application because an error occurred when creating the permission file directory.

Failed to install the application due to a path renaming error.

Failed to install the application due to a file renaming error.

Failed to install the application due to an error occurred when removing the data path.

Failed to install the application due to an error occurred when creating the data path.

Failed to install the application due to an error occurred when recording installation information.

Failed to install the application due to an error occurred when backing up the UID and GID.

Failed to install the application due to an error occurred when changing ownership of the data directory.

Failed to install the application because an application of a later version has been installed.

Failed to install the application because the number of installed applications exceeds the maximum (30). This error code is available only to basic watches.

Failed to install the application due to an error occurred when storing permission information.

Failed to install the application due to invalid file data. This error code is available only to basic watches.

Failed to install the application due to unmatched signature used for version update.

Failed to install the application due to unmatched provisioning information during signature verification.

Failed to install the application due to an error occurred when processing the signature file.

Failed to install the application due to an error occurred when parsing the application signature.

Failed to install the application due to an error occurred when parsing the file signature.

Failed to install the application due to an internal error during signature verification.

Failed to install the application due to an error occurred when setting the signature verification mode.

Failed to parse the file.

Failed to parse the bundle name.

Invalid bundle name.

Failed to parse the vendor information.

Failed to parse the version code.

Failed to parse the version name.

Failed to parse the installation permission information.

Failed to parse the API version.

Failed to parse the device configuration.

Failed to parse the isKeepAlive field of the application.

Failed to parse the name field of the application's HAP package. The HAP information is encapsulated in a ModuleInfo object.

Invalid HAP name.

Failed to parse the HAP description information.

Failed to parse the deviceType field of the application's HAP package.

Failed to parse the HAP information.

Failed to parse the moduleName field of the application's HAP package.

Invalid HAP type.

Failed to parse the isDeliveryInstall field of the application's HAP package.

Failed to parse the MetaData information.

Failed to parse the AbilityInfo.

Failed to parse the class name of the ability.

Failed to parse the template used by the ability.

Failed to parse the icon path of the ability.

Failed to parse the label of the ability.

Failed to parse the description of the ability.

Failed to parse the startup mode of the ability.

Failed to parse the isVisible field of the ability.

Invalid length of the bundle name.

The parsed application label exceeds the maximum length (255 bytes).

The parsed application version name exceeds the maximum length (127 bytes).

The parsed application metadata name exceeds the maximum length (255 bytes).

The parsed application metadata value exceeds the maximum length (255 bytes).

The parsed application vendor name exceeds the maximum length (255 bytes).

The parsed HAP name exceeds the maximum length (31 bytes).

The parsed ability class name exceeds the maximum length (127 bytes).

The parsed ability description exceeds the maximum length (255 bytes).

The parsed ability label exceeds the maximum length (255 bytes).

Failed to initialize the extractor.

Failed to extract hap.

Failed to parse the JavaScript path. This error code is available only to basic watches.

The resource index does not exist.

Failed to parse the label resource.

Failed to parse the icon resource.

Failed to parse the description resource.

Failed to install the application due to a request sending error.

Failed to uninstall the application due to an internal error.

Failed to uninstall the application due to incorrect input parameters.

Failed to uninstall the application because it does not exist.

Failed to uninstall the application due to an error occurred when deleting the path.

Failed to uninstall the application due to an error occurred when deleting the installation record.

Failed to uninstall the application due to an error occurred when deleting the permission information.

Failed to uninstall the application because the application cannot be uninstalled.

Failed to uninstall the application due to an error occurred when deleting the UID information.

Failed to uninstall the application due to a request sending error.

Incorrect dump information.

Incorrect command.

Failed to register the callback.

Failed to unregister the callback.

Failed to generate a service ID for the current process.

Failed to transmit the service ID of the current process.

The callback is never registered.

Failed to obtain the bundle names of all applications in the system.

The required callback is unavailable.

Failed to obtain the installation type (installation or uninstallation).

Incorrect installation type.

Serialization failed.

Deserialization failed.

Internal system error.

No bundle name associated with the UID is found.

The IpcIo structure is unavailable.

An error occurred when calling the invoke function of the Bundle Manager Service.

The server that invokes the Bundle Manager Service does not have required permission.

Singleton mode, allowing only one instance

Standard mode, allowing multiple instances