背景
最近搞一個(gè)sensor接入openharmony的事情沥阱,在分析源碼中的加速度計(jì)驅(qū)動(dòng)相關(guān)源碼時(shí)巷屿,發(fā)現(xiàn)不緊有BUILD.gn文件滓技,還有Makefile文件,并且里面都有記錄源文件路徑篷就。所以很困惑,openharmony是通過gn+ninja編譯的還是通過make編譯的厕倍?
為了搞清楚贱除,所以針對liteos-a系統(tǒng)下的編譯過程進(jìn)行分析,在這里記錄一下
入口
通過官方文檔看寡键,liteos-a系統(tǒng)編譯時(shí)用的是官方的hb命令hb set
和hb build
命令掀泳,所以入口肯定是hb工具
查看openharmony源碼中build目錄下有一個(gè)lite/hb目錄(hb命令的源碼目錄,使用python腳本)
編譯過程調(diào)試
看鴻蒙研究站里面有一篇介紹hb命令的調(diào)試方法,通過vscode+python插件調(diào)試开伏,參見《v59.xx 鴻蒙內(nèi)核源碼分析(構(gòu)建工具篇) | 順瓜摸藤調(diào)試鴻蒙構(gòu)建過程》
說明:
- 主要是創(chuàng)建一個(gè)launch.json文件膀跌,里面定義調(diào)試命令的入口(詳細(xì)信息可以在網(wǎng)上查詢)。為了多次調(diào)試效果一樣固灵,在調(diào)試build命令時(shí)捅伤,我增加了-f選項(xiàng),這樣每次都會(huì)全新編譯巫玻,如下
{//hb build
"name": "hb build debug",
"type": "python",
"request": "launch",
"program": "./build/lite/hb/__main__.py",
"console": "integratedTerminal",
"args": ["build", "-f"],
"stopOnEntry": true
},
- 在win+虛擬機(jī)linux編譯系統(tǒng)場景丛忆,我沒有調(diào)試成功,后面搞成功了再補(bǔ)充仍秤;這里我是直接在linux環(huán)境進(jìn)行調(diào)試熄诡,這個(gè)依賴于linux本地編譯,不要使用docker鏡像
hb set
設(shè)置好之后就可以開始在vscode上調(diào)試
-
選擇"hb set"調(diào)試目標(biāo)并按F5诗力,會(huì)停在
./build/lite/hb/__main__.py
的代碼開始處
-
在80行打斷點(diǎn)并按F5
-
按F11可以進(jìn)入set.py的
exec_command
接口
-
然后就可以繼續(xù)后續(xù)的調(diào)試工作凰浮,
hb set
命令主要是生成ohos_config.json
這個(gè)后面編譯要使用的配置文件,這里就不詳細(xì)記錄調(diào)試的過程了
hb build -f
這個(gè)是整個(gè)編譯的重點(diǎn)苇本,通過調(diào)試可以看到最終是調(diào)用了gn/ninja/fs_make袜茧,如下分析
-
前兩步跟
hb set
命令一樣,第三步會(huì)進(jìn)入build.py的exec_command
接口
-
這個(gè)接口的前面我們先略過瓣窄,我們先在接口最后的build.build接口處加斷點(diǎn)笛厦,并按F5
-
按F11進(jìn)入,并在
build_process.py
的135行加斷點(diǎn)再按F5
-
查看cmd_list變量的值有3個(gè)(除去內(nèi)置的)接口俺夕,分別是
Build.gn_build
裳凸、Build.ninja_build
、Packer.fs_make
這個(gè)就是整體的編譯過程了劝贸,先調(diào)用gn生成ninja文件姨谷,再通過ninja進(jìn)行編譯,最后通過fs_make制作鏡像
因?yàn)閮?nèi)容太多映九,下面對這三個(gè)編譯動(dòng)作先做個(gè)整體的介紹菠秒,后續(xù)再對每一個(gè)進(jìn)行詳細(xì)分析
gn_build
繼續(xù)調(diào)試,會(huì)先進(jìn)入gn_build
接口氯迂,看實(shí)現(xiàn)就是調(diào)用了gn gen
命令践叠,如下
查看gn_cmd變量,詳細(xì)命令為(比較多嚼蚀,經(jīng)過了整理):
這個(gè)命令之后禁灼,就會(huì)將工程中所有用到的BUILD.gn
文件轉(zhuǎn)換成<module_name>.ninja
文件(類似makefile
)供后面ninja
命令(類似make
)調(diào)用并進(jìn)行編譯
ninja_build
再繼續(xù)調(diào)試就會(huì)進(jìn)入ninja_build
接口,實(shí)現(xiàn)以及執(zhí)行的詳細(xì)的ninja
命令如下
這個(gè)命令與make
命令類似轿曙,但是注重速度(詳細(xì)信息可以在網(wǎng)上搜索兩者區(qū)別)弄捕;此命令執(zhí)行即是通過build.ninja/toolchain.ninja/各BUILD.gn轉(zhuǎn)換的.ninja來進(jìn)行編譯僻孝,并生成.bin/.so/.a等文件
fs_make
-
fs_make
接口會(huì)讀取在vendor目錄下定義好的fs.yml
文件,獲取到對鏡像的配置信息守谓,讀取到mksh_rootfs/rootfs/userfs三個(gè)fs_cfg信息穿铆,如下
-
對于每一個(gè)fs_cfg都會(huì)調(diào)用定義好的6個(gè)接口,如下
編譯結(jié)束
整個(gè)編譯OK之后會(huì)輸出如下圖中成功信息
在out目錄下就會(huì)生成燒錄用到的鏡像文件斋荞,如下圖