您当前的位置:首页 > 电脑百科 > 程序开发 > 移动端 > 鸿蒙

OpenHarmony系统之Service代码一键生成工具介绍

时间:2023-05-31 13:53:20  来源:  作者:深开鸿Kaihong

作者:苟晶晶

前言

当开发者为OpenHarmony系统框架开发某些功能时,有时需要将这个功能包装成一个独立的服务进程运行在系统中,为了其它应用进程能够调用此服务,开发人员需要基于系统IPC通信框架编写一套远程接口调用实现。实现Service远程调用接口需要开发人员熟悉IPC通信框架,了解proxy/stub的继承与实现方式,掌握C++类型转为MessageParcel数据包的各种API方法,有一定的学习成本。而Service代码生成工具能够帮助使用者生成框架代码,提升开发效率。用户只需提供一个定义远程方法的.h头文件,工具会自动生成整个Service框架的代码,包含Ability注册、proxy/stub类实现、MessageParcel数据包构造、Service子系统编译及开机自启动相关配置文件。

1.工具原理

Service框架代码生成工具包含工具入口、工具框架、公共模块、运行环境、系统平台。其中,工具入口描述调用Service框架代码生成工具的入口方式,支持命令行调用、VS Code插件(即VS插件)调用,从而可以根据开发环境的不同,采用相对应的调用Service框架代码生成工具的入口方式,实现Service框架代码生成工具的入口多样性,便于调用Service框架代码生成工具。工具框架包含C语法解析器、代码生成器两部分,C语法解析器支持包括但不限于对class、function、properties、parameter等内容的解析,代码生成器支持包括但不限于对proxy、stub、service、interface等服务框架代码的生成。公共模块描述通用的、在不同部分均会使用的公共接口与模块,可以包括通用的正则校验、类型映射、代码模板、文件操作等模块,运行环境描述Service框架代码生成工具运行的环境,包括Nodejs与Python/ target=_blank class=infotextkey>Python,由于Nodejs本身具有跨平台性特点,故Service框架代码生成工具可以在windowslinuxmac、OpenHarmony等不同系统平台灵活使用,Service框架代码生成工具的运行环境另一部分是python,针对不同平台做python适配,Service框架代码生成工具即可实现跨平台使用。

架构

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

2.使用说明

环境

visual studio code 版本需1.62.0及以上。

步骤

1、 打开VS Code,在左侧边栏中选择插件安装。

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

2、 在应用商店搜索service-gen插件,再单击安装。

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

3、 安装完成后就会在VS Code的插件管理器中能看到service-gen这个插件了。

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

4、 在VS Code中找到需要转换的.h文件,待转换的.h文件内容如下所示:

#ifndef TEST_H
#define TEST_H

namespace OHOS {
    namespace Example {
    /**
     * @brief service服务,提供IPC调用接口
     * @ServiceClass
     */
        class test {
        public:
            int testFunc(int v1, int v2, bool v3);
        };
    }  // namespace Example
}  // namespace OHOS
#endif  // TEST_H

5、 右键单击.h文件,选择“ Service Generate Frame”选项。
OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

6、 工具打开 Service Generate Frame窗口,.h文件选择框默认填写被操作的.h文件的绝对路径;输出路径选择框默认填写.h文件所在文件夹路径,可修改为任意路径;serviceID范围是1-16777215之间的整数,超出范围会提示错误,填入正确的serviceID,然后点击ok。

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

7、 转换成功后,在输出路径下生成service框架代码文件。

输出文件说明

service工具生成文件说明如下图所示:

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

其中消息调用流程为:

  1. 服务端实现SystemAbility接口OnStart(),将自己的serviceId注册到SystemAbility Manager管理类。
  2. 客户端根据serviceId向SystemAbility Manager管理类获取该service的proxy对象。
  3. 客户端使用proxy对象调用服务端的远程接口。
  4. proxy将客户端传入的c++参数打包成消息数据,通过系统提供的dbinder进程间通信能力发送到服务端进程。
  5. 服务端OnRemoteRequest()接收到远程调用消息,根据消息id分发给不同的innerFunction()处理。
  6. 服务端innerFunction()将远程消息数据包还原成C/C++参数,传入业务入口方法供业务开发人员处理。

3.集成说明

本集成说明针对的是OpenHarmony 3.2release系统,其他系统可能存在差别,开发者可自行调试修改。

修改编译文件

  1. 修改testservice/BUILD.gn文件,将utils/native 改为 commonlibrary/c_utils,将samgr_standard改为samgr。修改后的BUILD.gn文件内容如下所示:

    import("//build/ohos.gni")
    
    ohos_shared_library("testservice") {
      sources = [
        "//testservice/src/i_test_service.cpp",
        "//testservice/src/test_service_stub.cpp",
        "//testservice/src/test_service.cpp"
      ]
      include_dirs = [
        "//testservice/include",
        "//testservice/interface",
        "//commonlibrary/c_utils/base/include"
      ]
    
      deps = [
        "//base/startup/syspara_lite/interfaces/innerkits/native/syspara:syspara",
        "//commonlibrary/c_utils/base:utils",
      ]
    
      external_deps = [
        "hiviewdfx_hilog_native:libhilog",
        "ipc:ipc_core",
        "safwk:system_ability_fwk",
        "samgr:samgr_proxy",
        "startup_l2:syspara",
      ]
    
      part_name = "testservice_part"
      subsystem_name = "testservice"
    }
    
    ohos_executable("testclient") {
        sources = [
        "//testservice/src/i_test_service.cpp",
        "//testservice/src/test_service_proxy.cpp",
        "//testservice/src/test_client.cpp"
      ]
    
      include_dirs = [
        "//testservice/include",
        "//testservice/interface",
        "//commonlibrary/c_utils/base/include"
      ]
    
      deps = [
        "//commonlibrary/c_utils/base:utils",
      ]
    
      external_deps = [
        "hiviewdfx_hilog_native:libhilog",
        "ipc:ipc_core",
        "samgr:samgr_proxy",
      ]
    
      part_name = "testservice_part"
      subsystem_name = "testservice"
    }
    
  2. 修改testservice/bundle.json文件,将"name": “@ohos/testservice"修改为 “name”: “@ohos/testservice_part”;将"samgr_standard"改为"samgr”,“utils_base"修改为"c_utils”;修改的bundle.json文件内容如下所示:

    {
        "name": "@ohos/testservice_part",
        "description": "system ability framework test",
        "homePage": "https://gitee.com/",
        "version": "3.1",
        "license": "Apache License 2.0",
        "repository": "",
        "publishAs": "code-segment",
        "segment": {
            "destPath": "testservice"
        },
        "dirs": {},
        "scripts": {},
        "component": {
            "name": "testservice_part",
            "subsystem": "testservice",
            "adapted_system_type": [
                "standard"
            ],
            "rom": "2048KB",
            "ram": "~4096KB",
            "deps": {
                "components": [
                    "hiviewdfx_hilog_native",
                    "ipc",
                    "samgr",
                    "c_utils",
                    "safwk",
                    "startup_l2"
                ],
                "third_party": [ "libxml2" ]
            },
            "build": {
                "sub_component": [
                    "//testservice:testservice",
                    "//testservice/sa_profile:testservice_sa_profile",
                    "//testservice:testclient",
                    "//testservice/etc:test_service_init"
                ],
                "inner_kits": [
                ],
                "test": [
                ]
            }
        }
    }
    

修改系统公共文件

基本配置

  1. 服务配置

    foundation/systemabilitymgr/samgr/interfaces/innerkits/samgr_proxy/include/system_ability_definition.h增加以下两行(ID说明: TEST_SERVICE_ID值与用户指定的ID一致;TEST_SERVICE_ID宏值定义必须为这个,因为代码中使用的就是这个)

    TEST_SERVICE_ID                                = 9016,
    {TEST_SERVICE_ID, "testservice" },
    
  2. 子系统配置

    build/subsystem_config.json

    增加以下内容

    "testservice": {
    "path":"testservice",
    "name": "testservice"
     }
    
  3. 产品配置,如rk3568

    vendor/hihope/rk3568/config.json

    增加以下内容

    {
      "subsystem": "testservice",
      "components": [
        {
          "component": "testservice_part",
          "features": []
        }
      ]
    }
    

    注意:若用户需要配置selinux相关配置,则将开关改为true,再根据自身需求进行相关配置

selinux安全配置

  1. testservice/etc/sample_service.cfg

    "secon" : "u:r:testservice:s0"
    
  2. base/security/selinux/sepolicy/base/public/service_contexts

    9016                 u:object_r:sa_testservice:s0
    
  3. base/security/selinux/sepolicy/base/public/service.te

    type sa_testservice, sa_service_attr;
    

4.示例演示

服务端修改

test_service.cpp
在testservice/src/test_service.cpp注释“// TODO: Invoke the business implementation”处添加各个接口的服务端实现代码。本例实现一个简单的加减法,服务端代码如下所示:

int testService::testFunc(int v1, int v2, bool v3)
{
    // TODO: Invoke the business implementation
    int ret = 0;
    printf("service test begin rn");
    if (v3) {
        printf("service test v3 = truern");
        ret = v1 + v2;
    } else {
        printf("service test v3 = false rn");
        ret = v1 - v2;
    }
    printf("service test end rn");
    return ret;
}
 

远程方法的参数包装已在生成代码test_service_stub.cpp中统一处理,开发人员无需关注

客户端修改

test_client.cpp 为自动生成的客户端样例代码。编译烧录后,会在/system/bin/目录下生成可执行程序test_client
在testservice/src/test_client.cpp的mAIn函数中使用proxy对象进行远程方法调用,参考注释示例。本例实现一个简单的加减法,客户端代码如下所示:

int main(int argc, char *argv[])
{
    printf("---functest begin---rn");
    auto proxy = getRemoteProxy();
    uint32_t result = 0;
    // TODO: Invoke remote method by proxy
    result = proxy->testFunc(8, 5, false);
    printf("result is : %urn", result);
    printf("---functest end---rn");

    IPCSkeleton::JoinWorkThread();
    return 0;
}
 

远程方法的参数包装已在生成代码test_service_proxy.cpp中统一处理,开发人员无需关注

编码完成后,执行镜像编译命令

./build.sh --product-name 产品名
 

若编译rk3568开发板,则执行

./build.sh --product-name rk3568
 

运行

将编译好的镜像烧录到开发板后,使用hdc_std shell登录开发板。
查看服务端进程是否已正常启动

ps -ef | grep testservice
system         682     1 0 08:00:08 ?     00:00:00 testservice_sa  --- 服务进程已正常运行
 

如下图所示:

OpenHarmony系统之Service代码一键生成工具介绍-开源基础软件社区

运行客户端

/system/bin/testclient 
 

运行结果如下所示:

---functest begin---
result is : 3
---functest end---
 

(客户端具体执行哪些远程调用方法请在test_client.cpp的main方法中实现)

总结

service生成工具是一个开源项目,我们欢迎有兴趣的开发者试用该工具,并提出宝贵的改进意见,我们将继续不断优化和完善该工具软件。我们相信,该工具会成为OpenHarmony生态圈中一个有用的补充。



Tags:OpenHarmony   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,不构成投资建议。投资者据此操作,风险自担。如有任何标注错误或版权侵犯请与我们联系,我们将及时更正、删除。
▌相关推荐
OpenHarmony - 基于ArkUI框架实现日历应用
前言对于刚刚接触OpenHarmony应用开发的开发者,最快的入门方式就是开发一个简单的应用,下面记录了一个日历应用的开发过程,通过日历应用的开发,来熟悉基本图形的绘制,ArkUI的组件...【详细内容】
2024-01-16  Search: OpenHarmony  点击:(54)  评论:(0)  加入收藏
OpenHarmony4.0发布:新增4000多个API接口,交互及隐私能力增强
钛媒体App 11月6日消息,以“技术筑生态,智联赢未来”为主题的第二届OpenHarmony技术大会在北京举办,活动中,OpenHarmony 4.0版本正式发布。据介绍,OpenHarmony4.0版本开发套件同...【详细内容】
2023-11-07  Search: OpenHarmony  点击:(139)  评论:(0)  加入收藏
OpenHarmony,奏响中国基础软件的“光辉岁月”
梦想需要多久的时间,多少血和泪,才能慢慢实现?天地间任我展翅高飞,谁说那是天真的预言?《光辉岁月》歌词中的这两个问题,恰好可以送给今天的中国基础软件事业。曾几何时,我们认为中...【详细内容】
2023-11-07  Search: OpenHarmony  点击:(101)  评论:(0)  加入收藏
OpenHarmony:如何使用HDF驱动控制LED灯
一、程序简介该程序是基于OpenHarmony标准系统编写的基础外设类:RGB LED。目前已在凌蒙派-RK3568开发板跑通。详细资料请参考官网:https://gitee.com/Lockzhiner-Electronics/...【详细内容】
2023-09-08  Search: OpenHarmony  点击:(263)  评论:(0)  加入收藏
深入了解华为OpenHarmony开源系统的架构与功能
当下最火的科技圈新闻,莫过于华为即将发布的Mate 60系列手机,但是今天摸鱼君不讲这些,毕竟我也没抢到,我也不是专业测评。但是以我所长说说它搭载鸿蒙系统的一些内容。 鸿蒙系...【详细内容】
2023-09-07  Search: OpenHarmony  点击:(208)  评论:(0)  加入收藏
OpenHarmony中使用MQTT
MQTT**(**消息队列遥测传输)是ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。它工作在TCP/IP协议族上,是为硬件性能低下的远程设备以及网络状况糟糕的情况下而...【详细内容】
2023-08-29  Search: OpenHarmony  点击:(432)  评论:(0)  加入收藏
OpenHarmony组件复用示例
OpenHarmony组件复用示例 摘要:在开发应用时,有些场景下的自定义组件具有相同的组件布局结构,仅有状态变量等承载数据的差异。这样的组件缓存起来,需要使用到该组件时直接复用,...【详细内容】
2023-08-28  Search: OpenHarmony  点击:(352)  评论:(0)  加入收藏
OpenHarmony运行docker详细步骤
本文将介绍如何在OpenHarmony内核上运行docker容器。 目录 1.环境和设备 2.准备支持Docker容器的OpenHarmony内核 3.编译烧录镜像 4.安装docker容器引擎组件 5.格式...【详细内容】
2023-07-28  Search: OpenHarmony  点击:(399)  评论:(0)  加入收藏
OpenHarmony 3.2 Release新特性解读之驱动HCS
HCS(HDF Configuration Source)是HDF驱动框架的配置描述源码,内容以Key-Value为主要形式。它实现了配置代码与驱动代码解耦,便于开发者进行配置管理。OpenAtom OpenHarmony(以下...【详细内容】
2023-06-01  Search: OpenHarmony  点击:(328)  评论:(0)  加入收藏
OpenHarmony系统之Service代码一键生成工具介绍
作者:苟晶晶前言当开发者为OpenHarmony系统框架开发某些功能时,有时需要将这个功能包装成一个独立的服务进程运行在系统中,为了其它应用进程能够调用此服务,开发人员需要基于系...【详细内容】
2023-05-31  Search: OpenHarmony  点击:(287)  评论:(0)  加入收藏
▌简易百科推荐
OpenHarmony - 基于ArkUI框架实现日历应用
前言对于刚刚接触OpenHarmony应用开发的开发者,最快的入门方式就是开发一个简单的应用,下面记录了一个日历应用的开发过程,通过日历应用的开发,来熟悉基本图形的绘制,ArkUI的组件...【详细内容】
2024-01-16    51CTO  Tags:OpenHarmony   点击:(54)  评论:(0)  加入收藏
鸿蒙工程师,熬来了「造富时代」
  作者|张俊  来源|新浪科技  ID|techsina  “套壳安卓”的质疑言犹在耳,如今华为正在计划将鸿蒙OS与安卓完全脱离。  此前,鸿蒙OS为了迅速扩大用户规模,采取了兼容安卓...【详细内容】
2023-11-20    锌财经  Tags:鸿蒙   点击:(213)  评论:(0)  加入收藏
OpenHarmony:如何使用HDF驱动控制LED灯
一、程序简介该程序是基于OpenHarmony标准系统编写的基础外设类:RGB LED。目前已在凌蒙派-RK3568开发板跑通。详细资料请参考官网:https://gitee.com/Lockzhiner-Electronics/...【详细内容】
2023-09-08    51CTO  Tags:OpenHarmony   点击:(263)  评论:(0)  加入收藏
深入了解华为OpenHarmony开源系统的架构与功能
当下最火的科技圈新闻,莫过于华为即将发布的Mate 60系列手机,但是今天摸鱼君不讲这些,毕竟我也没抢到,我也不是专业测评。但是以我所长说说它搭载鸿蒙系统的一些内容。 鸿蒙系...【详细内容】
2023-09-07  摸鱼IT  微信公众号  Tags:OpenHarmony   点击:(208)  评论:(0)  加入收藏
鸿蒙操作系统开发 搭建环境
2019年8月9日,华为在东莞举行华为开发者大会,正式发布鸿蒙操作系统;2020年9月推出了鸿蒙2.0,全面使能全场景生态,具备跨设备、服务流转、极速直达、可视可说、隐私安全五大能力。...【详细内容】
2023-09-07  清华计算机学堂  微信公众号  Tags:鸿蒙   点击:(198)  评论:(0)  加入收藏
OpenHarmony中使用MQTT
MQTT**(**消息队列遥测传输)是ISO 标准(ISO/IEC PRF 20922)下基于发布/订阅范式的消息协议。它工作在TCP/IP协议族上,是为硬件性能低下的远程设备以及网络状况糟糕的情况下而...【详细内容】
2023-08-29    51CTO  Tags:OpenHarmony   点击:(432)  评论:(0)  加入收藏
OpenHarmony组件复用示例
OpenHarmony组件复用示例 摘要:在开发应用时,有些场景下的自定义组件具有相同的组件布局结构,仅有状态变量等承载数据的差异。这样的组件缓存起来,需要使用到该组件时直接复用,...【详细内容】
2023-08-28  zhushangyuan  51CTO  Tags:OpenHarmony   点击:(352)  评论:(0)  加入收藏
HarmonyOS开发第一步,熟知开发工具DevEco Studio
俗话说的好,工欲善其事,必先利其器,走进HarmonyOS第一步,开发工具必须先行,当然了,关于开发工具的使用,官网和其他的博客也有很多的讲解,但是并没有按照常用的功能进行概述,如果需要...【详细内容】
2023-08-22  程序员一鸣  今日头条  Tags:HarmonyOS   点击:(205)  评论:(0)  加入收藏
鸿蒙元服务开发实例:桌面卡片上的电动自行车助手E-Bike
E-Bike是一款基于HarmonyOS开发的元服务,以万能卡片的形式给骑行提供便捷服务。首先需要完成HarmonyOS开发环境搭建。一、元服务E-Bike简介E-Bike是一款基于HarmonyOS开发的...【详细内容】
2023-08-16    51CTO  Tags:鸿蒙   点击:(302)  评论:(0)  加入收藏
OpenHarmony运行docker详细步骤
本文将介绍如何在OpenHarmony内核上运行docker容器。 目录 1.环境和设备 2.准备支持Docker容器的OpenHarmony内核 3.编译烧录镜像 4.安装docker容器引擎组件 5.格式...【详细内容】
2023-07-28  离北况归  51CTO  Tags:OpenHarmony   点击:(399)  评论:(0)  加入收藏
站内最新
站内热门
站内头条