• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# DataAbility组件配置
2
3
4## URI介绍
5
6DataAbility的提供方和使用方都通过URI（Uniform Resource Identifier）来标识一个具体的数据，例如数据库中的某个表或磁盘上的某个文件。OpenHarmony的URI仍基于URI通用标准，格式如下：
7
8![fa-dataability-uri](figures/fa-dataability-uri.png)
9
10- scheme：协议方案名，固定为"dataability"，代表Data Ability所使用的协议类型。
11
12- authority：设备ID。如果为跨设备场景，则为目标设备的ID；如果为本地设备场景，则不需要填写。
13
14- path：资源的路径信息，代表特定资源的位置信息。
15
16- query：查询参数。
17
18- fragment：可以用于指示要访问的子资源。
19
20URI示例：
21
22- 跨设备场景：dataability://_device_id_/_com.domainname.dataability.persondata_/_person_/_10_
23
24- 本地设备：dataability:///_com.domainname.dataability.persondata_/_person_/_1_
25
26> **说明：**
27> 本地设备的"device_id"字段为空，因此在"dataability:"后面有三个"/"。
28
29
30## 部分配置项介绍
31
32与PageAbility类似，DataAbility的相关配置在config.json配置文件的"module"对象的"abilities"对象中，与PageAbility的区别在于"type"属性及"uri"属性。
33
34  **表1** DataAbility的部分配置项说明
35
36| Json重要字段 | 备注说明 |
37| -------- | -------- |
38| "name" | Ability名称。 |
39| "type" | UIAbility类型，DataAbility的类型为"data"。 |
40| "uri" | 通信使用的URI。 |
41| "visible" | 对其他应用是否可见，设置为true时，DataAbility才能与其他应用进行通信传输数据。 |
42
43config.json配置样例
44
45
46```json
47"abilities": [{
48  "srcPath": "DataAbility",
49  "name": ".DataAbility",
50  "icon": "$media:icon",
51  "srcLanguage": "ets",
52  "description": "$string:description_dataability",
53  "type": "data",
54  "visible": true,
55  "uri": "dataability://ohos.samples.etsdataability.DataAbility"
56}]
57```
58
59DataAbility支持的配置项及详细说明详见[module对象内部结构](../quick-start/module-structure.md)。
60