开发者

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

开发者 https://www.devze.com 2025-06-23 11:44 出处:网络 作者: 好鑫晴9899
目录在运行程序期间设置版本信息可以参考VS在 QT 中设置软件版本信息的几种方法方法一:通过 .pro 文件设置 (qmake 项目)方法二:通过 CMake 设置 (CMake 项目)方法三:运行时设置和获取版本信息最佳实践建议完整示例
目录
  • 在运行程序期间设置版本信息
  • 可以参考VS
  • 在 QT 中设置软件版本信息的几种方法
    • 方法一:通过 .pro 文件设置 (qmake 项目)
    • 方法二:通过 CMake 设置 (CMake 项目)
    • 方法三:运行时设置和获取版本信息
    • 最佳实践建议
  • 完整示例:在"关于"对话框中显示版本

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

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

    可以参考VS

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

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

    在 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#设置文件版本号
    PRODUCTVERandroidSION 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)js04b0:表示 Unicode 编码页(1200)
        block "StringFileInfo"
        BEGIN
            BLOCK "040904b0"
            BEGIN
                VALUE "CompanyName", "HXQ"
                VALUE "FileDescription", "HXQ Robot Vision 2025"
                VALUE "FileVersion", "1.1.1.0"
                VALUE "In编程客栈ternalName", "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&phpgt;
    #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 aboutTexandroidt = 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 设置软件版本信息内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)!

    0

    精彩评论

    暂无评论...
    验证码 换一张
    取 消

    关注公众号