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

最新推荐文章于 2024-06-21 14:50:07 发布
最新推荐文章于 2024-06-21 14:50:07 发布
阅读量1.2k 收藏 2
点赞数 1
分类专栏： cmake 文章标签： cmake
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_40953784/article/details/132226917
版权

准备

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)
  1. 通过config_file()命令将文件拷贝到指定文件或目录下。这里使用的时MSVC编译器，所以对MSVC进行判断了。
if(MSVC)
    set(VERSIONINFO_RC "${CMAKE_BINARY_DIR}/versioninfo.rc")
    configure_file("${CMAKE_SOURCE_DIR}/versioninfo.rc"
                    "${VERSIONINFO_RC}")
endif()
  1. 创建输出文件(dll/exe)时包含versioninfo.rc资源
add_executable(${PROJECT_NAME} ${SOURCES} ${VERSIONINFO_RC})
  1. 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)
小黑屋1024
关注
  • 1
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
vtk7.0-qt5.7-x86(32bit)-opengl2-vs2015-开发包
07-02
4. **lib**：存储了编译好的库文件，通常为静态库（.lib）和动态库（.dll），用于链接到目标应用程序。 5. **plugins**：QT的插件目录，可能包含一些特定于QT的库和组件，这些组件可以扩展QT的功能。 6. **share**...
tesserocr-windows_build
05-10
【tesserocr-Windows构建】涉及的是在Windows操作系统上搭建和构建Tesseract OCR（Optical Character Recognition，光学字符识别）库的Python绑定库——tesserocr。Tesseract OCR是一个开源项目，由Google维护，用于...
windows下使用Cmake为自己创建的库添加版本信息
hjxu2016的博客
05-07 2339
文章目录一、windows平台二、具体方法三、例子Reference 一、windows平台 windows下使用visual studio自带的动态库工程开发dll，可以帮助我们把版本号、公司名等信息生成到dll中，但是Cmake中的add_library生成的dll没有任何额外信息。 如下cuda.dll，右键通过详细信息就可以看到 文件说明、类型、文件版本、版权等多种信息，再也不需要去查文档、查头文件就能知道这个DLL是哪个版本，是什么时候生成的了。 二、具体方法 准备一个.rc.in的文件，里面
cmake将生成的dll文件复制到exe的目录下
qq_45414478的博客
01-31 2334
cmake / dll
【C++】关于代码编译自动更新版本的问题
最新发布
Jun626的博客
06-21 312
在写代码的时候，总是需要添加一个版本号，用于后续的版本管理我常遇到的一个问题是，开发过程中，不一定会记得这件事情，导致有时候会出现同样的版本于是希望有一个方式，能在编译代码的时候自动生成一个版本号。
vscode + cmake 链接第三方库dll编译c++成exe文件
CHWB2580的博客
06-05 7158
一、下载插件 装好CMake和CMake tools之后，vscode下方会有Build和CMake【Debug】 二、项目目录 settings.json文件中加入cmake的path { "clang.cflags":[ "-I${workspaceRoot}/include" ], "python.pythonPath": "D:\\AppData\\anaconda3\\python.exe", "C_Cpp.upd...
Windows下cmake生成dll文件
qq_45955402的博客
01-06 3833
cmake dll windows
VSCODE+MSVC+CMAKE配置实践入门：简单编写EXE、LIB和DLL
ZhenghaowenCSDN的博客
01-12 8463
VSCODE 配置MSVC工具链的实践，包括EXE、LIB、DLL和预编译文件，使用task、cl.exe和CMAKE
CMake 学习笔记（生成EXE和库文件）
Ivan 的专栏
07-02 1255
这个学习笔记通过一系列的例子来记录CMake 的各种功能。主要参考了 《CMake Cookbook —— Building, testing, and packaging modular software with modern CMake》 一书。
windows到Linux的程序移植.doc
05-14
【Windows到Linux的程序移植——动态链接库技术详解】 动态链接库（DLL）技术是程序设计中的关键元素，它在Windows和Linux系统中都扮演着重要角色。动态库允许程序在运行时按需加载和卸载功能模块，从而节省存储...
opencv下载文件.zip
06-05
2. `opencv_ffmpeg_64.dll` 和 `opencv_ffmpeg.dll`：这两个是FFmpeg库的动态链接库文件，FFmpeg是一个强大的多媒体处理框架，OpenCV用它来处理音频和视频数据。64位和32位的版本分别对应不同的操作系统环境。 3. `...
opencv2.3.1中的build.zip
11-22
在本例中，我们关注的是OpenCV的2.3.1版本的一个特定扩展——`opencv_contrib2.3.1`。这个扩展包包含了一些OpenCV核心库之外的额外模块，提供了更多高级功能和实验性的算法。 `opencv_contrib`是OpenCV的一个附加...
CMake自动导出dll导出符号
kasteluo的专栏
05-07 1681
对于Liunx和Unix平台，默认的c++模块都是以导出形式存在的，windows平台的导出需要声明__declspec(dlexport)进行导出，使用__declspec(dllimport)进行导入，如果有一个静态库，现在想改成动态库，必须手动添加导出标志，除此，还有一个方法就是将导出信息，写入到*.def文件中，设置到编译器中。但这样都比较麻烦，正好CMake提供了自动生成def文件的功能。
windows 用vs创建cmake工程并编译opencv应用项目生成exe流程简述
JAMES费的空间
11-04 1065
在计算机视觉和图像处理领域，OpenCV是一个非常流行的开源库，它提供了许多强大的功能和算法，可以帮助开发人员快速构建高效的应用程序。然而，对于初学者来说，OpenCV的配置和编译可能会是一个挑战。为了帮助大家更好地理解和掌握OpenCV的编译过程，本文将介绍如何在Windows上使用Visual Studio创建CMake工程并编译OpenCV应用程序，最终生成可执行文件。本文将详细介绍每个步骤，并提供一些实用的技巧和注意事项，以帮助读者更好地理解和掌握OpenCV的编译过程。
Windows+MinGW使用CMake生成.dll动态链接库
热门推荐
阿清的随手记
06-20 1万+
在完成接口开发后，为了给其他开发人员调用，通常需要将这部分代码打包生成动态链接库文件。动态链接库很好地保证了代码的封装性和独立性，作为接口，它可以很好地独立于主程序，便于更新。调用接口的主程序编译时也会绕过已生成的动态链接库，仅作连接，在运行时使用它，减少了前端人员编译的时间消耗。......
【亲测可行】QT实现cmake构建增加输出文件版本信息
whish1994的博客
04-02 1091
Qt使用Cmake构建，增加输出文件的版本信息
CMake生成应用程序软件版本编译时间,自动管理编译后输出文件.
w___dream的博客
12-24 2493
cmake生成应用程序版本编译时间信息.编译后自动归档镜像文件.简化嵌入式终端产品版本控制.
【cmake实战六】如何使用编译的库（动态库dll）——windows系统
junxuezheng的博客
08-31 7678
【代码】【cmake实战六】如何使用编译的库（动态库dll）——windows系统。
CMake生成版本号
金庆的专栏
08-15 4656
CMake生成版本号（金庆的专栏）原来的CMake需要用shell脚本生成SVN版本号，再作为cmake参数传入。CMake调用脚本示例：#!/bin/sh# cmake.shServerCodeRoot=~/Code/ServerCodeRevNum=`svn info ${ServerCodeRoot} | grep Revision | awk -F' ' '{ print $2 }'`cm
cmake 在windows下，如何为 exe 文件指定图标文件
06-13
可以使用 cmake 中的 `WIN32_EXECUTABLE` 属性来指定 exe 文件的图标文件。具体步骤如下： 1. 将图标文件（.ico 格式）添加到项目中，例如放在 `resources` 目录下。 2. 在 CMakeLists.txt 文件中添加以下代码： ```cmake if(WIN32) set(WIN_ICON "${CMAKE_CURRENT_SOURCE_DIR}/resources/icon.ico") set_property(TARGET ${PROJECT_NAME} PROPERTY WIN32_EXECUTABLE TRUE) set_property(TARGET ${PROJECT_NAME} APPEND_STRING PROPERTY LINK_FLAGS " /ICON:\"${WIN_ICON}\"") endif() ``` 这里的 `PROJECT_NAME` 是你的项目名称，`WIN_ICON` 是指定的图标文件路径。 3. 重新生成项目，生成的 exe 文件会带有指定的图标。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值