Qt 桌面客户端 Web 化改造与离线交付体系

技术信息

语言技术
C++、QT、JavaScript、Vue、ElementUI系统类型
Windows、Web行业分类
企业服务、开发工具

作品详情

行业场景

一套运行多年的 C++ 桌面客户端需要持续迭代界面，但原有 Qt 4.8.2 界面与绘图控件耦合紧密，每次改动都要重新编译分发，界面需求响应慢。目标环境为 Windows 7 SP1 32/64 位、全离线安装并使用硬件密钥认证，既不能引入在线依赖，也不允许升级较新的系统组件。因此立项目标是：在完整保留原有 C++ 业务与设备接口的前提下，把界面层替换为可独立迭代的 Web 前端，同时建立不依赖真机即可回归的离线交付与验收体系。

功能介绍

采用「Qt 本地 Web 服务 + 独立浏览器外壳 + Vue 2 前端」的混合架构。主要模块：① 本地 Web 服务，提供 SIM 模拟与 REAL 真实两套实现，可在无真机环境下完成联调；② 浏览器外壳负责加载本地前端资源并与原有 C++ 业务层交互；③ Vue 2 前端承担参数配置、数据展示与图表呈现，替换原有绘图控件；④ 统一构建入口产出离线安装包；⑤ 自动化验收链，包含产物特征断言、冒烟脚本、跨组接口契约门与离线安装包核验。前端内核受内嵌浏览器版本约束（Chromium 83），需禁用较新的 JS 运算符、字符串方法与 CSS 特性，采用 hash 路由并去掉路由级懒加载，以保证本地 file:// 加载不被同源策略拦截。

项目实现

独立完成混合架构设计与全栈实现，包括本地 Web 服务、独立浏览器外壳、Vue 2 前端与构建验收工具链。技术栈：C++、Qt 4/Qt 5、QtWebEngine、Vue 2、ECharts、Element UI、Windows 7 离线部署。难点：① Qt 4 与 Qt 5 双版本共存，分目录部署并各自维护配置，避免运行时加载错误；② 模拟实现与真实实现必须行为一致，否则验收结论失去意义；③ 契约门要求 SIM 与 REAL 两种判决结果一致，且每条断言都带负控——把缺陷放回去，检查必须变红，避免「mock 自洽」造成假通过。最终完成第一期改造与离线安装包，后续界面需求无需触碰原有 C++ 业务层。