【鴻蒙開發板試用報告】從點燈開始理解鴻蒙OS的項目結構與啟動流程
https://harmonyos.51cto.com/#zz
和大家一樣,拿到板子后,就急不可耐的按照老師們的教程開始各種操作了。但是一段時間后,我突然發現,我對項目的結構和啟動流程還都一知半解。為了能更深入的理解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,且對項目結構和啟動流程有了一個初步的理解。
https://harmonyos.51cto.com/#zz