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