基于Hi3861平台的OpenHarmony程序是如何启动运行的

一、前言

在继续后面课程的内容讲解前，我们要知道在H3861平台上编写的代码到底是如何启动的，这一点很重要。
先分析HelloWorld程序的启动运行流程，并顺便讲解OpenHarmony在H3861平台的，系统是从哪里启动的。
反着推导函数之间具体的调用链

二、编写Hello World代码

我们先编写一个HelloWorld的程序，然后看它是怎么构建编译和运行的

// HelloWorld.c#include <stdio.h>
#include "ohos_init.h"void Hello_World(void)
{printf("Hello World!\r\n");
}
APP_FEATURE_INIT(Hello_World);

将业务构建成静态库的BUILD.gn文件，内容如下：

// static_library里面：指定了业务模块的编译结果，为静态库文件：libmyapp.a
static_library("myapp") {// sources里面：指定了静态库.a所依赖的.c文件及其路径sources = ["hello_world.c"]// include_dirs里面：指定了source所需要依赖的.h文件路径include_dirs = ["//utils/native/lite/include"]
}

编写模块BUILD.gn文件，在./applications/BearPi/BearPi-HM/sample 下的BUILD.gn文件中添加如下代码：

import("//build/lite/config/component/lite_component.gni")
lite_component("app") {features = ["my_app:myapp",]
}

使用vscode 编译，烧录成功，启动开发板，运行，那么它在启动运行的过程中，代码是如何执行的？

三、程序是如何运行被调用的

我们从上面看到 HelloWorld.c 里面使用了 APP_FEATURE_INIT ，那么我们是不是可以先从这里入手，查看它里面到底做了什么，再展开看到底是如何执行的，我们接着往下看：

APP_FEATURE_INIT 它定义在了 ohos_init.h 里面：

// 代码在：utils/native/lite/include/ohos_init.h// 函数指针
typedef void (*InitCall)(void);...#define LAYER_INITCALL(func, layer, clayer, priority)            \static const InitCall USED_ATTR __zinitcall_##layer##_##func \__attribute__((section(".zinitcall." clayer #priority ".init"))) = func
#endif
// Default priority is 2, priority range is [0, 4]
#define LAYER_INITCALL_DEF(func, layer, clayer) \LAYER_INITCALL(func, layer, clayer, 2)...#define APP_FEATURE_INIT(func) LAYER_INITCALL_DEF(func, app_feature, "app.feature")

那么我们可以知道LAYER_INITCALL 传递的数据等价于下面这样：

LAYER_INITCALL(func, app_feature, "app.feature", 2)

那么此时的clayer就是：app.feature，#priority 等于 2，展开(func, layer, clayer, priority) 得到如下内容：

 static const InitCall USED_ATTR __zinitcall_##layer##_##func \__attribute__((section(".zinitcall.app.feature2.init"))) = func

到这里，如何继续往下看呢？

假设大家和我一样都是第一次看，完全不知道具体目录和文件是干啥用的，就是硬撕代码。

那么我们来全局搜索下：.zinitcall.app. 这个字符串，发现它在 bootstrap_service.h 这个头文件里面有使用，我们看一下：

// 代码在: ohos_bundles/@ohos/bootstrap/source/bootstrap_service.h#define APP_NAME(name, step) ".zinitcall.app." #name #step ".init"...#define APP_CALL(name, step)                                      \do {                                                          \InitCall *initcall = (InitCall *)(APP_BEGIN(name, step)); \InitCall *initend = (InitCall *)(APP_END(name, step));    \for (; initcall < initend; initcall++) {                  \(*initcall)();                                        \}                                                         \} while (0)...#define APP_BEGIN(name, step)                                 \({  extern InitCall __zinitcall_app_##name##_start;       \InitCall *initCall = &__zinitcall_app_##name##_start; \(initCall);                                           \})#define APP_END(name, step)                                 \({  extern InitCall __zinitcall_app_##name##_end;       \InitCall *initCall = &__zinitcall_app_##name##_end; \(initCall);                                         \})...#define APP_BEGIN(name, step) __section_begin(APP_NAME(name, step))...#define INIT_APP_CALL(name) \do {                    \APP_CALL(name, 0);  \APP_CALL(name, 1);  \APP_CALL(name, 2);  \APP_CALL(name, 3);  \APP_CALL(name, 4);  \} while (0)

我们从上面的代码可以看出来这几个代码是有联系的，看不懂不要紧，我们接着往下看(稍后再来看上面的代码)，打开bootstrap_service.c 看里面的代码：

// 代码在：base/startup/services/bootstrap_lite/source/bootstrap_service.cstatic void Init(void)
{static Bootstrap bootstrap;bootstrap.GetName = GetName;bootstrap.Initialize = Initialize;bootstrap.MessageHandle = MessageHandle;bootstrap.GetTaskConfig = GetTaskConfig;bootstrap.flag = FALSE;// 注册Bootstrap服务SAMGR_GetInstance()->RegisterService((Service *)&bootstrap);
}
SYS_SERVICE_INIT(Init);...static BOOL MessageHandle(Service *service, Request *request)
{Bootstrap *bootstrap = (Bootstrap *)service;switch (request->msgId) {case BOOT_SYS_COMPLETED:  // 核心系统服务已初始化完成的消息if ((bootstrap->flag & LOAD_FLAG) != LOAD_FLAG) {// 这里调用了INIT_APP_CALLINIT_APP_CALL(service);INIT_APP_CALL(feature);bootstrap->flag |= LOAD_FLAG;}(void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);break;case BOOT_APP_COMPLETED:  // 系统和应用层服务初始化完成的消息(void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);break;case BOOT_REG_SERVICE:    // 运行中服务注册的消息(void)SAMGR_SendResponseByIdentity(&bootstrap->identity, request, NULL);break;default:break;}return TRUE;
}

我们看到MessageHandle里面，当消息ID为BOOT_SYS_COMPLETED时，调用了INIT_APP_CALL(feature)方法，我们再回到上面bootstrap_service.h里面的代码：

// 代码在: ohos_bundles/@ohos/bootstrap/source/bootstrap_service.h#define APP_NAME(name, step) ".zinitcall.app." #name #step ".init"...#define APP_CALL(name, step)                                      \do {                                                          \InitCall *initcall = (InitCall *)(APP_BEGIN(name, step)); \InitCall *initend = (InitCall *)(APP_END(name, step));    \for (; initcall < initend; initcall++) {                  \(*initcall)();                                        \}                                                         \} while (0)...#define APP_BEGIN(name, step)                                 \({  extern InitCall __zinitcall_app_##name##_start;       \InitCall *initCall = &__zinitcall_app_##name##_start; \(initCall);                                           \})...#define APP_BEGIN(name, step) __section_begin(APP_NAME(name, step))...#define INIT_APP_CALL(name) \do {                    \APP_CALL(name, 0);  \APP_CALL(name, 1);  \APP_CALL(name, 2);  \APP_CALL(name, 3);  \APP_CALL(name, 4);  \} while (0)

我们再精简APP_CALL(feature,2) 里面代码的调用：

InitCall *initcall = (InitCall *)(APP_BEGIN(name, step));#define APP_BEGIN(name, step) __section_begin(APP_NAME(name, step))#define APP_NAME(name, step) ".zinitcall.app." #name #step ".init"<==========↓↓↓↓最终它的值等于下面↓↓↓↓==========>#define APP_NAME(name, step) ".zinitcall.app. feature 2 .init"

最后通过(*initcall)() 调用方法，至此，我们就初步知道 APP_FEATURE_INIT是如何被调用到的了。

结束了吗？没有，我们往下看，系统到底是从哪里启动的？这样才能完整的串起来。

四、系统启动入口

我们在 bootstrap_service.c 里面看到了这段代码： SYS_SERVICE_INIT(Init)，它是干什么用的？

// 代码在：utils/native/lite/include/ohos_init.h
#define SYS_SERVICE_INIT(func) LAYER_INITCALL_DEF(func, sys_service, "sys.service")

那么它最终表达如下：

 static const InitCall USED_ATTR __zinitcall_##layer##_##func \__attribute__((section(".zinitcall.sys.service2.init"))) = func

同样的，你就当做我们是第一次看这个源码，啥也不懂，我们只会全局搜索一下：.zinitcall.sys.，看看哪里使用了它，发现 core_main.h 有使用

//代码在：ohos_bundles/@ohos/bootstrap/source/core_main.h#define SYS_CALL(name, step)                                      \do {                                                          \InitCall *initcall = (InitCall *)(SYS_BEGIN(name, step)); \InitCall *initend = (InitCall *)(SYS_END(name, step));    \for (; initcall < initend; initcall++) {                  \(*initcall)();                                        \}                                                         \} while (0)...#define SYS_BEGIN(name, step)                                 \({        extern InitCall __zinitcall_sys_##name##_start;       \InitCall *initCall = &__zinitcall_sys_##name##_start; \(initCall);                                           \})
...#define SYS_BEGIN(name, step) __section_begin(SYS_NAME(name, step))...#define SYS_INIT(name)     \do {                   \SYS_CALL(name, 0); \SYS_CALL(name, 1); \SYS_CALL(name, 2); \SYS_CALL(name, 3); \SYS_CALL(name, 4); \} while (0)

我们发现SYS_INIT是在 system_init.c 里面被调用的

// 代码在：ohos_bundles/@ohos/bootstrap/source/system_init.c
void OHOS_SystemInit(void)
{MODULE_INIT(bsp);MODULE_INIT(device);MODULE_INIT(core);SYS_INIT(service);SYS_INIT(feature);MODULE_INIT(run);// 启动系统服务和功能SAMGR_Bootstrap();
}

这个时候，我们肯定是不知道谁在用void OHOS_SystemInit(void)，那么动动手指，搜索一下，你会发现，OpenHarmony系统真正的启动入口main函数：

// 代码在：foundation/distributedschedule/services/safwk_lite/src/main.c...int main(int argc, char * const argv[])
{
#ifdef DEBUG_SERVICES_SAFWK_LITEprintf("[Foundation][D] Start server system, begin. \n");struct timeval tvBefore;(void)gettimeofday(&tvBefore, NULL);
#endifOHOS_SystemInit();#ifdef DEBUG_SERVICES_SAFWK_LITEstruct timeval tvAfter;(void)gettimeofday(&tvAfter, NULL);printf("[Foundation][D] Start server system, end. duration %d seconds and %d microseconds. \n",\tvAfter.tv_sec - tvBefore.tv_sec, tvAfter.tv_usec - tvBefore.tv_usec);
#endifwhile (1) {// pause only returns when a signal was caught and the signal-catching function returned.// pause only returns -1, no need to process the return value.(void)pause();}
}

我们能看到OHOS_SystemInit它是在main.c中调用的，至此，我们豁然开朗。

纵观上面的代码分析，我们学习了系统从哪里启动的，并且知道了 HelloWorld 程序启动和运行的完整流程。