• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# **分布式包管理服务(DBMS)**
2
3## 简介
4
5分布式包管理服务负责管理跨设备的组件调度和任务管理，实现跨设备RPC的能力，可以按需获取跨设备指定语言的资源。
6
7## 目录
8
9```
10foundation/bundlemanager/distributed_bundle_framework
11├── interfaces
12│   ├── inner_api                 # 内部接口存放目录
13│   └── kits/js                   # JS应用接口
14│       ├── distributebundlemgr
15│       └── distributedBundle
16├── services/dbms                 # dbms服务框架代码
17└── services/dbms/test	          # 测试目录
18```
19
20## 说明
21### 获取远程设备AbilityInfo信息
22getRemoteAbilityInfo获取由elementName指定的远程设备上的应用的AbilityInfo信息(callback形式)
23
24* **参数：**
25
26  | 参数名      | 类型                                                         | 必填 | 说明                                                         |
27  | ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
28  | elementName | [ElementName](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md) | 是   | ElementName信息。                                            |
29  | callback    | AsyncCallback<[RemoteAbilityInfo](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-bundleManager-remoteAbilityInfo.md)> | 是   | 回调函数，调用成功返回err为null，data为RemoteAbilityInfo对象；调用失败err为错误对象, data为undefined。 |
30
31* **错误码：**
32
33  以下错误码的详细介绍请参见[ohos.bundle错误码](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/errorcodes/errorcode-bundle.md)。
34
35  | 错误码ID | 错误信息                                 |
36  | -------- | ---------------------------------------- |
37  | 17700001 | The specified bundle name is not found.  |
38  | 17700003 | The specified ability name is not found. |
39  | 17700007 | The specified device ID is not found.    |
40  | 17700027 | The distributed service is not running.  |
41
42* **示例：**
43
44```ts
45  try {
46      distributedBundle.getRemoteAbilityInfo(
47          {
48              deviceId: '1',
49              bundleName: 'com.example.application',
50              abilityName: 'EntryAbility'
51          }, (err, data) => {
52            if (err) {
53              console.log(`Operation failed: error code is ${err.code}  and error message is ${err.message}`);
54            } else {
55              console.info('Operation succeed:' + JSON.stringify(data));
56            }
57          });
58  } catch (err) {
59      console.log(`Operation failed: error code is ${err.code}  and error message is ${err.message}`);
60  }
61  ```
62
63* **指南：**
64
65  更多开发指导可参考[**示例文档**](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-distributedBundleManager.md)
66
67## 相关仓
68
69[bundlemanager_bundle_framework](https://gitee.com/openharmony/bundlemanager_bundle_framework)
70