HarmonyOS技术社区 · 2020年11月09日

【开发板试用报告】从点灯开始理解鸿蒙OS的项目结构与启动流程

和大家一样,拿到板子后,就急不可耐的按照老师们的教程开始各种操作了。但是一段时间后,我突然发现,我对项目的结构和启动流程还都一知半解。为了能更深入的理解HarmonyOS的代码,我决定从基础开始,再从头学习。

一、整体情况

首先,咱们HarmonyOS是用C语言写的(废话),编译用gcc。项目构建上,没有用传统的make,而是用的GN。什么是GN?

Generate Ninja,是Google为Ninja专门开发的上层编译框架,可以生成Ninja可以识别的输入文件。GN由c++编译,相比于基于python的gyp,速度快接近20倍。

什么是Ninja?

Ninja 是Google的一名程序员推出的注重速度的构建工具,一般在Unix/Linux上的程序通过make/makefile来构建编译,而Ninja通过将编译任务并行组织,大大提高了构建速度。

重点突出一个“快”字。总而言之,有了这俩先进工具的加持,咱这个鸿蒙编译速度那是飞快。相信大家都深有体会。

二、项目结构

1.applications,自然就是用户的各种应用代码了,这里是咱们的主战场。具体来说,applications/sample/wifi-iot/app/,这个app目录里是咱们的业务代码。

2.base,OS的基础代码。主要包含全球化(global),DFX(hiviewdfx),公共基础(iot_hardware),安全(security),启动恢复(startup)等若干模块。

3.build,构建目录。编译过程中的文件存放目录。

4.docs,文档。很多新手往往忽略了自带的文档。

5.domains,领域。看样子是几个demo。

6.drivers,驱动。OpenHarmony驱动子系统采用C面向对象编程模型构建,通过平台解耦、内核解耦,兼容不同内核,提供了归一化的驱动平台底座,旨在为开发者提供更精准、更高效的开发环境,力求做到一次开发,多系统部署。

7.foundation,基础模块。内容很复杂,包含Ability、ACE、Graphics等等很多模块。

8.kernel,内核代码。

9.out,输出目录。生成的固件文件就在这里。

10.prebuilts,LiteOS预先编译好的文件。一些LiteOS的.o和.a文件放在这里,可用来加快编译速度。

11.test,测试目录。具体都是干嘛的暂时没有搞清楚。

12.third_party,第三方代码。

13.utils,工具模块。像文件访问、timer、task什么的。

14.vendor,制造商提供的代码。这里有程序启动的入口代码,应给予一定的关注。有时间可以研究一下。

15.build.py,编译脚本。基本用法:python build.py wifiiot

三、启动流程

HelloWorld的教程我就不再重复了,推荐参考连老师的文章。关键弄懂一个地方:

SYS_RUN(HelloWorld);

这个SYS_RUN是系统自带的宏,是告诉项目,咱们的业务代码的入口函数是HelloWorld。SYS_RUN宏的定义在ohos_init.h头文件中,位置在\utils\native\lite\include\ohos_init.h,定义如下:

/**
 * @brief Identifies the entry for initializing and starting a system running phase by the
 * priority 2.
 *
 * This macro is used to identify the entry called at the priority 2 in the system startup
 * phase of the startup process. \n
 *
 * @param func Indicates the entry function for initializing and starting a system running phase.
 * The type is void (*)(void).
 */
#define SYS_RUN(func) LAYER_INITCALL_DEF(func, run, "run")

定义了系统启动阶段的初始化和启动入口,类型必须是void (*)(void),即不能有参数,也没有返回值。LAYER_INITCALL_DEF也是宏,是为了方便灵活调整启动阶段和优先级而设定的,具体读者可以自行研究。

回到咱们的HelloWorld中,这里说一下线程。一般业务代码都会通过一个主循环来执行各项任务,最佳的方法是启动一个线程,这样入口函数不会阻塞导致一系列问题。启动线程的方法如下:

    osThreadAttr_t attr;

    attr.name = "HelloTask";
    attr.attr_bits = 0U;
    attr.cb_mem = NULL;
    attr.cb_size = 0U;
    attr.stack_mem = NULL;
    attr.stack_size = 10240;
    attr.priority = osPriorityNormal;

    if (osThreadNew(HelloTaskFunc, NULL, &attr) == NULL) {
        printf("[HelloTaskDemo] Falied to create HelloTask!\n");
    }

至此,已经可以顺利完成HelloWorld,且对项目结构和启动流程有了一个初步的理解。


作者:老船夫
想了解更多内容,请访问:
51CTO和华为官方战略合作共建的鸿蒙技术社区
https://harmonyos.51cto.com#jssq

推荐阅读
关注数
3010
内容数
446
华为鸿蒙相关技术,活动及资讯,欢迎关注及加入创作
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息