DataAbility组件配置

URI介绍

DataAbility的提供方和使用方都通过URI（Uniform Resource Identifier）来标识一个具体的数据，例如数据库中的某个表或磁盘上的某个文件。此处的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": [
  ...
  {
    "name": ".DataAbility",
    "srcLanguage": "ets",
    "srcPath": "DataAbility",
    "icon": "$media:icon",
    "description": "$string:DataAbility_desc",
    "type": "data",
    "visible": true,
    "uri": "dataability://com.samples.famodelabilitydevelop.DataAbility",
    "readPermission": "ohos.permission.READ_CONTACTS",
    "writePermission": "ohos.permission.WRITE_CONTACTS"
  },
  ...
]

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