CMake生成应用程序软件版本编译时间,自动管理编译后输出文件.

项目背景：

之前做的一款终端产品使用cmake&ninja进行编译,由于前期开发进度较快,对于应用程序的版本号规则未进行较为合理的规划,应用程序版本控制方式使用产品名+版本号+时间的方式组合方式. 其中产品名和版本号在程序内部通过宏定义指定. 时间则通过C语言自带的宏定义__DATE__, __TIME__获取.

采用这种方式最终产生的效果就是程序编译完成后,必须烧到板子运行,然后才能获取到应用程序完整的版本号.软件版本控制,怎能如此的不便捷.笔者经过一番研究,果断更改了更为便捷的版本控制方式.后期维护更加便捷.

项目效果:

废话不多说,直接讲述最终效果. 使用cmake获取编译时间,生成软件版本号,传入源程序.源程序内部获取到软件版本号根据项目情况使用.编译完成后,根据编译的应用程序版本号创建一个文件夹,并将输出文件复制到相应的文件夹下,文件名以应用程序版本号重命名.这种方法的好处是对于编译的过程版本都有很好的追溯.

项目方案:

笔者只提供基本的demo代码及思路,具体的做法大家可以根据项目的实际情况进行调整.

一.修改CMakeLists.txt

修改CMakeLists.txt增加编译迭代版本号以及编译时间. 并在对应的源文件目录下创建相应的文件.供cmake传参.

#版本迭代编号+编译时间.  
set(VERSION_NUMBER  V001) 
string(TIMESTAMP COMPILE_TIME ${VERSION_NUMBER}_%y%m%d_%H.%M.%S) 
set(build_time    ${COMPILE_TIME}) 
set(VersionConfigPath ${SOURCE_TOP_DIR}/include) #工程源码下的include目录

#需要在源码目录下创建VersionConfig.h.in和VersionConfig.h
configure_file( 
    "${VersionConfigPath}/VersionConfig.h.in"
    "${VersionConfigPath}/VersionConfig.h"
)

二.增加源文件

VersionConfig.h.in中的内容如下:

#define VERSION_BUILD_TIME "@build_time@"  #VersionConfig.h.in中的内容.

VersionConfig.h中的内容如下,编译后CMakeLists生成的版本信息会传到此处.

#define VERSION_BUILD_TIME "V108_211223_20.41.46"

三.CMakeLists.txt核心命令

以下仅提供核心命令以及思路.具体可根据自己的情况作出修改.

# 设置编译后的文件名.
set(target AAA_${build_time})   
# 使用编译后的文件名创建一个文件夹.
COMMAND ${CMAKE_COMMAND} -E make_directory ${out_hex_dir}/${target}
#拷贝生成的目标文件到新建文件夹目录下 
COMMAND ${CMAKE_COMMAND} -E rename ${out_hex_dir}/${target}.img ${out_hex_dir}/${target}/${target}.img

四.最终效果

最终效果如下,在out目录下生成以版本号命名的文件夹,内部存放着本次编译生成的文件.