#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口 原创 精华

碼磚民工
发布于 2021-12-23 09:18
浏览
11收藏

【本文正在参与51CTO HarmonyOS技术社区创作者激励计划-星光计划2.0】

@[toc](动态库Sa服务拉起的main入口, 以及各部分的编译说明)

简介

OpenHarmony 很多服务都是编译成动态库, 动态库服务,没有main函数入口。服务的拉起的入口在哪?
以在线升级服务为例说明服务入口,说明如下:

一. 服务的动态库:libupdateservice.z.so

这个编译代码里面有,学习者可以在源代码中去看:
配置路径:base\update\updateservice\engine\BUILD.gn

二. main入口:sa_main

sa_main是含有main入口的独立可执行文件。学习者可以自己在代码中去看:
配置路径:foundation\distributedschedule\safwk\services\safwk\BUILD.gn

三. sa_main如何加载 libupdateservice.z.so

updater_sa.xml配置了动态库libupdateservice.z.so的各项信息。
sa_main通过读取解析updater_sa.xml, 把动态库libupdateservice.z.so加载到自身进程中来。
即运行命令:/system/bin/sa_main /system/profile/updater_sa.xml

1. 动态库服务的编译配置

1.1 动态库的编译配置

动态库编译配置:

base\update\updateservice\engine\BUILD.gn

动态库编译后的名称:

libupdateservice.z.so

1.2 xml的编译配置

1.2.1 xml的原始文件

原始xml的文件路径:base\update\updateservice\engine\sa_profile\3006.xml
内容:

<info>
    <process>updater_sa</process>
    <systemability>
        <name>3006</name>
        <libpath>libupdateservice.z.so</libpath>
        <run-on-create>true</run-on-create>
        <distributed>false</distributed>
        <dump-level>1</dump-level>
    </systemability>
</info>

1.2.1.1 3006:

是UPDATE_DISTRIBUTED_SERVICE_ID的值,该值定义在
utils\system\safwk\native\include\system_ability_definition.h中。

1.2.1.2 libupdateservice.z.so

是服务对应的动态库

1.2.2 xml的编译配置BUILD.gn

编译文件配置路径:base\update\updateservice\engine\sa_profile\BUILD.gn
内容:

import("//build/ohos/sa_profile/sa_profile.gni")

ohos_sa_profile("updater_sa_profile") {
  sources = [ "3006.xml" ]

  part_name = "updater"
}

1.2.3 编译配置ohos.build

文件路径:base\update\updater\ohos.build
内容如下:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

1.2.4 编译成功生产的文件

1.2.4.1 编译后Ubuntu路径:

out/ohos-arm-release/packages/phone/system/profile/updater_sa.xml

1.2.4.2 内容:

<?xml version="1.0" encoding="utf-8"?>
<info>
    <process>updater_sa</process>
    <loadlibs>
        <libpath>libupdateservice.z.so</libpath>
    </loadlibs>
    <systemability>
        <name>3006</name>
        <libpath>libupdateservice.z.so</libpath>
        <run-on-create>true</run-on-create>
        <distributed>false</distributed>
        <dump-level>1</dump-level>
    </systemability>
</info>

1.2.4.3 烧入开发板后的路径:

system/profile/updater_sa.xml
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

2. 服务的启动配置

2.1 服务启动配置

配置文件路径:base\update\updateservice\engine\etc\updater_sa.cfg
文件内容如下:

{
    "jobs" : [{
            "name" : "boot",
            "cmds" : [
                "start updater_sa"
            ]
        }
    ],
    "services" : [{
            "name" : "updater_sa",
            "path" : ["/system/bin/sa_main", "/system/profile/updater_sa.xml"],
            "uid" : "system",
            "gid" : ["system", "shell"]
        }
    ]
}

2.2 启动编译配置

配置文件路径:base\update\updateservice\engine\BUILD.gn
内容如下:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

2.3 编译成功生成的文件

编译后Ubuntu路径:out\ohos-arm-release\packages\phone\system\etc\init\updater_sa.cfg
烧入开发板后的路径:system\etc\init\updater_sa.cfg

3 运行过程

每次开机,init阶段会读取配置updater_sa.cfg,启动updater_sa。即拉起服务动态库libupdateservice.z.so
进程启动查询:ps -A | grep updater
串口终端显示:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

重新拉启服务

运行hdc_std.exe shell 终端运行 sa_main /system/profile/updater_sa.xml:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

串口终端查询,多运行了一个update_sa进程:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

服务拉起注册到SAMGR进程的日志:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

服务拉起之后:
客户端就可以与服务端通信了,客户端获取与服务端通信的对象 代码块如下所示:
#星光计划2.0# OpenHarmony SA 动态库服务 拉起的main入口-鸿蒙开发者社区

IPC动态服务库的交互流程解析参考【IPC通信】文档

【官方相关文档】

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
已于2022-9-13 15:52:30修改
9
收藏 11
回复
举报
1条回复
按时间正序
/
按时间倒序
红叶亦知秋
红叶亦知秋

感谢拓维老师不断输出优质文章

1
回复
2021-12-23 10:14:45
回复
    相关推荐