Qt 设置软件版本信息的实现

 更新时间:2025年06月19日 11:22:56   作者:好鑫晴9899  
本文介绍了Qt项目中设置版本信息的三种常用方法,包括.pro文件和version.rc配置、CMakeLists.txt与version.h.in结合,具有一定的参考

在运行程序期间设置版本信息

大部分的程序在运行之后都会提供一个关于的按钮,通过点击该按钮并弹出一个关于界面,则可以查看相关的程序信息。此关于界面为用户自定义的一个界面。或者可以在主界面的右下角显示出当前软件的版本信息。两种方式之间并不冲突。

可以参考VS

在 QT 中设置软件版本信息的几种方法

方法一:通过 .pro 文件设置 (qmake 项目)

1. 在 .pro 文件中添加版本信息

# 设置应用程序版本
VERSION = 1.2.3

# 或者使用更详细的版本设置
VER_MAJ = 1
VER_MIN = 2
VER_PAT = 3
VERSION = $$join(VER_MAJ, ., VER_MIN, ., VER_PAT)

# Windows 资源文件设置 (可选)
win32 {
    RC_ICONS = myapp.ico
    VERSIONRC = version.rc
    RC_FILE = $$VERSIONRC
}

2. 创建 version.rc 文件 (Windows)

#include <windows.h>#引入 Windows 头文件
 
VS_VERSION_INFO VERSIONINFO#资源编译器我们要定义的是一个版本信息资源
FILEVERSION    1,1,1,0#设置文件版本号
PRODUCTVERSION 1,2,3,0#设置产品版本号,代表整体产品的版本(可和文件版本不同)
FILEFLAGSMASK 0x3fL#掩码(Mask)用于指定有效的标志位(file flags)
#ifdef _DEBUG#设置文件标志(FileFlags),表示程序构建的状态
FILEFLAGS 0x1L
#else
FILEFLAGS 0x0L
#endif
FILEOS 0x40004L#设置目标操作系统
FILETYPE 0x1L#设置文件类型,0x1L 表示 VFT_APP,应用程序(EXE)
FILESUBTYPE 0x0L#子类型,应用程序通常为 0x0L(无子类型)。
BEGIN#开始版本资源的内容定义#语言和字符集标识符:0409:表示语言为英文(美国 English - United States)04b0:表示 Unicode 编码页(1200)
    BLOCK "StringFileInfo"
    BEGIN
        BLOCK "040904b0"
        BEGIN
            VALUE "CompanyName", "HXQ"
            VALUE "FileDescription", "HXQ Robot Vision 2025"
            VALUE "FileVersion", "1.1.1.0"
            VALUE "InternalName", "HXQ Robot Vision 2025"#内部名称,通常为项目名。
            VALUE "LegalCopyright", "@HXQ Corporation.All rights reserved. "#版权信息。
            VALUE "OriginalFilename", "HXQ Robot Vision 2025.exe"#原始文件名,即编译时生成的文件名。
            VALUE "ProductName", "HXQ Robot Vision 2025"# 产品名称。
            VALUE "ProductVersion", "1.1.1.0"# 字符串形式的产品版本。
        END
    END
    BLOCK "VarFileInfo"
    BEGIN
        VALUE "Translation", 0x409, 1200
    END
END

方法二:通过 CMake 设置 (CMake 项目)

1. 在 CMakeLists.txt 中设置版本

# 设置项目版本
set(PROJECT_VERSION_MAJOR 1)
set(PROJECT_VERSION_MINOR 2)
set(PROJECT_VERSION_PATCH 3)
project(YourApp VERSION ${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH})

# 配置版本头文件
configure_file(
    "${CMAKE_CURRENT_SOURCE_DIR}/version.h.in"
    "${CMAKE_CURRENT_BINARY_DIR}/version.h"
)

# Windows 资源文件
if(WIN32)
    set(RC_FILE "${CMAKE_CURRENT_SOURCE_DIR}/version.rc")
    configure_file("${RC_FILE}.in" "${RC_FILE}")
    set(APP_ICON "${CMAKE_CURRENT_SOURCE_DIR}/myapp.ico")
    list(APPEND SOURCES "${RC_FILE}")
endif()

2. 创建 version.h.in 文件

#ifndef VERSION_H
#define VERSION_H

#define PROJECT_VERSION_MAJOR @PROJECT_VERSION_MAJOR@
#define PROJECT_VERSION_MINOR @PROJECT_VERSION_MINOR@
#define PROJECT_VERSION_PATCH @PROJECT_VERSION_PATCH@
#define PROJECT_VERSION "${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}.${PROJECT_VERSION_PATCH}"

#endif // VERSION_H

方法三:运行时设置和获取版本信息

在代码中获取版本信息

#include <QApplication>
#include <QVersionNumber>
#include <QDebug>

void checkVersion()
{
    // 获取应用程序版本
    QString versionStr = QApplication::applicationVersion();
    qDebug() << "Application version:" << versionStr;
    
    // 使用 QVersionNumber 进行版本比较
    QVersionNumber currentVersion = QVersionNumber::fromString(versionStr);
    QVersionNumber minRequiredVersion(1, 0, 0);
    
    if(currentVersion < minRequiredVersion) {
        qWarning() << "This version is too old!";
    }
    
    // 获取其他元数据
    qDebug() << "Application name:" << QApplication::applicationName();
    qDebug() << "Organization:" << QApplication::organizationName();
}

最佳实践建议

  • 单一真实来源:确保版本信息只有一个来源,避免多处定义导致不一致

  • 自动化版本更新

    • 使用构建系统自动递增版本号

    • 集成到 CI/CD 流程中

  • 版本格式

    • 遵循语义化版本控制 (SemVer) 规范 (MAJOR.MINOR.PATCH)

    • 例如:1.2.3 表示主版本1,次版本2,修订版本3

  • 显示版本信息

    • 在"关于"对话框中显示完整版本信息

    • 在日志中输出版本信息以便调试

  • Windows 特殊处理

    • 确保资源文件中的版本与应用程序版本一致

    • 版本资源会影响文件属性中的版本信息

完整示例:在"关于"对话框中显示版本

#include <QMessageBox>
#include <QApplication>

void showAboutDialog()
{
    QString aboutText = QString(
        "<h2>%1</h2>"
        "<p>版本: %2</p>"
        "<p>Copyright © 2023 %3. 保留所有权利。</p>"
        "<p>了解更多: <a href='https://www.yourcompany.com'>www.yourcompany.com</a></p>")
        .arg(QApplication::applicationDisplayName(),
             QApplication::applicationVersion(),
             QApplication::organizationName());
    
    QMessageBox::about(nullptr, "关于", aboutText);
}

对于大多数 QT 项目,方法一或方法二结合方法三是最常用的方式。

到此这篇关于Qt 设置软件版本信息的实现的文章就介绍到这了,更多相关Qt 设置软件版本信息内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • 漫谈C++哈夫曼树的原理及实现

    漫谈C++哈夫曼树的原理及实现

    给定N个权值作为N个叶子结点,构造一棵二叉树,若该树的带权路径长度达到最小,称这样的二叉树为最优二叉树,也称为哈夫曼树(Huffman Tree)。本文将通过图片为大家详细讲讲C++哈夫曼树的原理及实现,需要的可以参考一下
    2022-08-08
  • 在C++中把字符串转换为整数的两种简单方法

    在C++中把字符串转换为整数的两种简单方法

    经常会遇到类型转换,本文主要介绍了C++中把字符串转换为整数的两种简单方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • C语言实现贪吃蛇游戏代码

    C语言实现贪吃蛇游戏代码

    这篇文章主要为大家详细介绍了C语言实现贪吃蛇游戏代码,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-09-09
  • MFC实现连连看游戏之消子算法

    MFC实现连连看游戏之消子算法

    这篇文章主要为大家详细介绍了MFC实现连连看游戏之消子算法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-01-01
  • C++图文并茂分析讲解内存管理

    C++图文并茂分析讲解内存管理

    本章主要介绍C语言与C++的内存管理,以C++的内存分布作为引入,介绍C++不同于C语言的内存管理方式(new delete对比 malloc free),感兴趣的朋友来看看吧
    2022-09-09
  • C语言的fork函数在Linux中的进程操作及相关面试题讲解

    C语言的fork函数在Linux中的进程操作及相关面试题讲解

    fork函数只能在类Unix的系统中使用,用于创建子线程,这里总结了C语言的fork函数在Linux中的进程操作及相关面试题讲解,先来看一下C语言程序的存储空间与进程示意:
    2016-06-06
  • C++常见获取随机数的方法小结

    C++常见获取随机数的方法小结

    这篇文章主要介绍了C++常见获取随机数的方法,结合实例形式总结分析了C++获取随机数的几种常见方法与相关操作注意事项,需要的朋友可以参考下
    2018-05-05
  • opencv平均背景法详解

    opencv平均背景法详解

    这篇文章主要为大家详细介绍了opencv平均背景法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-03-03
  • C++ min/max_element 函数用法详解

    C++ min/max_element 函数用法详解

    这篇文章主要介绍了C++ min/max_element 函数用法,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-02-02
  • C++浅析函数重载是什么

    C++浅析函数重载是什么

    C++ 允许多个函数拥有相同的名字,只要它们的参数列表不同就可以,这就是函数的重载(Function Overloading),借助重载,一个函数名可以有多种用途
    2022-08-08

最新评论