DataAbility组件配置

URI介绍

DataAbility的提供方和使用方都通过URI(Uniform Resource Identifier)来标识一个具体的数据,例如数据库中的某个表或磁盘上的某个文件。OpenHarmony的URI仍基于URI通用标准,格式如下:

fa-dataability-uri

  • scheme:协议方案名,固定为"dataability",代表Data Ability所使用的协议类型。

  • authority:设备ID。如果为跨设备场景,则为目标设备的ID;如果为本地设备场景,则不需要填写。

  • path:资源的路径信息,代表特定资源的位置信息。

  • query:查询参数。

  • fragment:可以用于指示要访问的子资源。

URI示例:

  • 跨设备场景:dataability://device_id/com.domainname.dataability.persondata/person/10

  • 本地设备:dataability:///com.domainname.dataability.persondata/person/1

说明: 本地设备的"device_id"字段为空,因此在"dataability:"后面有三个"/"。

部分配置项介绍

与PageAbility类似,DataAbility的相关配置在config.json配置文件的"module"对象的"abilities"对象中,与PageAbility的区别在于"type"属性及"uri"属性。

表1 DataAbility的部分配置项说明

Json重要字段 备注说明
"name" Ability名称。
"type" UIAbility类型,DataAbility的类型为"data"。
"uri" 通信使用的URI。
"visible" 对其他应用是否可见,设置为true时,DataAbility才能与其他应用进行通信传输数据。

config.json配置样例

"abilities": [{
  "srcPath": "DataAbility",
  "name": ".DataAbility",
  "icon": "$media:icon",
  "srcLanguage": "ets",
  "description": "$string:description_dataability",
  "type": "data",
  "visible": true,
  "uri": "dataability://ohos.samples.etsdataability.DataAbility"
}]

DataAbility支持的配置项及详细说明详见module对象内部结构