RT-Thread 软件包制作及发布流程

前言

RT-Thread是一个嵌入式实时多线程操作系统，系统完全开源，它不仅仅是一个实时内核，还具备丰富的中间层组件，包括如文件系统、图形库等较为完整的中间件组件，具备低功耗、安全、通信协议支持和云端连接能力的软件平台。

我们可以结合rtthread提供的组件和服务，制作软件包，丰富rt-thread的软件生态。让更多的开发者做到开箱即用，不用重复造轮子。

必备知识

• 熟悉rt-thread
• 了解Kconfig
• 了解Env开发工具
• 了解Scons构建工具

制作流程

为什么你做好的软件包能被其他开发者使用

首先需要明确的是，rt-thread的软件包分为两个部分

• 软件包
• 包信息

其中，软件包里存放的是具体的代码源文件，包信息里面存放的是这个软件包的基本信息，不包括源代码文件。

通过Env的menuconfig在某个BSP或者工程下面配置工程的时候，我们选择online package的时候，就会列举出当前已经基于rt-thread实现的软件包。如下图所示：

那么，这些软件包，在本地是存储在那里的呢？
打开Env的安装目录，然后定位到 packages->packages 文件夹下

这是一个git仓库，这里面就存放了所有rt-thread已经做好的软件包的包信息，我们通过menuconfig选择的软件包其实最终都链接到了这里，所以你在env里面使用

pkgs --upgrade

env就会从GitHub的仓库更新当前最新的软件包包信息到本地。所以当开发者制作好了一个软件包后提交到GitHub对应的软件包仓库，然后你在本地再upgrade一下就同步了。这样子只要有开发者提交软件包，你的menuconfig里能看到软件包就会越来越多。

所以，软件包的制作者在制作完成一个软件包后，必须要像rt-thread管理的软件包包信息仓库提交自己做好的软件包包信息，这一点非常重要。

如何制作一个软件包并提交

首先需要明确的是，你做好的软件包是可以放到自己的GitHub仓库的，同样也可以托管到rt-thread的GitHub软件包仓库。如果觉得每次向rt-thread软件包仓库提交代码需要审核比较麻烦的话，建议将软件包仓库放到自己GitHub。但是软件包代码更新了以后记得要在包信息仓库更新包信息，以便于开发者使用最新的软件包。

我们以一个简单的传感器软件包为例，来说一下制作一个软件包的具体流程。

软件包仓库的制作

前面讲过，一个软件分为包信息和软件包两个部分。首先我们讲一下软件包的制作。

1. 确保这个传感器的驱动已经接入rt-thread的sensor框架，并且代码能够在rt-thread上正常运行。
   
   比如一开始调试这个传感器的时候，我为了调试方便，就将传感器的所有源代码文件都放在了app文件夹内。这一步要做到传感器正常工作且接入了sensor框架。

2. 将这个传感器的源代码文件都放入一个文件夹
   

3. 增加一个SConscript文件和一个readme文件。SConscript文件内容请查看rt-thread的官方文档。readme就是一个说明文档，告诉其他人你这个软件的信息以及别人如何上手，写的越详细越好，降低使用门槛。
   

包信息的制作

1. 在我们之前提到的env安装目录的package文件夹内的对应位置新建一个传感器包信息的文件夹。我们之前说过，menuconfig里面的软包信息就是这里的内容的呈现，我们需要在本地调试ok以后才能将软件包推送到GitHub仓库供其他人使用。
   
2. 在文件夹里面新建两个文件，一个Kconfig文件，一个package.json文件，这两个文件的内容和作用，请查看rt-thread的官方文档，我们这里默认你已经知道这两个文件的作用了。
   
3. sensor目录下的Kconfig文件内增加一条记录，用来索引刚添加的软件包。

source "$PKGS_DIR/packages/peripherals/sensors/ina260/Kconfig"

调试

经过以上两个步骤，你就可以在本地调试你的软件包了，如果调试没有问题，那就可以发布到GitHub了。

1. 我们随便找一个支持rt-thread的开发板，创建一个基本的rt-thread工程。然后将上一步做好的软件包仓库放到该工程的package文件夹。
   注：如果你的工程目录里面没有packages文件夹，那你可以在manuconfig里面随便选一个软件包，然后再去掉，再使用scons --target==mdk5重新生成工程，这样子工程目录里面就有packages文件夹了，注意：packages文件夹里的这些文件不要删除，这个是组织工程的必要文件。
2. env命令工具行定位到该工程，然后menuconfig进入软件包选择，因为上一步我们已经加入了包信息，所以就可以索引到我们刚添加的软件包了，然后选中它，保存退出。
   
3. 使用scons --target==mdk5 更新工程，然后用keil打开工程，编译下载，如果没有问题则调试🆗，有问题则需要修改我们添加的Sconscript文件里面的内容了，修改方法见官方文档。

发布

至此，本地调试OK，我们需要发布软件包以便于让所有的开发者都使用。同样的，我们需要发布包信息和软件包。

发布软件包

GitHub上新开一个repo，将我们在packages文件夹里的软件包pull到这个新的repo中。

然后发布一个release版本，因为包信息里面需要填写。

发布包信息

还记得我们之前在包信息里面创建了一个package.json文件夹吗，在这里面填写刚才发布的软件包信息，然后将这个包信息pr到rt-thread官方维护的包信息仓库。具体贡献流程见官方文档。

总结

• 其实贡献软件包的流程和使用软件包刚好是相反的，贡献的准则是在本地调试OK后再发布到GitHub仓库。
• 调试的时候不能使用 pkgs --upgrade 命令，因为这条命令会更新packages仓库，会把我们自己修改的内容给刷掉。
• 调试的时候也不能使用pkgs --update命令，这条命令的含义是下载网络软件包到本地，应为我们现在就是在本地调试阶段，网络上根本就没有这个软件包。
• 使用scons --target==mdk5/iar 命令只是构建了这个工程，并没有编译该工程，建议多看看scons 。这个对构建工程很有帮助，尤其是工程比较复杂的时候，用scons构建会方便快捷很多，而且也便于管理。