1# @ohos.distributedBundle (Distributed Bundle Management) (System API) 2 3The **distributedBundle** module manages distributed bundles. 4 5> **NOTE** 6> 7> 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. 8> 9> The APIs provided by this module are system APIs. 10 11## Modules to Import 12 13``` 14import distributedBundle from '@ohos.distributedBundle'; 15``` 16 17## System Capability 18 19SystemCapability.BundleManager.DistributedBundleFramework 20 21## Required Permissions 22 23| Permission | APL | Description | 24| ------------------------------------------ | ------------ | ------------------ | 25| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | Permission to query information about all applications. | 26 27For details about the APL, see [Basic Concepts in the Permission Mechanism](../../security/AccessToken/app-permission-mgmt-overview.md#basic-concepts-in-the-permission-mechanism). 28 29## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup> 30 31> This API is deprecated since API version 9. You are advised to use [getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager-sys.md) instead. 32 33getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback<RemoteAbilityInfo>): void 34 35Obtains information about the remote ability that matches the given element name. This API uses an asynchronous callback to return the result. 36 37**Required permissions** 38 39ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 40 41**System capability** 42 43SystemCapability.BundleManager.DistributedBundleFramework 44 45**System API** 46 47This is a system API. 48 49**Parameters** 50 51| Name | Type | Mandatory | Description | 52| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- | 53| elementName | [ElementName](js-apis-bundle-ElementName.md) | Yes | **ElementName**. | 54| callback | AsyncCallback<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo-sys.md)> | Yes | Callback used to return the remote ability information. | 55 56 57 58## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup> 59 60> This API is deprecated since API version 9. You are advised to use [getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager-sys.md) instead. 61 62getRemoteAbilityInfo(elementName: ElementName): Promise<RemoteAbilityInfo> 63 64Obtains information about the remote ability that matches the given element name. This API uses a promise to return the result. 65 66**Required permissions** 67 68ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 69 70**System capability** 71 72SystemCapability.BundleManager.DistributedBundleFramework 73 74**System API** 75 76This is a system API. 77 78**Parameters** 79 80| Name | Type | Mandatory | Description | 81| ----------- | -------------------------------------------- | ---- | ----------------------- | 82| elementName | [ElementName](js-apis-bundle-ElementName.md) | Yes | **ElementName**. | 83 84**Return value** 85 86| Type | Description | 87| ------------------------------------------------------------ | --------------------------------- | 88| Promise\<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo-sys.md)> | Promise used to return the remote ability information. | 89 90## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup> 91 92> This API is deprecated since API version 9. You are advised to use [getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager-sys.md) instead. 93 94getRemoteAbilityInfos(elementNames: Array<ElementName>, callback: AsyncCallback<Array<RemoteAbilityInfo>>): void 95 96Obtains information about remote abilities that match the given element names. This API uses an asynchronous callback to return the result. 97 98**Required permissions** 99 100ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 101 102**System capability** 103 104SystemCapability.BundleManager.DistributedBundleFramework 105 106**System API** 107 108This is a system API. 109 110**Parameters** 111 112| Name | Type | Mandatory | Description | 113| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- | 114| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | Yes | **ElementName** array, whose maximum length is 10. | 115| callback | AsyncCallback< Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo-sys.md)>> | Yes | Callback used to return an array of the remote ability information. | 116 117 118 119## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup> 120 121> This API is deprecated since API version 9. You are advised to use [getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager-sys.md) instead. 122 123getRemoteAbilityInfos(elementNames: Array<ElementName>): Promise<Array<RemoteAbilityInfo>> 124 125Obtains information about remote abilities that match the given element names. This API uses a promise to return the result. 126 127**Required permissions** 128 129ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 130 131**System capability** 132 133SystemCapability.BundleManager.DistributedBundleFramework 134 135**System API** 136 137This is a system API. 138 139**Parameters** 140 141| Name | Type | Mandatory | Description | 142| ------------ | --------------------------------------------------- | ---- | ----------------------- | 143| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | Yes | **ElementName** array, whose maximum length is 10. | 144 145**Return value** 146 147| Type | Description | 148| ------------------------------------------------------------ | --------------------------------- | 149| Promise\<Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo-sys.md)>> | Promise used to return the remote ability information. | 150