基于Service模板的Ability简称Service,其主要用于后台运行任务,如执行音乐播放、文件下载等,但不提供用户交互界面。Service可由其他应用或Ability启动,即使用户切换到其他应用,Service仍将在后台继续运行。
Service是单实例的。在一个设备上,相同的Service只会存在一个实例。如果多个Ability共用该实例,则只有当与Service绑定的所有Ability都退出后,Service才能退出。由于Service是在主线程里执行的,因此如果在Service中的操作时间过长,开发者必须在Service里创建新的线程来处理,防止造成主线程阻塞,应用程序无响应。
有关线程方面的内容,可以参见第12章相关内容。
接下来介绍如何创建一个Service。
1. 继承Ability
每个Service也都是Ability的子类,需要实现Service相关的生命周期方法。
Ability为Service提供了以下生命周期方法,用户可以重写这些方法来添加自己的处理。
(1)onStart():该方法在创建Service时调用,用于Service的初始化。在Service的整个生命周期只会调用一次onStart()方法,调用时传入的Intent应为空。该方法在前面章节的Page中已经做了介绍。
(2)onCommand():在Service创建完成之后调用,该方法在客户端每次启动该Service时都会调用,用户可以在该方法中做一些调用统计、初始化类的操作。
(3)onConnect ():在Ability和Service连接时调用,该方法返回IRemoteObject对象,用户可以在该回调函数中生成对应Service的IPC通信通道,以便Ability与Service交互。Ability可以多次连接同一个Service,系统会缓存该Service的IPC通信对象,只有第一个客户端连接Service时,系统才会调用Service的onConnect()方法生成IRemoteObject对象,而后系统会将同一个Remote-Object对象传递至其他连接同一个Service的所有客户端,而无须再次调用onConnect()方法。
(4)onDisconnect ():在Ability与绑定的Service断开连接时调用。
(5)onStop():在Service销毁时调用。Service应通过实现此方法来清理任何资源,如关闭线程、注册的侦听器等。该方法在前面章节的Page中已经做了介绍。
创建Service的示例代码如下:
2. 注册Service
Service也需要在应用配置文件中进行注册,注册类型type需要设置为service。配置内容如下:
接下来介绍通过startAbility()方法启动Service以及对应的停止方法。
1. 启动Service
Ability为开发者提供了startAbility()方法来启动另外一个Ability。因为Service也是Ability的一种,开发者同样可以通过将Intent传递给该方法来启动Service。Ability不仅支持启动本地 Ser-vice,还支持启动远程 Service。
开发者可以通过构造包含DeviceId、BundleName与AbilityName的Operation对象来设置目标Service信息,这三个参数的含义如下。
(1)DeviceId:表示设备ID。如果是本地设备,则可以直接留空;如果是远程设备,则可以通过ohos.distributedschedule.interwork.DeviceManager提供的getDeviceList获取设备列表。
(2)BundleName:表示包名称。
(3)AbilityName:表示待启动的Ability名称。
启动本地设备Service的示例代码如下:
启动远程设备Service的代码示例如下:
执行上述代码后,Ability将通过startAbility()方法启动Service。
(1)如果Service尚未运行,则系统会先调用onStart()方法初始化Service,再回调Service的onCommand()方法启动Service。
(2)如果Service正在运行,则系统会直接回调Service的onCommand()方法启动Service。
2. 停止Service
Service一旦创建就会一直保持在后台运行,除非必须回收内存资源,否则系统不会停止或销毁Service。开发者可以在Service中通过terminateAbility()方法停止本Service或在其他Ability调用stopAbility()方法停止Service。
停止Service时同样支持停止本地设备Service和停止远程设备Service,使用方法与启动Ser-vice一样。一旦调用停止Service的方法,系统便会尽快销毁Service。
如果Service需要与Page Ability或其他应用的Service Ability进行交互,则应创建用于连接的Connection。Service支持其他Ability通过connectAbility()方法与其进行连接。
在使用connectAbility()处理回调时,需要传入目标Service的Intent与IAbilityConnection的实例。IAbilityConnection提供了两个方法供开发者实现,其中onAbilityConnectDone()方法用来处理连接的回调,onAbilityDisconnectDone()方法用来处理断开连接的回调。
连接Service的示例代码如下:
同时,Service 侧也需要在 onConnect() 方法中返回 IRemoteObject对象,从而定义与Service进行通信的接口。onConnect()方法需要返回一个IRemoteObject对象,HarmonyOS提供了IRemote-Object的默认实现,用户可以通过继承LocalRemoteObject来创建自定义的实现类。Service侧把自身的实例返回给调用侧的示例代码如下:
与Page类似,Service Ability也拥有生命周期,如图5-15所示。
图5-15 Service Ability生命周期
根据调用方法的不同,其生命周期有以下两种路径。
(1)启动Service:该Service在其他Ability调用startAbility()方法时创建,然后保持运行。其他Ability通过调用stopAbility()方法停止Service,Service停止后,系统会将其销毁。
(2)连接Service:该Service在其他Ability调用connectAbility()方法时创建,客户端可通过调用disconnectAbility ()方法断开连接。多个客户端可以绑定到相同Service,而且当所有绑定全部取消后,系统即会销毁该Service。