RT-Thread-软件包 0 error 计划流程介绍RT-Thread问答社区

软件包 0 error 计划流程介绍

发布于 2023-03-02 16:20:18 浏览：518 订阅该版

[tocm]

## 软件包 0 error 计划

### 活动入口

[软件包 0 error 计划](https://docs.qq.com/doc/DQlhTdW90S2dBWGhF)

### 微信群二维码

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/29f6d2a07b6a5ea4050c19ae1fa69322.png.webp)

## 认领软件包

可以在这一百个软件包中认领自己感兴趣的软件包，不限于一个

这里我以 `rc522` 软件包为例，说明一下具体的流程

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/845ed8e689aac38a416d237fbfe40a60.png.webp)

## 使用软件包测试工具进行测试

这里我推荐使用我仓库的测试工具进行测试，https://github.com/zhkag/pkgs-test 我这里加入了一些新功能，还没有提交到官方仓库

### 安装依赖

安装 python 和 pip

安装 pip 依赖

```shell
pip install scons requests tqdm wget html-table
```

### 修改配置选项

1. 打开 `config.json` 文件，将 pkgs 字段中的 hello 改为 rc522 并删除 rtthread 字段中的 master

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/947e8bc290ac2fafa7a1851486208ff3.png)

### 测试软件包

我的仓库中的工具新加了 `--debug` 和 `--error` 的选项，可以更加有效的测试软件包

使用 `python pkgs-test.py --debug` 进行测试，这里使用 `--debug` 的原因是测试的同时会将编译的信息汇总起来以供编译不过时调试软件包

测试完成，我们会发现在当前文件夹下生成了 `artifacts_export` `local_pkgs` `error.json` 等文件/文件夹，其中 `artifacts_export` 为日志文件，其中有网页文件可以通过浏览器打开显示 另外`local_pkgs` `error.json` 则是 `--debug` 参数生成的，

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/20e03f5679b27ffdd384ab13c905842f.png)

打开生成的网页文件，会发现有很多的编译失败，我们可以点进去查看失败原因

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/685845c53eaaaf60f83e39c6209a12ca.png)

更新最新进度 https://docs.qq.com/sheet/DQk5kTkRiRURpUVdR?tab=BB08J2

### 修复编译问题，使其通过编译

这个时候我们就需要查看错误的原因了，还记得 `--debug` 生成的 `local_pkgs` 文件夹，这里汇总了编译出错的软件包，我们可以通过修改这里的文件，来进行软件包的修复工作

修复之后的编译情况可以通过 `python pkgs-test.py --error` 进行测试，它会使用之前生成的 `error.json` 文件，将 local_pkgs 中的软件包，复制到需要编译的 bsp 下进行编译

测试完后，再次打开网页文件，发现所有的 latest 版本都编译通过了

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/7669f9af818ba7cb74601e83d3d7cc13.png)

更新最新进度 https://docs.qq.com/sheet/DQk5kTkRiRURpUVdR?tab=BB08J2

## 代码提交

### Fork 原始仓库，提 PR

Fork 原始仓库，将代码提交上去，并且提交 PR

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/647718cd9d29b0c1b154ab62b854976d.png.webp)

说明此项改动的原因，以及催促原作者发布软件包版本

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/630c0c6a0672c8595a5c354aeafab860.png.webp)

更新最新进度 https://docs.qq.com/sheet/DQk5kTkRiRURpUVdR?tab=BB08J2

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/0023671a5a767e99c169e58ba7f0b3b3.png.webp)

### 修改软件包索引仓库

等待软件包作者合并以及发布新版本之后修改软件包索引仓库，将新版本加入到索引中

### 假设软件包新版本为（v1.4.6）

添加版本信息，并且修改默认版本，默认版本不应设置为 latest 版本

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/3b1659868d206785f10679468ef8303d.png)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/13c80cf64c0985abebcb740cee9aac16.png.webp)

也可以不使用默认版本的定义，将会使用第一个可选的版本，理论上默认版本应该是最新的可用版本

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230302/4286e6722325bb990faf16e41b56a091.png.webp)

回到
底部

软件包 0 error 计划流程介绍

关于作者

zhkag

相关文章

热门标签

本月文章贡献

软件包 0 error 计划 流程介绍

关于作者

zhkag

相关文章

推荐文章

热门标签

本月问答贡献

本月文章贡献

软件包 0 error 计划流程介绍