HarmonyOS 鸿蒙Next ArkTS语言教程入门学习第60天,创建,启动,连接ServiceAbility。

发布于 1周前 作者 vueper 来自 鸿蒙OS

HarmonyOS 鸿蒙Next ArkTS语言教程入门学习第60天,创建,启动,连接ServiceAbility。

1、DataAbility组件概述

DataAbility,即"使用Data模板的Ability",主要用于对外部提供统一的数据访问抽象,不提供用户交互界面。DataAbility可由PageAbility、ServiceAbility或其他应用启动,即使用户切换到其他应用,DataAbility仍将在后台继续运行。

使用DataAbility有助于应用管理其自身和其他应用存储数据的访问,并提供与其他应用共享数据的方法。DataAbility既可用于同设备不同应用的数据共享,也支持跨设备不同应用的数据共享。

数据的存放形式多样,可以是数据库,也可以是磁盘上的文件。DataAbility对外提供对数据的增、删、改、查,以及打开文件等接口,这些接口的具体实现由开发者提供。

2、DataAbility组件配置

2.1、URI介绍

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

HarmonyOS的URI仍基于URI通用标准,格式如下:

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:“后面有三个”/"。

2.2、部分配置项介绍

与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对象内部结构

3、DataAbility的生命周期

应用开发者可以根据业务场景重写生命周期相关接口。DataAbility生命周期接口说明见下表。

表1 DataAbility相关生命周期API功能介绍

接口名 描述
onInitialized?(info: AbilityInfo): void 在Ability初始化调用,通过此回调方法执行RDB等初始化操作。
update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void 更新数据库中的数据。
query?(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void 查询数据库中的数据。
delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<number>): void 删除一条或多条数据。
normalizeUri?(uri: string, callback: AsyncCallback<string>): void 对URI进行规范化。一个规范化的URI可以支持跨设备使用、持久化、备份和还原等,当上下文改变时仍然可以引用到相同的数据项。
batchInsert?(uri: string, valueBuckets: Array<rdb.ValuesBucket>, callback: AsyncCallback<number>): void 向数据库中插入多条数据。
denormalizeUri?(uri: string, callback: AsyncCallback<string>): void 将一个由normalizeUri生产的规范化URI转换成非规范化的URI。
insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback<number>): void 向数据中插入一条数据。
openFile?(uri: string, mode: string, callback: AsyncCallback<number>): void 打开一个文件。
getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback<Array<string>>): void 获取文件的MIME类型。
getType?(uri: string, callback: AsyncCallback<string>): void 获取URI指定数据相匹配的MIME类型。
executeBatch?(ops: Array<DataAbilityOperation>, callback: AsyncCallback<Array<DataAbilityResult>>): void 批量操作数据库中的数据。
call?(method: string, arg: string, extras: PacMap, callback: AsyncCallback<PacMap>): void 自定义方法。

更多关于HarmonyOS 鸿蒙Next ArkTS语言教程入门学习第60天,创建,启动,连接ServiceAbility。的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

在HarmonyOS中,ServiceAbility是一种后台服务组件,用于执行长时间运行的任务或处理跨应用的数据交互。以下是创建、启动和连接ServiceAbility的基本步骤:

  1. 创建ServiceAbility

    • src/main/ets目录下新建一个ServiceAbility文件夹。
    • ServiceAbility文件夹中创建一个ServiceAbility.ts文件。
    • ServiceAbility.ts中定义ServiceAbility类,继承自ServiceExtensionAbility,并实现onCreateonRequest等方法。
    import ServiceExtensionAbility from '[@ohos](/user/ohos).app.ability.ServiceExtensionAbility';
    
    export default class MyServiceAbility extends ServiceExtensionAbility {
        onCreate(want) {
            console.log('ServiceAbility onCreate');
        }
    
        onRequest(want, startId) {
            console.log('ServiceAbility onRequest');
        }
    
        onDestroy() {
            console.log('ServiceAbility onDestroy');
        }
    }
  2. 配置ServiceAbility

    • config.json文件中注册ServiceAbility,确保typeservice
    {
        "module": {
            "abilities": [
                {
                    "name": ".MyServiceAbility",
                    "type": "service",
                    "visible": true
                }
            ]
        }
    }
  3. 启动ServiceAbility

    • 在需要启动ServiceAbility的地方,使用featureAbility.startAbility方法启动服务。
    import featureAbility from '[@ohos](/user/ohos).ability.featureAbility';
    
    let want = {
        bundleName: 'com.example.myapp',
        abilityName: 'MyServiceAbility'
    };
    
    featureAbility.startAbility(want).then(() => {
        console.log('ServiceAbility started');
    }).catch((error) => {
        console.error('Failed to start ServiceAbility', error);
    });
  4. 连接ServiceAbility

    • 使用featureAbility.connectAbility方法连接ServiceAbility,并实现IAbilityConnection接口处理连接状态。
    import featureAbility from '[@ohos](/user/ohos).ability.featureAbility';
    
    let want = {
        bundleName: 'com.example.myapp',
        abilityName: 'MyServiceAbility'
    };
    
    let connection = {
        onConnect: (elementName, remote) => {
            console.log('ServiceAbility connected');
        },
        onDisconnect: (elementName) => {
            console.log('ServiceAbility disconnected');
        },
        onFailed: (code) => {
            console.error('ServiceAbility connection failed', code);
        }
    };
    
    featureAbility.connectAbility(want, connection);

通过以上步骤,你可以在HarmonyOS中创建、启动和连接ServiceAbility,实现后台服务的功能。

更多关于HarmonyOS 鸿蒙Next ArkTS语言教程入门学习第60天,创建,启动,连接ServiceAbility。的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在HarmonyOS鸿蒙Next中,使用ArkTS语言创建、启动和连接ServiceAbility的步骤如下:

  1. 创建ServiceAbility:在src/main/ets目录下新建一个ServiceAbility文件,如MyServiceAbility.ts,并继承ServiceAbility类,实现onStartonCommand方法。

  2. 启动ServiceAbility:在需要启动ServiceAbility的地方,使用featureAbility.startAbility方法,传入want对象,指定bundleNameabilityName

  3. 连接ServiceAbility:使用featureAbility.connectAbility方法,传入want对象和ServiceConnection回调,处理连接成功、失败或断开的事件。

通过这些步骤,你可以在鸿蒙系统中实现ServiceAbility的创建、启动和连接。

回到顶部
AI 助手
你好,我是IT营的 AI 助手
您可以尝试点击下方的快捷入口开启体验!