有些C/C++项目开发周期极长。在处理此类项目过程中,构建开发环境就像施展魔法一样:测试框架被巧妙集成在一起,CI/CD流程将开发者从繁琐重复的工作中解脱出来。
作为程序员,在开发过程中,我只有一个简单的愿望:在当前的开发环境中将C库简化为少数几个文件。
在本文中,我们将介绍如何为C语言项目构建容器化开发环境,也将介绍如何使用CMake设置构建系统、使用Unity设置测试环境以及如何在CI流水线中构建容器化环境。
一、现代化开发环境
接下来,我们将展示如何为C项目构建完整的、容器化的开发环境:
创建Docker镜像作为vscode的开发容器;
基于最小化的Dummy库,在容器中设置构建库的工具;
设置静态代码分析器clang-tidy检查代码是否有常见错误;
clang-format维持代码库的格式保持正常和整洁;
设置Unity,通过在主机上执行Ceedling测试虚拟函数;
最后,我们将设置GitHub工作流,使用本地Docker镜像执行、构建和测试项目。
在本文中,我将使用Docker命令行接口。如果你不明白为什么需要某些参数,建议参考在线文档。你也可以直接打开GitHub上的示例项目。
二、在Docker中运行程序
有时,使用嵌入式系统或C/C++需要安装大量专用工具或编译器。如果你正在同时处理不同的项目,版本之间很容易发生冲突。因此,我更倾向于在Docker容器中运行所有程序。
你可以使用Dockerfiles,这能避免在本地安装工具,任何人都能通过预构建镜像或本地镜像加入项目。
1.为什么是Docker?存在哪些陷阱?
如果你是Docker新手,需注意以下几点:
Dockerfiles不稳定:昨天构建出的Dockerfile今天就可能无法使用,存在太多的外部依赖关系;
Docker不是平台独立型的,例如Apple ARM;
某些Docker特性仅在Linux或专用Windows中获得了支持;例如,并非所有平台都支持将USB设备安装到Docker容器之中,这是自2016年以来的限制。
鉴于此,建议你不要将“赌注”都“押”在同一项技术上,并且你需要随时做好切换的准备。
2.让我们这样做
让我们从零开始,构建空存储库:
确保安装Dockor并顺利运行,在项目的根目录中创建如下内容:builder.Dockerfile
这个Dockerifle指定了基本镜像并安装了一些包,便于在后续步骤中使用。我不会详细介绍每一个软件包:在创建镜像时,你很快就能注意到缺少了什么,可以扩展软件包列表,重要的是以下几点:
对于基本图像,我强烈建议使用特定标签。apt包在基本镜像之间变化很大,选择标记可以为你节省更多时间;
我倾向于在镜像开发过程中使用特定平台 ,这一点对后续开发步骤的顺利进行很重要。
如果不使用vscode,也可以指定不同的镜像。在本文中,我们将使用vscode,也将坚持使用Dev容器所支持的镜像。
镜像是用如下的命令构建出来的,执行起来可能需要一点时间:
3.详细命令行调用的快捷方式
Docker命令非常冗长,因此,我通常将常用命令放在makefile项目根目录中。假设安装make后可进行如下操作:
现在,执行如下操作重建镜像:
让我们从图像中旋转容器并进行测试:
当使用apt时,已安装的工具版本取决于基础镜像,也取决于包注册表。如果需要安装特定的版本,可以通过执行自定义的RUN命令。
三、Visual Studio代码开发容器
没有在本地安装所有工具的缺点是:你选择的IDE无法利用这些工具,例如,当使用vscode时,如果没有安装编译器,你将无法正确设置智能提示或任何其它的辅助程序。
vscode允许你在开发容器中运行编辑器。这也是我们选择将mcr.microsoft.com/vscode/devcontainers/base当作基础图像的原因:我们可以在容器中链接到vscode,因此所有工具都将被安装在Docker镜像中。
值得注意的是,vscode实例与本地vscode安装不匹配,与远程实例非常相似。
通过创建.devcontainer/devcontainer.json文件,我们可以让vscode使用新构建的图像作为开发容器,还可以在vscode实例中安装3个扩展,通过使用 customizations.extensions字段中的devcontainer.json配置文件:
如果你从现在开始重新加载窗口或重新打开vscode,vscode应该会询问你是否需要使用检测到的开发容器。
需要一段时间为vscode设置你的容器、安装扩展,并用vscode连接到Linux容器。
四、系统架构
我们将使用CMake构建单独的.c和.h对。
CMakeLists.txt简单定义了名为“Dummy”的库,并将相应的文件添加到库中。
重要的是:这已在开发容器和vscode中被构建出来了!在你的远程实例中打开集成终端并执行CMake,如下所示:
五、安装clang工具:格式化和静态代码分析
C和C++的灵活性也伴随着大量“footguns”的出现;因此,我尝试在项目中添加至少一个最小的静态代码分析任务,这有助于发现最明显的错误。市面上有很多工具,但到目前为止,我个人更偏爱clang-tidy。
另外,在代码库上进行协作时,格式化器极好;当我们在安装clang-tidy时,不妨继续安装clang-format。
你需要将两个配置文件clang-format和.clang-tidy放置到项目根目录中,以便任何IDE都能自动拾取它们:
六、添加单元测试框架
我们已经能够构建并分析库,还提供了格式化功能。在开发环境中,我们还需要一个单元测试框架。
在本文中,我选择了Unity测试框架,通过Ceedling在主机上执行。顺便说一句,使用这个框架便于嵌入式系统在目标硬件上执行任务。
1.安装Unity和Ceedling
在构建者镜像的第一步中,我们已经安装了ruby,所以,安装单元测试工具变得更加简单:
重建镜像后,我们就可以开始了!
2.配置Unity和运行单元测试
简而言之,你需要在一个专门的unity_config.h文件中将配置开关设置为Unity并配置Ceedling与project.yml. Ceedling,为你生成所有的测试运行程序。
你需要做的就是添加你的测试文件,然后“告诉”Ceedling如何检测它们:
然后,我们可以创建第一个单元测试tests/unittest/test/test_dummy.c:
七、结论
到这里,所有的工作就都完成了,包括库的构建等,报告也可以使用了。神奇的是,所有这些操作都不会使计算机因工具而“堵塞”。
最后,值得一提的是:有了Docker桌面,你不仅可以轻松检查图像漏洞,还能检查Dockerfile中的每一步:
现在,你已具备在GitHub上用CI设置容器化C/C++项目的所有技能。有了这项技能,你能轻松地在文档中添加特定编译器或清理设置CI时出现的所有错误。