1# @ohos.distributedBundle (分布式包管理) 2 3本模块提供分布式包的管理。 4 5> **说明：** 6> 7> 本模块首批接口从API version 8 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11``` 12import distributedBundle from '@ohos.distributedBundle'; 13``` 14 15## 系统能力 16 17SystemCapability.BundleManager.DistributedBundleFramework 18 19## 权限列表 20 21| 权限 | 权限等级 | 描述 | 22| ------------------------------------------ | ------------ | ------------------ | 23| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 | 24 25权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明) 26 27## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup> 28 29> 从API version 9开始不再维护，建议使用[getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager.md)替代。 30 31getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback<RemoteAbilityInfo>): void; 32 33以异步方法根据给定的ElementName获取有关远程设备AbilityInfo信息，使用callback形式返回结果。 34 35**需要权限：** 36 37ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 38 39**系统能力：** 40 41SystemCapability.BundleManager.DistributedBundleFramework 42 43**系统API：** 44 45此接口为系统接口，三方应用不支持调用 46 47**参数：** 48 49| 参数名 | 类型 | 必填 | 说明 | 50| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- | 51| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 获得的ElementName信息。 | 52| callback | AsyncCallback<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)> | 是 | 程序启动作为入参的回调函数，返回远程基本能力信息。 | 53 54 55 56## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup> 57 58> 从API version 9开始不再维护，建议使用[getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager.md)替代。 59 60getRemoteAbilityInfo(elementName: ElementName): Promise<RemoteAbilityInfo> 61 62以异步方法根据给定的ElementName获取有关远程设备AbilityInfo信息，使用Promise形式返回结果。 63 64**需要权限：** 65 66ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 67 68**系统能力：** 69 70SystemCapability.BundleManager.DistributedBundleFramework 71 72**系统API：** 73 74此接口为系统接口，三方应用不支持调用 75 76**参数：** 77 78| 参数名 | 类型 | 必填 | 说明 | 79| ----------- | -------------------------------------------- | ---- | ----------------------- | 80| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 获得的ElementName信息。 | 81 82**返回值：** 83 84| 类型 | 说明 | 85| ------------------------------------------------------------ | --------------------------------- | 86| Promise\<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)> | Promise形式返回远程基本能力信息。 | 87 88## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup> 89 90> 从API version 9开始不再维护，建议使用[getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager.md)替代。 91 92getRemoteAbilityInfos(elementNames: Array<ElementName>, callback: AsyncCallback<Array<RemoteAbilityInfo>>): void; 93 94以异步方法根据给定的ElementName获取有关远程设备AbilityInfos信息，使用callback形式返回结果。 95 96**需要权限：** 97 98ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 99 100**系统能力：** 101 102SystemCapability.BundleManager.DistributedBundleFramework 103 104**系统API：** 105 106此接口为系统接口，三方应用不支持调用 107 108**参数：** 109 110| 参数名 | 类型 | 必填 | 说明 | 111| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- | 112| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息，最大数组长度为10。 | 113| callback | AsyncCallback< Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回远程基本能力信息。 | 114 115 116 117## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup> 118 119> 从API version 9开始不再维护，建议使用[getRemoteAbilityInfo(@ohos.bundle.distributedBundleManager)](js-apis-distributedBundleManager.md)替代。 120 121getRemoteAbilityInfos(elementNames: Array<ElementName>): Promise<Array<RemoteAbilityInfo>> 122 123以异步方法根据给定的ElementName获取有关远程设备AbilityInfos信息，使用Promise形式返回结果。 124 125**需要权限：** 126 127ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 128 129**系统能力：** 130 131SystemCapability.BundleManager.DistributedBundleFramework 132 133**系统API：** 134 135此接口为系统接口，三方应用不支持调用 136 137**参数：** 138 139| 参数名 | 类型 | 必填 | 说明 | 140| ------------ | --------------------------------------------------- | ---- | ----------------------- | 141| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息，最大数组长度为10。 | 142 143**返回值：** 144 145| 类型 | 说明 | 146| ------------------------------------------------------------ | --------------------------------- | 147| Promise\<Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)>> | Promise形式返回远程基本能力信息。 | 148