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