cmake扩展(2)——windows下动态设置输出文件(dll/exe)版本

小黑屋10242023-08-12 12:41

准备

windows下设置文件的版本需要通过VERSIONINFO接口，详情参考VERSIONINFO resource。这里我们根据模板做了一定的修改。

1 VERSIONINFO
 FILEVERSION ${GIT_VERSION}	//文件版本号，必填。以,分隔，输出以.分隔。这里是取CMakeLists里的GIT_VERSION变量
 PRODUCTVERSION ${GIT_VERSION} //产品版本号，必填。以,分隔。虽然没起作用，见下面的"ProductVersion"
 FILEFLAGSMASK 0x17L
#ifdef _DEBUG
 FILEFLAGS 0x1L
#else
 FILEFLAGS 0x0L
#endif
 FILEOS 0x4L
 FILETYPE 0x0L
 FILESUBTYPE 0x0L
BEGIN
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904b0"
        BEGIN
            VALUE "FileDescription", "MyLibrary Binary" //文件说明
            VALUE "FileVersion", "1.1.1"                //文件版本，好像没啥用，只与FILEVERSION相关
            VALUE "InternalName", ""           //
            VALUE "LegalCopyright", "Copyright (C) 2019"
            VALUE "OriginalFilename", ""
            VALUE "ProductName", "1234" //产品名称
            VALUE "ProductVersion", "1.3.4.5.6"  //产品版本，与PRODUCTVERSION无关,直接输出 //${PROJECT_VERSION_MAJOR},${PROJECT_VERSION_MINOR},${PROJECT_VERSION_PATCH},${PROJECT_VERSION_TWEAK}
        END
    END
    BLOCK "VarFileInfo"
    BEGIN
        VALUE "Translation", 0x409, 1200
    END
END

注意事项

  1. FILEVERSION和PRODUCTVERSION为必填项。内容以','分隔，输出以'.'分隔(如设置为1,1,3,5，则实际输出版本为1.1.3.5)。可以直接是一整个变量，也可以是多个变量以','隔开。
  2. 而后面BLOCK块中内容都是全量输出，不做调整。
  3. 目前实验显示FILEVERSION内容管理实际输出的文件版本号，而产品版本号不由PRODUCTVERSION管理，反而由后面BLOK块中的"ProductVersion"控制。不知道是为啥。

调用versioninfo

前面已经准备号了versioninfo.接下来需要在CMakeLists中接入versioninfo。

  1. 首先将上面的versioninfo模板内容写入到文件中，并命名为versioninfo.rc(名字不重要，只要后续引用这个文件即可)

  2. 先在CMakeLists中手动写一个版本号(动态获取后面介绍),GIT_VERSION与versioninfo.rc中引用的变量名保持一致

    set(GIT_VERSION 1,2,0,4)

  3. 通过config_file()命令将文件拷贝到指定文件或目录下。这里使用的时MSVC编译器，所以对MSVC进行判断了。

    if(MSVC)
    set(VERSIONINFO_RC "{CMAKE_BINARY_DIR}/versioninfo.rc") configure_file("{CMAKE_SOURCE_DIR}/versioninfo.rc"
    "${VERSIONINFO_RC}")
    endif()

  4. 创建输出文件(dll/exe)时包含versioninfo.rc资源

    add_executable(${PROJECT_NAME} ${SOURCES} ${VERSIONINFO_RC})

  5. cmake之后编译，查看生成的可执行文件详细信息内容。

动态获取版本号

这里采用的是cmake的execute_process运行git命令获取版本，并对结果进行截取组合达到我们想要的内容。

execute_process表示运行命令，可以与git其他命令结合获取其他信息。

#######################
####获取git版本#########
#######################
#设置默认版本
set(GIT_VERSION 1.0.0)
#通过git命令获取版本
execute_process(COMMAND git describe --tags
OUTPUT_VARIABLE GIT_DESCRIBE)

# set(GIT_DESCRIBE "${GIT_DESCRIBE}-8-")
#查找版本
string(REGEX MATCH "[0-9]\\.[0-9]\\.[0-9]" GIT_DESCRIBE_VERSION ${GIT_DESCRIBE})
message(STATUS "GIT_DESCRIBE_VERSION=${GIT_DESCRIBE_VERSION}")
if(NOT ${GIT_DESCRIBE_VERSION} EQUAL "")
set(GIT_VERSION "${GIT_DESCRIBE_VERSION}")
endif()


#查找提交次数
string(REGEX MATCHALL "-([0-9]+)-" MATCH_COMMIT_RET ${GIT_DESCRIBE})
message(STATUS "MATCH_COMMIT_RET=${MATCH_COMMIT_RET}")
list(LENGTH MATCH_COMMIT_RET MATCH_COMMIT_RET_LEN)

message(STATUS "MATCH_COMMIT_RET_LEN=${MATCH_COMMIT_RET_LEN}")

if(${MATCH_COMMIT_RET_LEN} GREATER 0)
#拿到最后一个匹配项
math(EXPR MATCH_COMMIT_RET_LEN "${MATCH_COMMIT_RET_LEN} - 1")
message(STATUS "MATCH_COMMIT_RET_LEN=${MATCH_COMMIT_RET_LEN}")
list(GET MATCH_COMMIT_RET ${MATCH_COMMIT_RET_LEN} MATCH_LAST)
#获取
string(REGEX REPLACE "-(.+)-" "\\1" GIT_COMMIT_COUNT ${MATCH_LAST})
set(GIT_VERSION "${GIT_VERSION}.${GIT_COMMIT_COUNT}")
else()#没有则默认写0
set(GIT_VERSION "${GIT_VERSION}.0")
endif()

string(REPLACE "." ","  GIT_VERSION ${GIT_VERSION})
# set(GIT_VERSION 1,2,0)
# message(STATUS "final version is ${GIT_VERSION}")
##################################END#######################################

缺陷

这里因为是按照我们设想的git tag版本格式(x.x.x)，并根据git describe会自动返回"version-提交次数-g当前提交hash"内容所写的。目的就是提炼成"version.提交次数"，也就是x.x.x.x形式。所以这就要求在打tag的时候需要注意一定的格式否则这个代码将不起作用。

此外，git describe对于轻量标签不起作用，只有附注标签生效。

完整代码

cmake_minimum_required(VERSION 3.10)

project(gitversion)

#######################
####获取git版本#########
#######################
#设置默认版本
set(GIT_VERSION 1.0.0)
#通过git命令获取版本
execute_process(COMMAND git describe --tags
    OUTPUT_VARIABLE GIT_DESCRIBE)

# set(GIT_DESCRIBE "${GIT_DESCRIBE}-8-")
#查找版本
string(REGEX MATCH "[0-9]\\.[0-9]\\.[0-9]" GIT_DESCRIBE_VERSION ${GIT_DESCRIBE})
message(STATUS "GIT_DESCRIBE_VERSION=${GIT_DESCRIBE_VERSION}")
if(NOT ${GIT_DESCRIBE_VERSION} EQUAL "")
    set(GIT_VERSION "${GIT_DESCRIBE_VERSION}")
endif()


#查找提交次数
string(REGEX MATCHALL "-([0-9]+)-" MATCH_COMMIT_RET ${GIT_DESCRIBE})
message(STATUS "MATCH_COMMIT_RET=${MATCH_COMMIT_RET}")
list(LENGTH MATCH_COMMIT_RET MATCH_COMMIT_RET_LEN)

message(STATUS "MATCH_COMMIT_RET_LEN=${MATCH_COMMIT_RET_LEN}")

if(${MATCH_COMMIT_RET_LEN} GREATER 0)
    #拿到最后一个匹配项
    math(EXPR MATCH_COMMIT_RET_LEN "${MATCH_COMMIT_RET_LEN} - 1")
    message(STATUS "MATCH_COMMIT_RET_LEN=${MATCH_COMMIT_RET_LEN}")
    list(GET MATCH_COMMIT_RET ${MATCH_COMMIT_RET_LEN} MATCH_LAST)
    #获取
    string(REGEX REPLACE "-(.+)-" "\\1" GIT_COMMIT_COUNT ${MATCH_LAST})
    set(GIT_VERSION "${GIT_VERSION}.${GIT_COMMIT_COUNT}")
else()#没有则默认写0
    set(GIT_VERSION "${GIT_VERSION}.0")
endif()

string(REPLACE "." ","  GIT_VERSION ${GIT_VERSION})
# set(GIT_VERSION 1,2,0)
# message(STATUS "final version is ${GIT_VERSION}")
##################################END#######################################

#这里需要注意按顺序
if(MSVC)
    set(VERSIONINFO_RC "${CMAKE_BINARY_DIR}/versioninfo.rc")
    configure_file("${CMAKE_SOURCE_DIR}/versioninfo.rc"
                    "${VERSIONINFO_RC}")
endif()

file(GLOB SOURCES "*.cpp")
add_executable(${PROJECT_NAME} ${SOURCES} ${VERSIONINFO_RC})

target_include_directories(${PROJECT_NAME} 
    PRIVATE
    ${CMAKE_SOURCE_DIR})

注意事项

  • 需要注意这里add_executable中引用了versioninfo.rc文件，而versioninfo.rc文件中引用了GIT_VERSION变量，所以GIT_VERSION变量的获取需要放在最前面，然后是引入versioninfo.rc，最后是add_executable，否则会导致编译时，GIT_VERSION变量内容为空编译不过。

其他

另一种方式是通过cmake的PROJECT_VERSION,PROJECT_VERSION_MAJOR, PROJECT_VERSION_MINOR, PROJECT_VERSION_PATCH, PROJECT_VERSION_TWEAK来获取,但是无法动态调整版本号，需要手动修改。

代码如下：

cmake_minimum_required(VERSION 3.10)

project(cmakeversion VERSION 1.2.5.8)


#这里需要注意按顺序
if(MSVC)
    set(VERSIONINFO_RC "${CMAKE_BINARY_DIR}/versioninfo.rc")
    configure_file("${CMAKE_SOURCE_DIR}/versioninfo.rc"
                    "${VERSIONINFO_RC}")
endif()

file(GLOB SOURCES "*.cpp")
add_executable(${PROJECT_NAME} ${SOURCES} ${VERSIONINFO_RC})

target_include_directories(${PROJECT_NAME} 
    PRIVATE
    ${CMAKE_SOURCE_DIR})


include(CMakePackageConfigHelpers)
configure_package_config_file(Config.cmake.in
    ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Config.cmake
    INSTALL_DESTINATION lib/cmake/${PROJECT_NAME})
write_basic_package_version_file(${PROJECT_NAME}ConfigVersion.cmake
    VERSION ${PACKAGE_VERSION} COMPATIBILITY AnyNewerVersion )



install(FILES ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}Config.cmake
        ${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}ConfigVersion.cmake
        DESTINATION lib/cmake/${PROJECT_NAME} )

message(status "version=${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}.${PROJECT_VERSION_TWEAK}")

此外需要引用Config.cmake.in

@PACKAGE_INIT@

set_and_check(CMAKEVERSION_INCLUDE_DIR "@PACKAGE_INCLUDE_INSTALL_DIR@")
set_and_check(CMAKEVERSION_SYSCONFIG_DIR "@PACKAGE_SYSCONFIG_INSTALL_DIR@")

check_required_components(Cmakeversion)
相关推荐
zhy295633 天前
【LIBS】开源库编译之OSQP
ubuntu·cmake·osqp·libs
charlee444 天前
CMake构建学习笔记19-OpenSSL库的构建
ssl·cmake·c/c++·构建
Prejudices5 天前
CMake的INSTALL FILES和INSTALL DIRECTORY有什么区别
cmake
上官永石6 天前
《Modern CMake for C++》学习笔记
cmake
Yongqiang Cheng8 天前
Installing CMake (安装 CMake)
cmake·安装 cmake
石悼花11 天前
Visual Studio 2022+CMake配置PCL1.14.1
c++·cmake·visual studio·pcl·openni2
___波子 Pro Max.15 天前
cmake CMAKE_CURRENT_SOURCE_DIR和CMAKE_CURRENT_LIST_DIR的区别
cmake
dragoo118 天前
vscode cmake头文件无法跳转
c++·vscode·cmake·头文件
路西法Lux19 天前
Cmake+基础命令
cmake
热门推荐
01【一文读懂】NTN（非地面网络）技术介绍02优化手机性能，解决卡顿问题：关闭这3个微信开关，释放内存空间03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05基于大语言模型（LLM）的合成数据生成、策展和评估的综述06(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明07组基轨迹建模 GBTM的介绍与实现（Stata 或 R）08HCIA-datacom数通题库和录播视频资料09Docker 夺命连环 15 问10RAG 实践- Ollama+RagFlow 部署本地知识库