在已有RT-Thread项目工程上搭建utest测试环境

一、背景介绍：

开发人员已经编写好了功能代码，编译环境是keil，使用的mcu是gd32，实时操作系统是RT-Thread，所有想着利用RT-Thread自带的utest组件来编写测试用例，测试功能代码，以下是测试环境搭建过程。

二、安装软件

软件安装过程不再赘述，安装教程网上一搜就有，本章节只介绍所安装软件的作用

keil5：编译、烧写程序

source insight：查看代码，由于keil没有代码追踪、选中高亮及调用关系等好用的功能，因此可以安装一个source insight用于查看代码

git：用于下拉上传代码，配置env的前提也是安装好git，描述为“软件包管理功能需要 git 的支持”

github desktop：用于提交和下拉代码，图形化界面操作代替git命令，操作方便

env：1、下载安装env；2、配置env，通过menuconfig命令调出图形化界面，打开utest组件，过程可参照Env 用户手册 (rt-thread.org)

xshell：使用时需要配置对应的串口，用于查看程序运行的日志

三、编写运行测试用例

1、通过env命令scons --target=mdk5命令生成keil工程，此时会生成project.uvprojx文件

2、使用keil5打开project.uvprojx文件，打开工程

3、编写测试用例，此处可以先使用utest提供的应用范式来测试环境是否搭建成功

4、使用keil编译，烧写程序到mcu

5、通过xshell输入utest_run,运行测试用例

6、分析测试结果，可以看到用例PASSSD

四、环境搭建过程中踩过的坑及注意事项

1、配置env，env配置是针对单个项目的，且保留在本地的，若从git上下拉代码后先要检查一下env配置，进行env配置

2、从git上下拉的代码没有project.uvprojx文件，因此使用keil5没办法直接打开工程，解决办法：需要通过env重新执行scons --target=mdk5命令生成keil工程，就可以打开了，此处调试了1.5h

3.打开工程后，build代码出现1个err，原因是报错位置的文件处于压缩状态，解压后就好了

4、烧写过程有两种方式：1、一直按着开关键，点击keil的烧写按钮，直到烧写完成；2、WCH-LINK的连接线连接上3.3V供电，点击keil的烧写按钮，直到烧写完成，拔掉3.3V供电线

5、打开供电电源后需要先查看电压是否是设置的电压4v左右，若电压较低可能是出现了短路，需要及时关闭电源，此处踩过坑，进针对本项目

五、存疑

在功能源码工程分支上配置了utest，编译生成keil工程后，切换了分支，切至测试代码仓库，utest仍然是设置状态，project.uvprojx文件也仍然在呢