背景

目前社區軟件包存在大量編譯問題：

版本迭代造成的編譯問題（內核文件改動后，軟件包沒有去做版本控制）
架構沖突以及 bsp 依賴問題（某些軟件包只在特定的架構或 bsp 中可用）
針對上述的問題，誕生了 pkgs-test 工具，主要用于暴露出社區軟件包的相關編譯問題。

使用場景

本地使用

對特定的軟件包，在一些指定的bsp、rt-thread版本上進行測試。
指定某一個特定的版本或所有版本。
指定的軟件包集合。
作為Github Action使用，測試軟件包是否支持一些rtt版本和bsp。

軟件包開發者

軟件包測試

更新軟件包的代碼之后，自動對軟件包進行測試。

rt-thread的master測試

定時對軟件包進行測試，檢查是否支持rt-thread的master版本。

rt-thread社區維護人員

所有軟件包測試

定時對全部軟件包在master 分支或指定的一些版本上進行測試，并發布測試結果到github pages。

軟件包索引更新測試

軟件包索引發生改動時，對改動的部分軟件包進行測試，在github pages上面更新這部分測試結果。

rt-thread版本發布測試

rt-thread版本發布后對全部的軟件包進行測試。

精品軟件包集合測試（TODO）

對一些制定的精品軟件包集合進行測試，比如當rt-thread的master分支改動時，測試這些軟件包。

pkgs-test的class
pkgs-test工具內部一共有6個類。

?PackagesIndex
從軟件包索引讀取軟件包信息，保存到一個字典中。
根據運行時輸入的參數來選擇需要測試的軟件包列表。
Config
根據配置文件下載需要的資源rt-thread、toolchains。
下載env工具和軟件包索引。
根據運行時輸入的參數來修改配置文件。
Logs
根據測試結果生成json。
根據json生成html頁面。
Build
執行編譯，并輸出編譯日志到文件。
Change
檢查軟件包索引的改動。
Check
檢查Logs生成的json。
pkgs-test的運行過程
首先使用Config讀取配置文件。輸入參數args.config是配置文件目錄。

config = Config(args.config)
讀取輸入的軟件包名稱。

pkgs_name = config.get_pkgs_name(args.pkg)
如果有輸入就保存輸入的名稱，輸入為空就從配置文件內讀取。

def get_pkgs_name(self, pkg=[]):
if pkg:
return pkg
elif not (self.config_data['pkgs'] == None or self.config_data['pkgs'] == []):
return list(self.config_data['pkgs'])
return []
接著下載需要的資源。這里在ci工具里面會事先下載好一些資源，比如軟件包索引，如果該目錄已經存在，則不會被覆蓋，可以用于測試這些還沒有發布的資源。

config.get_resources()
讀取軟件包索引。如果輸入參數nolatest那么就不保存latest版本。

packages_index = PackagesIndex(os.path.join(
config.get_path('env'), 'packages/packages'))
packages_index.nolatest(args.nolatest)
接著選擇測試的軟件包。

if args.repository:
        pkgs_config_dict = packages_index.repository_seek(args.repository)
    else:
        pkgs_config_dict = packages_index.name_seek(pkgs_name)

這里分為兩種情況，一種是作為ci使用，會輸出參數repository，另一種是本地使用，讀取前面保存的pkgs_name。

name_seek會判斷是不是測試全部軟件包，如果pkgs_name是all那么就會測試全部軟件包。

def name_seek(self, pkgs='all'):
if pkgs == 'all':
config_dict = self.dict
else:
config_dict = self.__get_config_pkgs(pkgs)
print(config_dict)
return config_dict
repository_seek會識別repository的類型，如果是軟件包倉庫就會在軟件包索引里面尋找，如果是packages軟件包索引倉庫就會使用Change尋找軟件包索引的改動，將改動的軟件包保存到pkgs_config_dict里面。

def repository_seek(self, repository):
pkgs = []
repository_name = repository.split("/")[1]
if repository_name == 'packages':
change = Change(os.path.join(Config().get_path('env'),"packages/packages"))
return self.name_seek(change.get_change_pkg_name())
for pkg in self.dict:
if repository_name.lower() in pkg['repository'].lower():
pkgs.append(pkg)
if len(pkgs) > 1:
pkgs_copy = list(pkgs)
for pkg in pkgs_copy:
if not repository_name in pkg['repository']:
pkgs_copy.remove(pkg)
if pkgs_copy:
pkgs = pkgs_copy
if not pkgs:
print('You may have changed the warehouse name while forking!!!')
return []
for pkg in pkgs[0]['pkg']:
if 'URL' in pkg:
pkg['URL'] = 'https://github.com/' + repository + '.git'
return pkgs
創建一個Log類，用于生成測試結果，這里的append_res是開啟從github pages下載舊的測試結果并且與新的合并。

logs = Logs('artifacts_export',
                config.get_config_data(), pkgs_config_dict)
if args.append_res:
        if args.pages_url:
            logs.pages_url = args.pages_url
        logs.append_res = True

最后執行編譯，并根據編譯的log生成json和html。

build = Build(config, pkgs_config_dict, logs, args.j)
其中關于發布測試結果的部分在這里詳細說明一下。

執行Logs.logs()會根據編譯日志生成測試結果json與html頁面。

其中有兩個json文件，pkgs_res_single是本次執行pkgs-test產生的測試結果，pkgs_res是與舊的測試結果合并后的，如果沒有合并那么兩個json相同。這里從代碼可以看到，兩個json文件都使用__build_res生成，如果傳入True那么就會合并，如果False那么就只有本次結果。

index.html則是根據pkgs_res生成的頁面。

def logs(self):
pkgs_res_single_dict = self.__build_res(False)
with open(os.path.join(self.logs_path, 'pkgs_res_single.json'), 'w') as f:
json.dump(pkgs_res_single_dict, f)
self.pkgs_res_dict = self.__build_res(self.append_res)
with open(os.path.join(self.logs_path, 'pkgs_res.json'), 'w') as f:
json.dump(self.pkgs_res_dict, f)
logs_html = self.__html_report()
with open(os.path.join(self.logs_path, 'index.html'), 'w') as f:
for log in logs_html:
f.write(log)
Workflow的運行過程
workflow分為3個job，packages-test用于測試軟件包，check-errors用于檢查測試結果，Deploy-Pages發布測試結果頁面。

packages-test

首先是下載運行的倉庫和pkgs-tese倉庫。

• uses: actions/checkout@v3
  with:
  path: repository
  • uses: actions/checkout@v3
    with:
    repository: '${{ inputs.pkgs-test-repository }}'
    ref: '${{ inputs.pkgs-test-branch }}'
    path: pkgs-test
    接下來是安裝一些軟件和工具。
• name: Install Tools
  shell: bash
  run: |
  sudo apt install python3 python3-pip gcc git libncurses5-dev tree -y
  python3 -m pip install scons==4.4.0 requests tqdm wget dominate PyGithub requests pytz
  如果運行的倉庫是軟件包索引，那么就把軟件包索引倉庫復制到后面需要下載軟件包索引的路徑。
• name: Copy RT-Thread/packages to env
  if: "${{ endsWith(github.repository, '/packages') == true }}"
  shell: bash
  run: |
  cd ${{ github.workspace }}
  mkdir -p ./pkgs-test/env/packages
  cp -r ./repository ./pkgs-test/env/packages/packages
  根據輸入的配置參數下載對應的資源，rt-thread、bsp對應的工具鏈、env工具、軟件包索引。
• name: Install Test Resources
  shell: bash
  run: |
  cd ${{ github.workspace }}/pkgs-test
  python pkgs-test.py config --rtthread='${{ inputs.rt-thread-versions }}'
  python pkgs-test.py config --bsps='${{ inputs.bsps }}'
  python pkgs-test.py download
  執行編譯測試，這里根據輸入的參數會選擇是否測試全部軟件包，是否測試軟件包latest版本，是否合并測試結果。
• name: Carry Out Packages Test
  shell: bash
  run: |
  cd ${{ github.workspace }}/pkgs-test
  echo 'Carry Out Packages Test.'
  if [[ ${{ inputs.package-test-all}} == true ]]; then
  COMMAND="python pkgs-test.py --pkg=all"
  else
  COMMAND="python pkgs-test.py --repository=${{ inputs.package-repository }}"
  fi
  if [[ ${{ inputs.package-test-nolatest}} == true ]]; then
  echo 'nolatest.'
  COMMAND="$COMMAND --nolatest"
  fi
  if [[ ${{ inputs.package-append-res}} == true ]]; then
  echo 'Append test res to old res from githubpage.'
  COMMAND="**COMMAND --append_res --pages_url='**{{ inputs.pages-url}}'"
  fi
  echo "$COMMAND"
  eval "$COMMAND"
  最后就是導出artifacts_export目錄的測試結果、一個是方便維護者下載、一個是用來發布頁面。
• uses: actions/upload-artifact@v3
  with:
  name: artifacts_export
  path: ${{ github.workspace }}/pkgs-test/artifacts_export
  check-errors
  這個job比較簡單，就是根據下載的測試結果執行判斷。

check-errors:
runs-on: ubuntu-latest
needs: packages-test
if: "${{ inputs.check-errors }}"
steps:

• uses: actions/checkout@v3
  with:
  repository: '${{ inputs.pkgs-test-repository }}'
  ref: '${{ inputs.pkgs-test-branch }}'
• name: Download artifacts_export
  uses: actions/download-artifact@v3
  with:
  name: artifacts_export
• name: Install Tools
  shell: bash
  run: |
  sudo apt install python3 python3-pip -y
  python3 -m pip install requests tqdm wget dominate PyGithub requests pytz
• name: Packages test whether or not error
  shell: bash
  run: |
  python pkgs-test.py check --file='pkgs_res_single.json'
  Deploy-Pages
  Deploy-Pages就是將artifacts_export發布到github pages。

Deploy-Pages:
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
needs: packages-test
if: "${{ inputs.deploy-pages }}"
steps:

• name: Download artifacts_export
  uses: actions/download-artifact@v3
  with:
  name: artifacts_export
• name: Setup Pages
  uses: actions/configure-pages@v3
• name: Upload artifact
  uses: actions/upload-pages-artifact@v1
  with:

Upload entire repository

path: '.'

• name: Deploy to GitHub Pages
  id: deployment
  uses: actions/deploy-pages@v2
  作為Github Action使用
  目前可以在軟件包索引倉庫和軟件包倉庫使用pkgs-test來測試軟件包的編譯情況。

Packages倉庫

軟件包索引倉庫里面目前有兩個功能，一個是當發生改動的時候測試改動的軟件包，另外就是定時測試全部的軟件包。

改動測試

這里是Packages倉庫的軟件包測試workflow文件其中的一個job，目的是當發生改動的時候測試改動的軟件包。

change:
if: ${{ github.event_name == 'pull_request' || github.event_name == 'push'}}
uses: RT-Thread/pkgs-test/.github/workflows/pkgs-action.yml@main
with:
package-append-res: true
deploy-pages: true

這里使用if進行了判斷，當workflow的觸發事件是pull_request或者push的時候，執行change這個job。

傳入的參數有兩個，package-append-res用來開啟從github pages下載舊的測試結果并且與新的合并，deploy-pages用來開啟將測試結果發布到github pagses。

定時全部測試

這里我舉出兩個jobs的例子，測試master內核版本下兩個bsp的軟件包編譯情況。

master-stm32h750-artpi-test:
if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'}}
uses: RT-Thread/pkgs-test/.github/workflows/pkgs-action.yml@main
with:
bsps: stm32/stm32h750-artpi:sourcery-arm
rt-thread-versions: branch:master
package-append-res: true
package-test-all: true
deploy-pages: true
check-errors: false
master-k210-test:
if: ${{ github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'}}
needs: master-stm32h750-artpi-test
uses:
with:
bsps: k210:sourcery-riscv-none-embed
rt-thread-versions: branch:master
package-append-res: true
package-test-all: true
deploy-pages: true
check-errors: false

測試全部軟件包的觸發事件有兩個，schedule定時測試和workflow_dispatch手動觸發，這里也是使用if來判斷的。

這里注意一下，測試全部軟件包需要一個接著一個按順序測試，不能并行進行測試，不然發布測試結果會產生沖突，workflow文件也用了concurrency這個參數來確保每次只有一個workflow在運行，讓其余的進行等待。

concurrency:
group: pkgs-test
cancel-in-progress: false # wait for finish.
然后解釋一下傳入的參數。

bsps指的就是測試的bsp和其使用的工具鏈，用冒號進行分隔。
rt-thread-versions指的就是內核的版本，branch和tag有兩種不同的輸入方法branch:master tag:v4.1.1
package-append-res表示的是從github pages下載舊的測試結果并且與新的合并。
package-test-all就是最主要的一個參數，表示測試全部軟件包。
deploy-pages表示發布測試結果到GitHub pages。
check-errors表示關閉錯誤檢查，這里是因為主要目的是發布測試結果，所以用不需要檢查是否有軟件包沒有通過編譯測試。

軟件包倉庫

軟件包倉庫的使用方法比較簡單，不需要輸入任何參數，它的測試過程和本地測試基本上一致。

它的workflow文件是這樣的。

name: RT-Thread_Packages_Test
on:
[push, pull_request]
jobs:
pkgs-test:

未來會實現的功能

定期測試全部軟件包后會通知給軟件包所有者：使用action打開一個issue，在里面@有問題的軟件包作者。
增加一個軟件包可用性分級：1.有最新release版本可用。2.只有latest版本、或者最新版軟件包不可用但有舊版可用 3.全部失敗
再完善一下結果報告頁面，比如按類別給包分組。
針對rt-thread內核的測試，對一個精選軟件包集合進行測試。