HarmonyOS实战开发：ServiceAbility组件开发

最新推荐文章于 2024-08-22 10:10:06 发布

蜀道衫QAQ

最新推荐文章于 2024-08-22 10:10:06 发布

阅读量623

点赞数 8

分类专栏：鸿蒙文章标签： harmonyos 华为鸿蒙鸿蒙系统 android

本文链接：https://blog.csdn.net/2401_84194030/article/details/138324524

版权

鸿蒙专栏收录该内容

449 篇文章 7 订阅

订阅专栏

创建ServiceAbility

创建ServiceAbility。

重写ServiceAbility的生命周期方法，添加其他Ability请求与ServiceAbility交互时的处理方法。

  import Want from '@ohos.app.ability.Want';
  import rpc from "@ohos.rpc"
  
  class FirstServiceAbilityStub extends rpc.RemoteObject {
    constructor(des: string) {
      super(des);
    }
  }
  
  class ServiceAbility {
    onStart() {
      console.info('ServiceAbility onStart')
    }
    onStop() {
      console.info('ServiceAbility onStop')
    }
    onCommand(want: Want, startId: number) {
      console.info('ServiceAbility onCommand')
    }
    onConnect(want: Want) {
      console.info('ServiceAbility onConnect' + want)
      return new FirstServiceAbilityStub('test')
    }
    onDisconnect(want: Want) {
      console.info('ServiceAbility onDisconnect' + want)
    }
  }

  export default new ServiceAbility()

注册ServiceAbility。

ServiceAbility需要在应用配置文件config.json中进行注册，注册类型类型需要设置为service。“visible”属性表示ServiceAbility是否可以被其他应用调用，true表示可以被其他应用调用，false表示不能被其他应用调用（仅应用内可以调用）。若ServiceAbility需要被其他应用调用，注册ServiceAbility时需要设置“visible”为true，同时需要设置支持关联启动。
```
     {
       "module": {
         "abilities": [
           {
             "name": ".ServiceAbility",
             "srcLanguage": "ets",
             "srcPath": "ServiceAbility",
             "icon": "$media:icon",
             "description": "hap sample empty service",
             "type": "service",
             "visible": true
           }
         ]
       }
     }
```

启动ServiceAbility

ServiceAbility的启动与其他Ability并无区别，应用开发者可以在PageAbility中通过featureAbility的startAbility接口拉起ServiceAbility，在ServiceAbility中通过particleAbility的startAbility接口拉起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';

async function startServiceAbility() {
  try {
    console.info('Begin to start ability')
    let want: Want = {
      bundleName: "com.example.myapplication",
      abilityName: "com.example.myapplication.ServiceAbility"
    }
    await featureAbility.startAbility({want})
    console.info(`Start ability succeed`)
  } catch (error) {
    console.error('Start ability failed with ' + error)
  }
}

执行上述代码后，Ability将通过startAbility（）方法来启动ServiceAbility。

如果ServiceAbility尚未运行，则系统会先调用onStart（）来初始化ServiceAbility，再回调Service的onCommand（）方法来启动ServiceAbility。
如果ServiceAbility正在运行，则系统会直接回调ServiceAbility的onCommand（）方法来启动ServiceAbility。

如果ServiceAbility需要与PageAbility或其他应用的ServiceAbility进行交互，则须创建用于连接的Connection。ServiceAbility支持其他Ability通过connectAbility（）方法与其进行连接。PageAbility的connectAbility方法定义在featureAbility中，ServiceAbility的connectAbility方法定义在particleAbility中。连接ServiceAbility的规则详见组件启动规则章节。在使用connectAbility（）处理回调时，需要传入目标Service的Want与IAbilityConnection的实例。IAbilityConnection提供了以下方法供开发者实现。

表1IAbilityConnection接口说明

接口名	描述
onConnect（）	用于处理连接Service成功的回调。
onDisconnect（）（英语）	用来处理Service异常死亡的回调。
onFailed（）	用来处理连接Service失败的回调。

PageAbility创建连接本地ServiceAbility回调实例的代码以及连接本地ServiceAbility的示例代码如下：

import rpc from "@ohos.rpc"
import promptAction from '@ohos.promptAction'
import featureAbility from '@ohos.ability.featureAbility'
import common from '@ohos.app.ability.common';
import Want from '@ohos.app.ability.Want';

let option: common.ConnectOptions = {
  onConnect: (element, proxy) => {
    console.info(`onConnectLocalService onConnectDone`)
    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) => {
    console.info(`onConnectLocalService onDisconnectDone element:${element}`)
    promptAction.showToast({
      message: "Disconnect service success"
    })
  },
  onFailed: (code) => {
    console.info(`onConnectLocalService onFailed errCode:${code}`)
    promptAction.showToast({
      message: "Connect local service onFailed"
    })
  }
};

let request: Want = {
  bundleName: "com.example.myapplication",
  abilityName: "com.example.myapplication.ServiceAbility",
}
let connId = featureAbility.connectAbility(request, option)

同时，Service侧也需要在onConnect（）时返回IRemoteObject，从而定义与Service进行通信的接口。onConnect（）需要返回一个IRemoteObject对象。系统提供了IRemoteObject的默认实现，开发者可以通过继承rpc.RemoteObject来创建自定义的实现类。

Service侧把自身的实例返回给调用侧的示例代码如下：

import rpc from "@ohos.rpc"

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) {
    console.info(`onRemoteRequest called`)
    if (code === 1) {
      let string = data.readString()
      console.info(`string=${string}`)
      let result = Array.from(string).sort().join('')
      console.info(`result=${result}`)
      reply.writeString(result)
    } else {
      console.info(`unknown request code`)
    }
    return true
  }
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能

HarmonOS就业必备技能
HarmonOS多媒体技术

鸿蒙NaPi组件进阶

HarmonOS高级技能

初识HarmonOS内核
实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料