HarmonyOS开发实战:服务进程管理配置

162 篇文章 1 订阅
152 篇文章 2 订阅

 概述

服务管理主要通过init解析服务进程配置文件来实现,服务进程配置文件(xxx.cfg)可以根据业务场景按需配置服务,当前支持的增值服务包括启动控制、按需启动、命令执行、定时启动、fd代持、沙盒。

服务进程配置文件说明

  • 服务进程配置文件名:

    一般命名为:serviceName.cfg(serviceName 为服务进程名,例如:appspawn.cfg)

  • 服务进程配置文件格式:

    配置文件基于JSON格式,遵循JSON文件的基本规则

  • 服务进程配置文件的内容:

    配置文件内容主要包含以下字段,除必配字段外,其他字段根据服务特性选择性配置。

    表1 service配置字段说明
    点击领取→纯血版全套鸿蒙HarmonyOS学习资料(安全链接,放心点击希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取

    字段名配置要求支持系统类型字段说明字段解释
    name必选小型系统和标准系统当前服务的服务名。(必选)类型:字符串; 服务名非空且长度<=32字节。
    path必选小型系统和标准系统当前服务的可执行文件全路径和参数,数组形式。 (必选)确保第一个数组元素为可执行文件路径、数组元素个数<=20。
    每个元素为字符串形式以及每个字符串长度<=64字节。
    uid必选小型系统和标准系统当前服务进程的uid值。类型:int、字符串。
    gid必选小型系统和标准系统当前服务进程的gid值。类型:int、int[]、字符串、字符串数组。
    once可选小型系统和标准系统当前服务进程是否为一次性进程。1:一次性进程,当该进程退出时,init不会重新启动该服务进程。
    0 : 常驻进程,当该进程退出时,init收到SIGCHLD信号并重新启动该服务进程。
    importance可选小型系统和标准系统
    标准系统:当前服务优先级
    小型系统:标记服务重要性

    标准系统中: 服务优先级取值范围 [-20, 19],数值越小优先级越高,超出为无效设置。
    小型系统中:0 : 不重启系统;非0 : 重启系统
    caps可选小型系统和标准系统当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置。类型:数字或者字符串数组,在配置数字时,按linux标准的capability进行配置。字符串时,使用标准定义的宏的名字进行配置。
    critical可选小型系统和标准系统为服务提供抑制机制,服务在配置时间 T 内,频繁重启次数超过设置次数 N 重启系统。
    类型:int[],如:"critical" : [M, N, T],
    其中M:使能标志位(0:不使能;1:使能), N:频繁拉起服务次数, T:时间(单位:秒)。 默认拉起服务次数:4次, 时间:240秒 。
    cpucore可选标准系统服务需要的绑定的CPU核心数类型:int型数组, 如"cpucore" : [N1, N2, ...], N1, N2均为需要绑定的cpu核索引, 如单核设备 cpucore : [0]。
    d-caps可选标准系统服务分布式能力。类型:字符串数组, 如 "d-caps" : ["OHOS_DMS"]。
    apl可选标准系统服务能力特权级别。类型:字符串, 如 "apl" : "system_core"。
    目前支持"system_core"(默认值), "normal", "system_basic"。
    start-mode可选标准系统服务的启动模式。类型:字符串, 如 "start-mode" : "condition"。
    目前支持"boot", "normal", "condition"。具体说明参考:init服务启动控制。
    ondemand可选小型系统和标准系统按需启动服务的标志。类型:bool,如"ondemand" : true,小型系统只在Linux内核上支持。
    具体说明参考:init服务按需启动。
    disable可选小型系统和标准系统预留字段,无实际意义。无。
    sandbox可选标准系统沙盒功能是否打开。1:打开服务的沙盒功能 (默认值)。
    0:关闭服务的沙盒功能。
    socket可选标准系统配置socket属性相关设置由socket创建流程的服务需配置此项
    env可选标准系统配置服务的环境变量类型:键值对型数组
    支持同时配置多个环境变量,如:
    "env" : [{
    "name" : "SERVICE_NALE",
    "value" : "ueventd"},{
    "name" : "TEST",
    "value" : "test_value"
    }]
    period可选标准系统配置服务退出后的定时启动类型:int型,表示定时启动周期, 单位:秒
    使能后,服务退出后,会启动定时器,定时拉起服务,如:"period" : 60,表示服务退出后,60s后定时拉起

    表2 socket字段说明

    字段名说明
    name当前socket的命名,不要求必须与服务同名,与服务名同样须满足非空且长度<=32字节。
    familysocket所属的地址族,目前支持的为服务创建的socket有AF_UNIX和AF_NETLINK族。
    typesocket的类型,目前支持的类型有基于连接的SOCK_SEQPACKET和SOCK_STREAM,还有基于UDP无连接的SOCK_DGRAM。
    protocolsocket通信遵循的协议类型,在无特殊需求的情况下,该值可配置为default缺省值,因为socket接口会自动根据socket地址族和类型选择合适的协议。此处除了default,并且支持NETLINK_KOBJECT_UEVENT协议类型。
    permissionssocket节点文件的权限。此项配置仅对如AF_UNIX地址族等有实体节点文件的socket类型有效。
    uidsocket节点文件的用户ID。此项配置仅对如AF_UNIX地址族等有实体节点文件的socket类型有效。
    gidsocket节点文件的组ID。此项配置仅对如AF_UNIX地址族等有实体节点文件的socket类型有效。
    optionsocket的可选配置。在调用setsockopt接口时传入设置,目前支持的option选项有SOCKET_OPTION_PASSCRED、SOCKET_OPTION_RCVBUFFORCE、SOCK_CLOEXEC和SOCK_NONBLOCK。
    • init服务启动控制(仅标准系统以上提供)

      init会根据用户的服务配置,把服务分成三类,在不同的阶段并行启动。

      • “boot”类型:对应系统中需要优先启动的服务,该类服务在“init”阶段启动。
      • “normal”类型:默认配置,对应系统中的普通服务,该类服务在“post-init"阶段启动。
      • “condition”类型:必须通过启动命令启动,通过在jobs中添加“start xxxx”来启动对应服务。
    • init服务支持命令执行(仅标准系统以上提供)

      init提供服务命令执行能力,在服务执行的不同阶段执行不同的命令。

      • "on-start":在服务进程被fork后在子进程中执行,只对该进程产生影响。
      • "on-stop":在服务停止时执行,在init进程中执行。
      • "on-restart":在服务重启时执行,在init进程中执行。

      参考配置如下:

      "services" : [{
            "name" : "serviceName",
            "path" : ["/system/bin/serviceName"]
            "jobs" : {
                "on-boot" : "boot",
                "on-start" : "services:serviceName_start",
                "on-stop" : "services:serviceName_stop",
                "on-restart" : "services:serviceName_restart"
          }
      },

    通过并行启动和命令执行能力,可以实现进程的并行启动。

    • init按需启动(仅标准系统以上提供)

      配置按需启动后,init进程不会启动对应的服务,只有服务被需要时才会被拉起。通过"ondemand"标记来控制服务是否被拉起。

      “ondemand”参考配置如下:

        "services" : [{
          "name" : "serviceName",
          "path" : ["/system/bin/serviceName"]
          "ondemand" : true
      }]
    • SA进程按需启动

      具体参考 samgr组件(说明3)

    • socket进程按需启动

      1. init进程在pre-fork阶段为socket类进程创建好socket,init进程中监听创建好的socket上的读写事件。
      2. socket上有读写事件后,init进程拉起socket进程对应的native服务,并取消对socket的监听,将socket交由相应的native服务管理。
      3. native服务无报文处理后,可以自动退出。init进程在回收子进程时会根据服务配置重新监听socket。
    • 热插拔服务进程按需启动

      进程可根据系统参数的变化进行热插拔事件按需启动处理。

    • init进程启动&回收能力增强

      进程启动时,支持在配置文件中配置服务进程的绑核、优先级、MAC信息以及AccessToken信息。

      • init提供修改*.cfg配置文件,为服务进程提供CPU绑核功能。
      • init提供修改*.cfg配置文件,为服务进程提供优先级设置。
      • init提供修改*.cfg配置文件,为服务提供MAC信息设置,即服务的SELinux标签(需要selinux支持)。
      • init提供修改*.cfg配置文件,为服务提供设置AccessToken, 为系统服务进程设置其分布式Capability能力(仅标准系统以上提供)。
      • init提供修改*.cfg配置文件,为服务提供抑制机制。

      服务进程启动&回收能力增强配置,如下:

      "services" : [{
          "name" : "serviceName",
          "path" : ["/system/bin/serviceName"]
          "importance" : 1,                  // 服务进程提供优先级设置
          "cpucore" : [0],                   // 服务进程提供CPU绑核功能
          "critical" : [1, 5, 10],           // 服务提供抑制机制
          "apl" : "normal",                  // 系统服务进程设置其分布式Capability能力
          "d-caps" : ["OHOS_DMS"],           // 系统服务进程设置其分布式Capability能力
          "secon" : "u:r:distributedsche:s0" // 服务的SELinux标签, "u:r:distributedsche:s0"为要设置的SELinux标签信息
      }
    • 定时启动

      通过约定时间拉起服务, 若服务已拉起, 则不在重新拉起服务。具体命令参考: begetctl命令说明 。

      timer_start servicename timeout

服务进程创建基本流程

配置服务进程配置文件

服务进程代码编写完成后创建serviceName.cfg(serviceName 为服务进程名),并根据服务特性配置文件内容。

配置文件完成后,需要安装到对应目录,init中在/base/startup/init/services/etc/BUILD.gn文件配置如下:

ohos_prebuilt_etc("watchdog.cfg") {
  source = "//base/startup/init/services/etc/watchdog.cfg"
  relative_install_dir = "init"
  part_name = "init"
  subsystem_name = "startup"
}

ohos_prebuilt_etc("console.cfg") {
  source = "//base/startup/init/services/etc/console.cfg"
  relative_install_dir = "init"
  part_name = "init"
  subsystem_name = "startup"
}

服务进程及其配置文件创建完成后,需要在对应模块的bundle.json文件中添加其build路径,例如:

  "build": {
        "group_type": {
            "base_group": [],
            "fwk_group": [],
            "service_group": [
                "//base/startup/init/ueventd:startup_ueventd",
                "//base/startup/init/services/etc:ueventd.cfg"
            ]
          },
    }

配置服务进程的DAC权限

服务进程的DAC权限通过服务进程配置文件的gid, uid项来设置。

如果新增gid, uid需要在init模块的/init/services/etc/passwd文件和 /init/services/etc/group文件中添加。

  • passwd 文件说明:

  • passwd:每行记录对应一个用户,用户信息以":"作为分隔符,划分七个字段;如

    root:x:0:0:::/bin/false
    bin:x:2:2:::/bin/false
    system:x:1000:1000:::/bin/false

    字段含义

序号字段含义
第一个字段用户名用户名仅是为了方便用户记忆,如root,通过UID来识别用户身份,分配用户权限
第二个字段密码"x"表示此用户设有密码,但不是真正的密码,真正的密码保存在/etc/shadow文件
第三个字段UID用户ID,每个用户有唯一的UID,系统通过UID识别用户身份
UID在0 ~ 65535之间的数,不同范围的数字代表不同的用户身份
1. 0-超级用户,代表管理员账号
2. 1~499代表系统用户
3. >=500代表普通用户
第四个字段GID表示初始组组ID号,指用户登陆时就拥有这个用户组的相关权限。每个用户的初始组只能有一个,通常将和此用户的用户名相同的组名作为该用户的初始组。
第五个字段描述信息表示此用户的意义,多数情况为空。
第六个字段主目录通常称为用户的主(家)目录,如root的主目录为/root,多数情况为空
第七个字段默认shellshell是linux的命令解释器,用户和Linux内核之间沟通的桥梁shell命令解释器用于将用户输入的命令转换成系统可识别的机器语言通常情况下,Linux系统默认使用的命令解释器是/bin/bash
  • group 文件说明:

  • group:每行记录对应一个用户组,用户组信息以":"作为分隔符,划分四个字段;如:

    root:x:0:
    bin:x:2:
    system:x:1000:
    servicectrl:x:1050:root,shell,system,samgr,hdf_devmgr,foundation,update

    字段含义

序号字段含义
第一个字段组名用户组的名称,例如:servicectrl就表示组名为servicectrl
第二个字段组密码标志和/etc/passwd文件一样,这里的“x”仅仅是密码标志,真正的加密之后的组密码保在/etc/gshdow文件中
第三个字段GID通过GID来区别不同的用户组的
第四个字段组中的用户表示的就是这个用户组中到底包含了哪些用户,例如:servicectrl 组的成员有root,shell,system,samgr,hdf_devmgr,foundation,update
  • 若gid,uid设置为root或system,则需要在对应产品目录下的security_config/high_privilege_process_list.json文件种添加白名单,例如:
  {
      "high_privilege_process_list": [
          {
              "name": "appspawn",
              "uid": "root",
              "gid": "root"
          },
          {
              "name": "console",
              "uid": "root"
          },
          {
              "name": "testService",
              "uid": "root",
              "gid": "root"
          },
          {
              "name": "media_service",
              "gid": ["root", "system"]
          },
          {
              "name": "misc",
              "uid": "root",
              "gid": "root"
          } ... ...
      ]
  }

配置进程的SELinux权限

  • 配置服务进程的SELinux权限

    1、首先可以先不配置selinux 标签,确认服务进程是否可以在permissive时可以启动起来,若可以启动,则无需配置。

    2、若需要配置selinux规则,首先要在服务进程的配置文件中通过“secon”项设置selinux 标签

    3、在selinux模块对服务进程的标签进行定义。具体如下:

    在base/security/selinux_adapter/sepolicy/base/system/file_contexts文件定义执行程序的标签,如:

      /system/bin/watchdog_service        u:object_r:watchdog_service_exec:s0
      /system/bin/hdcd        u:object_r:hdcd_exec:s0

    在base/security/selinux_adapter/sepolicy/base/public/type.te文件定义标签的作用域,如:

      type watchdog_service, sadomain, domain;
      type watchdog_service_exec, exec_attr, file_attr, system_file_attr;

系统进程服务错误码说明

错误码说明

枚举枚举值错误信息说明
INIT_OK0执行成功
INIT_EPARAMETER1parameter接口参数无效
INIT_EFORMAT2Format string fail字符串格式化错误
INIT_ECFG3cfg errorcfg解析错误
INIT_EPATH4Invalid path服务path配置错误
INIT_EFORK5Fork failfork子进程失败
INIT_ESANDBOX6Create sandbox fail服务进沙盒失败
INIT_EACCESSTOKEN7Set access token fail设置access token失败
INIT_ESOCKET8Create socket fail创建socket失败
INIT_EFILE9Create file fail创建文件失败
INIT_ECONSOLE10Open console fail打开console失败
INIT_EHOLDER11Publish holder failPublish holder失败
INIT_EBINDCORE12Bind core fail绑核失败
INIT_EKEEPCAP13Set keep capability fail设置keep capability失败
INIT_EGIDSET14Set gid fail设置服务gid失败
INIT_ESECCOMP15Set SECCOMP fail设置服务安全策略
INIT_EUIDSET16Set uid fail设置服务uid失败
INIT_ECAP17Set capability fail设置服务capability失败
INIT_EWRITEPID18Write pid failpid写入失败
INIT_ECONTENT19Set sub content fail设置服务安全上下文失败
INIT_EPRIORITY20Set priority fail设置服务优先级失败
INIT_EEXEC_CONTENT21Set exec content fail设置selinux标签失败
INIT_EEXEC22Exec fail执行exec失败

服务进程配置实例:

服务示例代码展示

服务示例配置展示

接口说明

表3 服务控制接口介绍

函数名函数解释参数解释
int ServiceControlWithExtra(const char *serviceName, int action, const char *extArgv[], int extArgc)配置服务参数返回值:成功返回0,失败返回-1
参数:
serviceName: 服务名
action: 服务行为("start", "stop", "restart")
extArgv: 参数数组
extArgc: 参数个数
int ServiceControl(const char *serviceName, int action)控制服务行为返回值:成功返回0,失败返回-1
参数:
serviceName: 服务名
action: 服务行为("start", "stop", "restart")
int ServiceWaitForStatus(const char *serviceName, ServiceStatus status, int waitTimeout)等待服务状态返回值:成功返回0, 失败返回-1。
参数:
serviceName: 服务名
status: 返回服务状态
超时时间
int ServiceSetReady(const char *serviceName)设置服务准备返回值:成功返回0,失败返回-1
参数:
serviceName: 服务名
int StartServiceByTimer(const char *serviceName, uint64_t timeout)定时启动服务返回值:成功返回0,失败返回-1
参数:
serviceName: 服务名
timeout: 超时时间
int StopServiceTimer(const char *serviceName)停止服务计时器返回值:成功返回0,失败返回-1
参数:
serviceName: 服务名
  • 服务控制接口为特权接口,因此需要配置DAC和selinux权限,具体如下:

  • 服务控制接口配置DAC,需要修改/base/startup/init/services/etc/group文件,在组servicectrl中添加对应的用户id,例如:

```
servicectrl:x:1050:root,shell,system,samgr,hdf_devmgr
```
  • 服务控制接口的selinux配置

    服务控制接口配置selinux,需要在init.te文件中添加该服务接口所需要的selinux权限,例如为init、samgr、hdf_devmgr等服务配置系统参数写权限:

    allow { init samgr hdf_devmgr } servicectrl_param:parameter_service { set };

约束与限制

仅限小型系统、标准系统下使用。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?但是又不知道从哪里下手,而且学习时频繁踩坑,最终浪费大量时间。所以本人整理了一些比较合适的鸿蒙(HarmonyOS NEXT)学习路径和一些资料的整理供小伙伴学习

点击领取→纯血鸿蒙Next全套最新学习资料希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取~~

一、鸿蒙(HarmonyOS NEXT)最新学习路线

有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)…等技术知识点。

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

二、HarmonyOS Next 最新全套视频教程

三、《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

四、大厂面试必问面试题

五、鸿蒙南向开发技术

六、鸿蒙APP开发必备


完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。 

                        

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值