打包Qt程序的脚本package.bat

要将 Qt Release 编译后的程序打包成绿色工具(即免安装、可直接拷贝运行的文件夹),需要复制程序依赖的 Qt 库、运行时库,并通过工具自动收集依赖。以下是不同场景的打包命令 / 步骤(Windows 环境):

一、基础场景:用 windeployqt 自动收集依赖(推荐)

windeployqt 是 Qt 自带的工具,能自动识别 Release 程序依赖的 Qt 库、插件、运行时文件,一键生成绿色包。

操作步骤:

编译 Release 程序:

在 Qt Creator 中选择「Release」模式,编译项目,生成 xxx.exe(路径:项目目录/build-xxx-Release/release/xxx.exe)。

打开 Qt 命令行终端:

从开始菜单启动「Qt 5.15.x (MinGW 8.1.0 64-bit)」或「Qt 5.15.x (MSVC 2019 64-bit)」终端(必须用对应编译器的终端,否则路径不对)。

执行 windeployqt 命令:

bash

运行

步骤1:切换到 Release 程序所在目录

cd /d 项目目录/build-xxx-Release/release

步骤2:执行打包命令(生成绿色包到当前目录)

windeployqt xxx.exe

补充系统运行时库:

若用 MinGW 编译:需手动拷贝 MinGW 的运行时库(路径:Qt安装目录/5.15.2/mingw81_64/bin/ 下的 libgcc_s_seh-1.dll、libstdc+±6.dll、libwinpthread-1.dll)到绿色包目录。

若用 MSVC 编译:需确保目标电脑已安装 Visual C++ 2019 运行库,或手动拷贝 MSVC 运行时库(如 vcruntime140.dll)到绿色包目录。

二、进阶场景:用脚本一键打包(含运行时 + 压缩)

可写一个批处理脚本,自动完成 windeployqt、拷贝运行时、压缩绿色包的流程:

示例脚本(package.bat ):

batch

@echo off

set "QT_PATH=D:\Qt\5.15.2\mingw81_64" # 替换为你的Qt安装路径

set "EXE_PATH=项目目录/build-xxx-Release/release/xxx.exe" # 替换为你的Release程序路径

set "OUT_DIR=绿色包输出目录" # 替换为输出目录

:: 1. 创建输出目录

mkdir "%OUT_DIR%"

:: 2. 复制Release程序到输出目录

copy "%EXE_PATH%" "%OUT_DIR%"

:: 3. 用windeployqt收集Qt依赖

call "%QT_PATH%\bin\windeployqt.exe" "%OUT_DIR%\xxx.exe" --release --no-translations

:: 4. 拷贝MinGW运行时库(MinGW编译时用)

copy "%QT_PATH%\bin\libgcc_s_seh-1.dll" "%OUT_DIR%"

copy "%QT_PATH%\bin\libstdc+±6.dll" "%OUT_DIR%"

copy "%QT_PATH%\bin\libwinpthread-1.dll" "%OUT_DIR%"

:: 5. 压缩为ZIP包(可选)

powershell Compress-Archive -Path "%OUT_DIR%*" -DestinationPath "%OUT_DIR%.zip"

echo 绿色包已生成到:%OUT_DIR%

pause

三、注意事项

插件依赖:若程序用到 Qt 插件(如数据库驱动、图像格式插件),windeployqt 会自动拷贝到 plugins 目录,无需手动处理。

第三方库:若程序依赖非 Qt 的第三方库(如 OpenCV),需手动将对应的 .dll 拷贝到绿色包目录。

无控制台窗口:若程序是 GUI 程序,编译时需在 .pro 文件中添加 CONFIG += windows(MinGW)或 CONFIG += console 改为 CONFIG -= console(MSVC),避免打包后出现控制台黑框。

总结

最便捷的方式是用 windeployqt 自动收集依赖,再补充对应编译器的运行时库,即可生成可直接拷贝运行的绿色包。

相关推荐
Chester_19997 小时前
CSP202203C.计算资源调度器
开发语言·数据结构·c++·蓝桥杯
EXI-小洲8 小时前
Java 操作 Word:字符串替换、图片插入、动态生成表格与API接口下载
java·开发语言·spring boot·word
会周易的程序员8 小时前
给 PLC 写一个字节码虚拟机:STVM 虚拟机架构设计
开发语言·c++·虚拟机·软plc·iec61131·stvm
机器视觉知识推荐、就业指导8 小时前
为什么老说“纯 Qt 没啥就业市场”?
开发语言·qt
telepan8 小时前
Qt 开发避坑与性能指南:如何优雅、安全地定义全局常量字符串?
开发语言·qt
小灰灰搞电子9 小时前
完全驾驭 Qt 与数据库:C++ ORM 框架 QxOrm 原理与实践指南
数据库·c++·qt
QT界面美化性能优化9 小时前
QT+AI:使用AI技术为QT应用程序赋能
c++·人工智能·qt·opencv·qt教程·qt6.3
m0_695251499 小时前
Qt MaintenanceTool 使用国内镜像加速下载(超详细教程)
开发语言·qt
大衛說10 小时前
《Python 从入门到精通》系列总览与学习路线
开发语言·python·学习
可乐鸡翅yeah_11 小时前
hls.js 内存泄漏实战排查,直播 M3U8 长时间播放异常定位方案
开发语言·javascript·python·django·ecmascript·m3u8·m3u8在线