@ohos.distributedBundle (Distributed Bundle Management)

The distributedBundle module manages distributed bundles.

NOTE

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

Modules to Import

import distributedBundle from '@ohos.distributedBundle';

System Capability

SystemCapability.BundleManager.DistributedBundleFramework

Required Permissions

Permission Permission Level Description
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED system_basic Permission to query information about all applications.

For details, see Permission Levels.

distributedBundle.getRemoteAbilityInfodeprecated

This API is deprecated since API version 9. You are advised to use getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager) instead.

getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback<RemoteAbilityInfo>): void

Obtains information about the remote ability that matches the given element name. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.DistributedBundleFramework

System API

This is a system API.

Parameters

Name Type Mandatory Description
elementName ElementName Yes ElementName.
callback AsyncCallback<RemoteAbilityInfo> Yes Callback used to return the remote ability information.

distributedBundle.getRemoteAbilityInfodeprecated

This API is deprecated since API version 9. You are advised to use getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager) instead.

getRemoteAbilityInfo(elementName: ElementName): Promise<RemoteAbilityInfo>

Obtains information about the remote ability that matches the given element name. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.DistributedBundleFramework

System API

This is a system API.

Parameters

Name Type Mandatory Description
elementName ElementName Yes ElementName.

Return value

Type Description
Promise<RemoteAbilityInfo> Promise used to return the remote ability information.

distributedBundle.getRemoteAbilityInfosdeprecated

This API is deprecated since API version 9. You are advised to use getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager) instead.

getRemoteAbilityInfos(elementNames: Array<ElementName>, callback: AsyncCallback<Array<RemoteAbilityInfo>>): void

Obtains information about remote abilities that match the given element names. This API uses an asynchronous callback to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.DistributedBundleFramework

System API

This is a system API.

Parameters

Name Type Mandatory Description
elementNames Array<ElementName> Yes ElementName array, whose maximum length is 10.
callback AsyncCallback< Array<RemoteAbilityInfo>> Yes Callback used to return an array of the remote ability information.

distributedBundle.getRemoteAbilityInfosdeprecated

This API is deprecated since API version 9. You are advised to use getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager) instead.

getRemoteAbilityInfos(elementNames: Array<ElementName>): Promise<Array<RemoteAbilityInfo>>

Obtains information about remote abilities that match the given element names. This API uses a promise to return the result.

Required permissions

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

System capability

SystemCapability.BundleManager.DistributedBundleFramework

System API

This is a system API.

Parameters

Name Type Mandatory Description
elementNames Array<ElementName> Yes ElementName array, whose maximum length is 10.

Return value

Type Description
Promise<Array<RemoteAbilityInfo>> Promise used to return an array of the remote ability information.