ServiceAbility，即"基于Service模板的Ability"，主要用于后台运行任务（如执行音乐播放、文件下载等），不提供用户交互界面。ServiceAbility可由其他应用或PageAbility启动，即使用户切换到其他应用，ServiceAbility仍将在后台继续运行。
ServiceAbility组件配置
与PageAbility类似，ServiceAbility的相关配置在config.json配置文件的"module"对象的"abilities"对象中，与PageAbility的区别在于"type"属性及"backgroundModes"属性。
表1 ServiceAbility部分配置项说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
|---|---|---|---|
| type | 表示Ability的类型。取值为"service"时表示该Ability是基于Service模板开发的Ability。 | 字符串 | 否 |
| backgroundModes | 表示后台服务的类型，可以为一个服务配置多个后台服务类型。该标签仅适用于service类型的Ability。取值范围如下： dataTransfer：通过网络/对端设备进行数据下载、备份、分享、传输等业务。 audioPlayback：音频输出业务。 audioRecording：音频输入业务。 pictureInPicture：画中画、小窗口播放视频业务。 voip：音视频电话、VOIP业务。 location：定位、导航业务。 bluetoothInteraction：蓝牙扫描、连接、传输业务。 wifiInteraction：WLAN扫描、连接、传输业务。 screenFetch：录屏、截屏业务。 multiDeviceConnection：多设备互联业务。 | 字符串数组 | 可缺省，缺省值为空。 |
ServiceAbility支持的配置项及详细说明详见 odule对象内部结构 。
ServiceAbility的生命周期
开发者可以根据业务场景实现service.js/service.ets中的生命周期相关接口。ServiceAbility生命周期接口说明见下表。
表1 ServiceAbility生命周期接口说明
| 接口名 | 描述 |
|---|---|
| onStart(): void | 该方法在创建ServiceAbility的时候调用，用于Service的初始化，在ServiceAbility的整个生命周期只会调用一次。 |
| onCommand(want: Want, startId: number): void | 在Service创建完成之后调用，该方法在客户端每次启动该Service时都会调用，开发者可以在该方法中做一些调用统计、初始化类的操作。 |
| onConnect(want: Want): rpc.RemoteObject | 在连接ServiceAbility时调用。 |
| onDisconnect(want: Want): void | 在与已连接的ServiceAbility断开连接时调用。 |
| onStop(): void | 在ServiceAbility销毁时调用。开发者应通过实现此方法来清理资源，如关闭线程、注册的侦听器等。 |
创建ServiceAbility
- 创建ServiceAbility。
通过DevEco Studio开发平台创建ServiceAbility时，DevEco Studio会默认生成onStart、onStop、onCommand方法，其他方法需要开发者自行实现，接口说明参见前述章节。开发者也可以添加其他Ability请求与ServiceAbility交互时的处理方法，示例如下：
import { Want } from '@kit.AbilityKit';
import { rpc } from '@kit.IPCKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const TAG: string = '[Sample_FAModelAbilityDevelop]';
const domain: number = 0xFF00;
class FirstServiceAbilityStub extends rpc.RemoteObject {
constructor(des: Object) {
if (typeof des === 'string') {
super(des);
} else {
return;
}
}
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption): boolean {
hilog.info(domain, TAG, 'ServiceAbility onRemoteRequest called');
if (code === 1) {
let string = data.readString();
hilog.info(domain, TAG, `ServiceAbility string=${string}`);
let result = Array.from(string).sort().join('');
hilog.info(domain, TAG, `ServiceAbility result=${result}`);
reply.writeString(result);
} else {
hilog.info(domain, TAG, 'ServiceAbility unknown request code');
}
return true;
}
}
class ServiceAbility {
onStart(): void {
hilog.info(domain, TAG, 'ServiceAbility onStart');
}
onStop(): void {
hilog.info(domain, TAG, 'ServiceAbility onStop');
}
onCommand(want: Want, startId: number): void {
hilog.info(domain, TAG, 'ServiceAbility onCommand');
}
onConnect(want: Want): rpc.RemoteObject {
hilog.info(domain, TAG, 'ServiceAbility onDisconnect' + want);
return new FirstServiceAbilityStub('test');
}
onDisconnect(want: Want): void {
hilog.info(domain, TAG, 'ServiceAbility onDisconnect' + want);
}
}
export default new ServiceAbility();
- 注册ServiceAbility。
ServiceAbility需要在应用配置文件config.json中进行注册，注册类型type需要设置为service。"visible"属性表示ServiceAbility是否可以被其他应用调用，true表示可以被其他应用调用，false表示不能被其他应用调用（仅应用内可以调用）。若ServiceAbility需要被其他应用调用，注册ServiceAbility时需要设置"visible"为true，同时需要设置支持关联启动。ServiceAbility的启动规则详见 组件启动规则 章节。
{
...
"module": {
...
"abilities": [
...
{
"name": ".ServiceAbility",
"srcLanguage": "ets",
"srcPath": "ServiceAbility",
"icon": "$media:icon",
"description": "$string:ServiceAbility_desc",
"type": "service",
"visible": true
},
...
]
...
}
}
启动ServiceAbility
ServiceAbility的启动与其他Ability并无区别，应用开发者可以在PageAbility中通过featureAbility的startAbility接口拉起ServiceAbility，在ServiceAbility中通过particleAbility的startAbility接口拉起ServiceAbility。ServiceAbility的启动规则详见 组件启动规则 章节。
如下示例展示了在PageAbility中通过startAbility启动bundleName为"com.example.myapplication"，abilityName为"ServiceAbility"的ServiceAbility的方法。启动FA模型的ServiceAbility时，需要在abilityName前拼接bundleName字符串。
import featureAbility from '@ohos.ability.featureAbility'
import Want from '@ohos.app.ability.Want';
import promptAction from '@ohos.promptAction';
import hilog from '@ohos.hilog';
const LOG_DOMAIN: number = 0x0000;
const LOG_TAG: string = 'startServiceAbility';
const startServiceAbility = async () => {
try {
hilog.info(LOG_DOMAIN, LOG_TAG, 'Begin to start ability');
let want: Want = {
bundleName: 'com.samples.famodelabilitydevelop',
abilityName: 'com.samples.famodelabilitydevelop.ServiceAbility'
};
await featureAbility.startAbility({ want });
promptAction.showToast({
message: 'start service success'
});
hilog.info(LOG_DOMAIN, LOG_TAG, 'Start ability succeed');
} catch (error) {
hilog.info(LOG_DOMAIN, LOG_TAG, 'Start ability failed with ' + error);
}
}
执行上述代码后，Ability将通过 startAbility() 方法来启动ServiceAbility。
-
如果ServiceAbility尚未运行，则系统会先调用onStart()来初始化ServiceAbility，再回调Service的onCommand()方法来启动ServiceAbility。
-
如果ServiceAbility正在运行，则系统会直接回调ServiceAbility的onCommand()方法来启动ServiceAbility。
连接ServiceAbility
如果ServiceAbility需要与PageAbility或其他应用的ServiceAbility进行交互，则须创建用于连接的Connection。ServiceAbility支持其他Ability通过connectAbility()方法与其进行连接。PageAbility的 connectAbility() 方法定义在 featureAbility 中，ServiceAbility的 connectAbility() 方法定义在 particleAbility 中。连接ServiceAbility的规则详见 组件启动规则 章节。在使用connectAbility()处理回调时，需要传入目标Service的 Want 与 IAbilityConnection 的实例。 IAbilityConnection 提供了以下方法供开发者实现。
表1 IAbilityConnection接口说明
| 接口名 | 描述 |
|---|---|
| onConnect() | 用于处理连接Service成功的回调。 |
| onDisconnect() | 用来处理Service异常死亡的回调。 |
| onFailed() | 用来处理连接Service失败的回调。 |
PageAbility创建连接本地ServiceAbility回调实例的代码以及连接本地ServiceAbility的示例代码如下：
import featureAbility from '@ohos.ability.featureAbility';
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';
import promptAction from '@ohos.promptAction';
import rpc from '@ohos.rpc';
import hilog from '@ohos.hilog';
const LOG_TAG: string = '[Sample_FAModelAbilityDevelop]';
const LOG_DOMAIN: number = 0xFF00;
let option: common.ConnectOptions = {
onConnect: (element, proxy) => {
hilog.info(LOG_DOMAIN, LOG_TAG, 'onConnectLocalService onConnectDone element:' + JSON.stringify(element));
if (proxy === null) {
promptAction.showToast({
message: 'connect service failed'
});
return;
}
let data = rpc.MessageParcel.create();
let reply = rpc.MessageParcel.create();
let option = new rpc.MessageOption();
data.writeInterfaceToken('connect.test.token');
proxy.sendRequest(0, data, reply, option);
promptAction.showToast({
message: 'connect service success'
});
},
onDisconnect: (element) => {
hilog.info(LOG_DOMAIN, LOG_TAG, `onConnectLocalService onDisconnectDone element:${element}`);
promptAction.showToast({
message: 'disconnect service success'
});
},
onFailed: (code) => {
hilog.info(LOG_DOMAIN, LOG_TAG, `onConnectLocalService onFailed errCode:${code}`);
promptAction.showToast({
message: 'connect service failed'
});
}
};
let request: Want = {
bundleName: 'com.samples.famodelabilitydevelop',
abilityName: 'com.samples.famodelabilitydevelop.ServiceAbility',
};
let connId = featureAbility.connectAbility(request, option);
hilog.info(LOG_DOMAIN, LOG_TAG, `connectAbility id:${connId}`);
同时，Service侧也需要在onConnect()时返回IRemoteObject，从而定义与Service进行通信的接口。onConnect()需要返回一个IRemoteObject对象。系统提供了IRemoteObject的默认实现，开发者可以通过继承rpc.RemoteObject来创建自定义的实现类。
Service侧把自身的实例返回给调用侧的示例代码如下：
import type Want from '@ohos.app.ability.Want';
import rpc from '@ohos.rpc';
import hilog from '@ohos.hilog';
const TAG: string = '[Sample_FAModelAbilityDevelop]';
const domain: number = 0xFF00;
class FirstServiceAbilityStub extends rpc.RemoteObject {
constructor(des: Object) {
if (typeof des === 'string') {
super(des);
} else {
return;
}
}
onRemoteRequest(code: number, data: rpc.MessageParcel, reply: rpc.MessageParcel, option: rpc.MessageOption): boolean {
hilog.info(domain, TAG, 'ServiceAbility onRemoteRequest called');
if (code === 1) {
let string = data.readString();
hilog.info(domain, TAG, `ServiceAbility string=${string}`);
let result = Array.from(string).sort().join('');
hilog.info(domain, TAG, `ServiceAbility result=${result}`);
reply.writeString(result);
} else {
hilog.info(domain, TAG, 'ServiceAbility unknown request code');
}
return true;
}
}
//...
鸿蒙全栈开发全新学习指南
为了积极培养鸿蒙生态人才，让大家都能学习到鸿蒙开发最新的技术，针对一些在职人员、0基础小白、应届生/计算机专业、鸿蒙爱好者等人群，整理了一套纯血版鸿蒙（HarmonyOS Next）全栈开发技术的学习路线【包含了大厂APP实战项目开发】。
本路线共分为四个阶段：
第一阶段：鸿蒙初中级开发必备技能
第二阶段：鸿蒙南北双向高工技能基础：gitee.com/MNxiaona/733GH
第三阶段：应用开发中高级就业技术
第四阶段：全网首发-工业级南向设备开发就业技术：gitee.com/MNxiaona/733GH
鸿蒙开发面试真题（含参考答案）:gitee.com/MNxiaona/733GH
写在最后
- 如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
- 点赞，转发，有你们的 『点赞和评论』，才是我创造的动力。
- 关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
- 想要获取更多完整鸿蒙最新学习资源，请移步前往小编：
gitee.com/MNxiaona/733GH
957
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
