【開源之夏2023】聊?聊開源之夏以及項(xiàng)目的進(jìn)展（rt-thread上用CI來驗(yàn)證軟件包的編譯情況）

前言

開源之夏是什么

?先來簡單介紹?下開源之夏。

開源之夏是開源軟件供應(yīng)鏈點(diǎn)亮計(jì)劃下的?個(gè)暑期活動(dòng)，由中國科學(xué)院軟件研究所與openEuler社區(qū)聯(lián)合主辦，旨在?勵(lì)在校學(xué)?積極參與開源軟件的開發(fā)維護(hù)，促進(jìn)優(yōu)秀開源軟件社區(qū)的蓬勃發(fā)展。

活動(dòng)聯(lián)合各?開源社區(qū)，針對(duì)開源項(xiàng)?的開發(fā)與維護(hù)提供 mini 任務(wù)，開放給全球?校學(xué)?報(bào)名申請(qǐng)。學(xué)?可?主選擇感興趣的項(xiàng)?進(jìn)?申請(qǐng)，并在中選后獲得社區(qū)資深開發(fā)者親?指導(dǎo)的機(jī)會(huì)。項(xiàng)?成功結(jié)項(xiàng)并貢獻(xiàn)給社區(qū)后，參與者將獲得開源之夏活動(dòng)獎(jiǎng)?和結(jié)項(xiàng)證書。

我參與開源之夏的?些契機(jī)

不過這個(gè)時(shí)候我有同學(xué)給我分享了開源之夏（在這?我要?常感謝分享給我這個(gè)活動(dòng)的同學(xué)）。由于開源活動(dòng)、開源實(shí)習(xí)基本是全程線上，適合因?yàn)槟承┰?法實(shí)習(xí)的同學(xué)參與，剛剛好可以稍微替代?下暑期實(shí)習(xí)。

開源之夏的申請(qǐng)過程

RT-Thread算是最早?批的加?開源之夏的社區(qū)，在?絡(luò)上也可以搜到前?年的開源之夏相關(guān)的信息。

今年的開源之夏RT-Thread社區(qū)同樣也準(zhǔn)備不少可選的項(xiàng)?。

在這個(gè)??可以看到RT-Thread社區(qū)今年的項(xiàng)?列表。

https://summer-ospp.ac.cn/org/orgdetail/8bce77cd-7c54-48b8-a3e6-f816338692cb

我選擇的項(xiàng)?是：rt-thread上?CI來驗(yàn)證軟件包的編譯情況（基礎(chǔ)）

對(duì)于主流和常?的軟件包，添加CI編譯機(jī)制，結(jié)合官?給出的pkgs-test，構(gòu)建?個(gè)CI機(jī)器?，能夠在master提交和修改代碼的時(shí)候，能夠知道哪些軟件包編譯不過，并且能夠?成編譯結(jié)果報(bào)告，并且將?些可以在qemu上運(yùn)?的?些程序在qemu上運(yùn)?并且輸出結(jié)果。先以qemu-vexpress-a9為基準(zhǔn)測試軟件包

因?yàn)槲以谥皠偤?過CI?具測試過zepherRTOS的項(xiàng)?，因此我看到這個(gè)就?上添加到待選列表??了。

開源之夏的申請(qǐng)?法是需要提交項(xiàng)?的申請(qǐng)書和個(gè)?簡歷（申請(qǐng)書在開源之夏?站上會(huì)有模版提供）。于是我在了解整個(gè)項(xiàng)?過后完成了這兩份材料。

完成材料之后，我根據(jù)導(dǎo)師的聯(lián)系?式，向?qū)熖峁┝松暾?qǐng)書并根據(jù)項(xiàng)?的?些內(nèi)容介紹了??的相關(guān)經(jīng)驗(yàn)，?概確定了意向（其實(shí)這?我看了項(xiàng)?倉庫的fork和star感覺沒有其他?申請(qǐng)，因此我就沒有再準(zhǔn)備申請(qǐng)其他的項(xiàng)?）。

在項(xiàng)?確定下來之后我就開始進(jìn)?開源之夏的活動(dòng)了。

項(xiàng)目內(nèi)容

倉庫主?https://github.com/RT-Thread/pkgs-test

項(xiàng)目介紹

官?的項(xiàng)?說明可以在這?查看
https://summer-ospp.ac.cn/org/prodetail/238bc0128

關(guān)于這個(gè)項(xiàng)??先需要了解?下什么是RT-Thread的軟件包，RT-Thread軟件包是運(yùn)?在RT-Thread系統(tǒng)上?的?套通?的代碼庫。相當(dāng)于提供了很多模塊，?如各種外設(shè)的驅(qū)動(dòng)、?具等等，只要使?的是RT-Thread操作系統(tǒng)，就都可以導(dǎo)?并使?。RTThread軟件包和RT-Thread操作系統(tǒng)?樣是?個(gè)開源的平臺(tái)，任何?都可以制作??的軟件包，也可以去幫助維護(hù)別?的軟件包。

因?yàn)檫@種?由、開放的特性，軟件包社區(qū)??會(huì)遇到某些軟件包?法使?、不能編譯通過的問題。

• 版本迭代造成的編譯問題（內(nèi)核?件改動(dòng)后，軟件包沒有去做版本控制）

• 架構(gòu)沖突以及 bsp 依賴問題（某些軟件包只在特定的架構(gòu)或 bsp 中可?）

因此需要?個(gè)?具來暴露出社區(qū)軟件包的相關(guān)編譯問題。

使用場景

1.本地使用

A. 對(duì)特定的軟件包，在?些指定的bsp、rt-thread版本上進(jìn)?測試。

B. 指定某?個(gè)特定的版本或所有版本。

C. 指定的軟件包集合。

2. 作為Github Action使?，測試軟件包是否?持?些rtt版本和bsp。
a.軟件包開發(fā)者

1. 軟件包測試：更新軟件包的代碼之后，?動(dòng)對(duì)軟件包進(jìn)?測試。

2. rt-thread的master測試：定時(shí)對(duì)軟件包進(jìn)?測試，檢查是否?持rt-thread的master版本。

b.rt-thread社區(qū)維護(hù)?員

1. 所有軟件包測試：定時(shí)對(duì)全部軟件包在master 分?或指定的?些版本上進(jìn)?測試，并發(fā)布測試結(jié)果到github pages。

2. 軟件包索引更新測試：軟件包索引發(fā)?改動(dòng)時(shí)，對(duì)改動(dòng)的部分軟件包進(jìn)?測試，在github pages上面更新這部分測試結(jié)果。

3. rt-thread版本發(fā)布測試：rt-thread版本發(fā)布后對(duì)全部的軟件包進(jìn)?測試。

4. 精品軟件包集合測試（TODO）：對(duì)?些制定的精品軟件包集合進(jìn)?測試，?如當(dāng)rt-thread的master分?改動(dòng)時(shí)，測試這些軟件包。

對(duì)于?些更具體的介紹，可以來看這?篇?章。

https://club.rt-thread.org/ask/article/9c05fc7fcc0223fe.html

我在接?這個(gè)項(xiàng)?的時(shí)候，已經(jīng)完成了本地測試的使?和軟件包索引倉庫使?的?些基本功能，我是在此基礎(chǔ)上進(jìn)?開發(fā)的。

截止到目前，我完成的內(nèi)容?概如下：

• 將測試的?些參數(shù)（如內(nèi)核版本，測試的bsp等）通過程序運(yùn)?的參數(shù)傳?。之前是通過修改配置?件來實(shí)現(xiàn)的，如果是作為ci?具使?不是很?便。

• 將軟件包的測試結(jié)果?成json并發(fā)布到github pages，主要是提供?個(gè)獲取軟件包可?性的?式。完成了對(duì)新舊測試結(jié)果的合并，以及上傳沖突的解決?案。

  https://rt-thread.github.io/packages/pkgs_res.json

• 從json?成了?個(gè)html??也發(fā)布到了githubpages，這?原來是有?個(gè)html報(bào)告的，主要是從直接?成html改成了從json?成，然后增加了測試時(shí)有每個(gè)版本有多少個(gè)軟件包通過了測試等信息。

  https://rt-thread.github.io/packages/

• 然后就是在軟件包索引倉庫添加了這個(gè)?具，完成了定期對(duì)全部軟件包進(jìn)?測試。

接下來主要的?作，就是去在RT-Thread倉庫??去集成這個(gè)?具，對(duì)rt-thread倉庫的每次代碼在?些精選的套裝軟體上?進(jìn)?測試。以及去完善?下?動(dòng)測試后的回響，每次測試結(jié)果都不是很?便查看，需要通過actions?動(dòng)在pr??回復(fù)相關(guān)的?些信息，讓開發(fā)者能夠更?便的了解到哪?出了問題，為什么沒通過檢查。

———————End———————

?