@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 and cannot be called by third-party applications.
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 and cannot be called by third-party applications.
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 and cannot be called by third-party applications.
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 and cannot be called by third-party applications.
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. |