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