在工业软件、设备配置工具或上位机系统中，**固件升级（Firmware Upgrade）**是一个非常常见但又容易出问题的功能点。
典型需求包括：
- 调用厂商提供的 Windows DLL 执行升级
- 升级过程不能阻塞 UI
- 实时显示升级进度
- 升级过程中禁止用户误操作
- 升级完成后给出明确反馈
本文通过一个真实工程级示例，完整讲解如何使用Qt + Windows DLL实现一个可靠的固件升级进度弹窗。
一、应用场景说明（为什么要这样做）
在实际项目中，固件升级逻辑通常由硬件厂商提供的 DLL完成，例如：
- LVDS / V-by-One 显示控制器
- FPGA / MCU 配置工具
- 工控采集设备
- 显示驱动板卡升级程序
Qt 作为上位机 UI 层，只负责：
- 加载 DLL
- 调用升级接口
- 显示升级状态
- 控制用户交互
升级过程本身必须在后台线程执行，否则 UI 会卡死。
二、设计思路概览
整体架构如下：
- 使用
LoadLibrary / GetProcAddress动态加载 DLL - 在后台线程中调用升级函数
- 通过定时器轮询 DLL 中的升级进度接口
- 使用
QDialog + QProgressBar显示进度 - 升级完成后释放 DLL 并允许用户关闭窗口
这是工业软件中最常见、最稳定的一种升级实现方式。
三、DLL 接口定义说明
假设厂商 DLL 中提供如下接口：
// 启动固件升级voidUploadProgram(constchar*filePath);// 查询升级进度（0 ~ 100）intGetUploadProgramSchedule();Qt 端通过函数指针方式调用。
四、核心实现代码（完整案例）
1. 函数整体结构
voidLVDSVbyOneSignalCollector::firmwareUpInformationBox(QString path)该函数的职责是：
- 弹出升级对话框
- 启动固件升级
- 显示升级进度
- 等待升级完成
2. 动态加载 DLL
HMODULE hDll=LoadLibraryA("LVDSVbyOneSignalCollectorDLL.dll");if(!hDll){return;}autopUploadProgram=(PFN_UploadProgram)GetProcAddress(hDll,"UploadProgram");autopGetUploadProgramSchedule=(PFN_GetUploadProgramSchedule)GetProcAddress(hDll,"GetUploadProgramSchedule");if(!pUploadProgram||!pGetUploadProgramSchedule){FreeLibrary(hDll);return;}为什么使用动态加载？
- DLL 由第三方提供
- 可选功能模块
- 避免启动时强依赖
- 方便版本替换
3. 构建升级 UI（不可中断）
QDialog*dialog=newQDialog(nullptr);dialog->setWindowTitle(tr("Firmware Upgrade"));dialog->setWindowModality(Qt::ApplicationModal);dialog->setFixedSize(360,140);// 禁止右上角关闭dialog->setWindowFlags(dialog->windowFlags()&~Qt::WindowCloseButtonHint);这是一个应用级模态窗口，升级过程中用户无法操作主界面。
4. UI 元素布局
QLabel*label=newQLabel(tr("Upgrading firmware, please wait..."),dialog);QProgressBar*progressBar=newQProgressBar(dialog);progressBar->setRange(0,100);progressBar->setValue(0);QPushButton*btnOk=newQPushButton(tr("OK"),dialog);btnOk->setEnabled(false);升级未完成前，OK 按钮不可点击，避免误关闭。
5. 后台线程执行升级（关键）
QFuture<void>future=QtConcurrent::run([=](){pUploadProgram(rInfor.filePath);});这里使用QtConcurrent::run的目的非常明确：
- 避免 UI 阻塞
- 升级逻辑与界面解耦
- 不需要手写 QThread
这是 Qt 工程中推荐的做法之一。
6. 使用 QTimer 轮询升级进度
QTimer*timer=newQTimer(dialog);QObject::connect(timer,&QTimer::timeout,dialog,[=](){intvalue=pGetUploadProgramSchedule();// 0~100progressBar->setValue(value);if(future.isFinished()){timer->stop();progressBar->setValue(100);label->setText(tr("Firmware upgrade completed."));btnOk->setEnabled(true);FreeLibrary(hDll);}});timer->start(300);这种设计的优点：
- 不需要 DLL 回调
- 逻辑简单、稳定
- 工业项目中极其常见
7. 升级完成后退出
QObject::connect(btnOk,&QPushButton::clicked,dialog,[=](){dialog->accept();dialog->deleteLater();});只有在升级完成后，用户才能关闭窗口。
五、工程级注意事项（非常重要）
1️⃣ 文件路径生命周期问题
std::string str=path.toStdString();rInfor.filePath=str.c_str();如果 DLL 在内部异步使用该指针，这里存在风险。
更安全的方式是保证字符串长期有效（如成员变量或深拷贝）。
2️⃣ DLL 卸载时机
FreeLibrary必须确保：
- 升级线程完全结束
- DLL 内部没有残留线程
否则可能导致随机崩溃。
3️⃣ 建议增加失败与超时处理
生产环境中建议补充：
- 升级失败状态
- 超时检测
- 错误码提示
- 日志记录
六、总结
本文通过一个真实工业项目中的固件升级案例，展示了：
- Qt 如何调用 Windows DLL
- 如何在后台线程执行耗时任务
- 如何安全地显示升级进度
- 如何设计不可中断的升级 UI
这种结构在工业上位机 / 设备工具 / 显示控制软件中非常通用，具有很高的工程参考价值。
voidLVDSVbyOneSignalCollector::firmwareUp(){QMessageBox msgBox;msgBox.setWindowTitle("提示");msgBox.setText("你确定要继续吗？");msgBox.setIcon(QMessageBox::Question);msgBox.setStandardButtons(QMessageBox::Ok|QMessageBox::Cancel);msgBox.button(QMessageBox::Ok)->setText("更新");msgBox.button(QMessageBox::Cancel)->setText("取消");intret=msgBox.exec();if(ret==QMessageBox::Ok){qDebug()<<"用户点击了确定按钮";QString path=ui.lineEdit_bootPath->text();QFileInfofileInfo(path);if(fileInfo.exists()){if(fileInfo.isDir()){qDebug()<<"路径是有效的目录";}elseif(fileInfo.isFile()){qDebug()<<"路径是有效的文件";}}else{qDebug()<<"路径无效";QMessageBox::information(this,"path",QString("The path is invalid."));return;}firmwareUpInformationBox(path);}elseif(ret==QMessageBox::Cancel){qDebug()<<"用户点击了关闭按钮";}}voidLVDSVbyOneSignalCollector::firmwareUpInformationBox(QString path){HMODULE hDll=LoadLibraryA("LVDSVbyOneSignalCollectorDLL.dll");if(!hDll){return;}PFN_UploadProgram pUploadProgram=(PFN_UploadProgram)GetProcAddress(hDll,"UploadProgram");PFN_GetUploadProgramSchedule pGetUploadProgramSchedule=(PFN_GetUploadProgramSchedule)GetProcAddress(hDll,"GetUploadProgramSchedule");if(!pUploadProgram||!pGetUploadProgramSchedule){FreeLibrary(hDll);return;}std::string str=path.toStdString();rInfor.filePath=str.c_str();/* ================== UI ================== */QDialog*dialog=newQDialog(nullptr);dialog->setWindowTitle(tr("Firmware Upgrade"));dialog->setWindowModality(Qt::ApplicationModal);dialog->setFixedSize(360,140);// 禁止关闭dialog->setWindowFlags(dialog->windowFlags()&~Qt::WindowCloseButtonHint);QLabel*label=newQLabel(tr("Upgrading firmware, please wait..."),dialog);QProgressBar*progressBar=newQProgressBar(dialog);progressBar->setRange(0,100);progressBar->setValue(0);QPushButton*btnOk=newQPushButton(tr("OK"),dialog);btnOk->setEnabled(false);// 完成前不可点击QVBoxLayout*layout=newQVBoxLayout(dialog);layout->addWidget(label);layout->addWidget(progressBar);layout->addWidget(btnOk,0,Qt::AlignRight);dialog->setLayout(layout);dialog->show();/* ================== 后台线程 ================== */QFuture<void>future=QtConcurrent::run([=](){pUploadProgram(rInfor.filePath);});/* ================== 进度轮询 ================== */QTimer*timer=newQTimer(dialog);QObject::connect(timer,&QTimer::timeout,dialog,[=](){intvalue=pGetUploadProgramSchedule();// 0~100progressBar->setValue(value);if(future.isFinished()){timer->stop();progressBar->setValue(100);label->setText(tr("Firmware upgrade completed."));btnOk->setEnabled(true);FreeLibrary(hDll);}});timer->start(300);/* ================== 完成后退出 ================== */QObject::connect(btnOk,&QPushButton::clicked,dialog,[=](){dialog->accept();dialog->deleteLater();});}
