【本文正在参与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
内容如下：

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. 服务的启动配置

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.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
串口终端显示：

重新拉启服务

运行hdc_std.exe shell 终端运行 sa_main /system/profile/updater_sa.xml：

串口终端查询，多运行了一个update_sa进程：

服务拉起注册到SAMGR进程的日志：

服务拉起之后：
客户端就可以与服务端通信了，客户端获取与服务端通信的对象 代码块如下所示：

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

【官方相关文档】