生成 Windows 预构建包
约 1202 字
为了让没有安装 C++ 开发环境、Qt6 或 CMake 的队员(如硬件组、机械组、现场调车人员)能够直接在任意 Windows 电脑上使用 Aurora 测车软件,Lumina 提供了针对 Windows x64 的自动化便携发布打包方案。
打包脚本会自动编译 Release 版本的程序,并完整收集所有依赖的 Qt6 运行时、QML 组件、FluentUI 插件以及 Visual C++ 运行库(CRT),打包成开箱即用的 .zip 绿色便携压缩包。
1. 打包机环境要求
执行打包的电脑(开发机)需要具备以下环境:
- 操作系统:Windows 10 / 11 64 位。
- 构建编译器:Visual Studio 2022(需勾选
使用 C++ 的桌面开发,安装 MSVC v143 x64 生成工具)。 - Qt6 开发库:Qt 6.x MSVC 2022 64-bit(例如 Qt 6.11.x 或 Qt 6.12.x),需自带
windeployqt.exe。 - CMake:CMake 3.20 或更高版本(通常随 Visual Studio 或 Qt 安装)。
- FluentUI 模块:Release 编译版本的 FluentUI 动态库和 QML 组件,默认位于项目的
share/qml/FluentUI/,必须包含fluentuiplugin.dll与qmldir。
独立构建特性
Aurora 测车软件在架构设计上与 Lumina 的主策略系统(Medusa、CUDA、Protobuf、vcpkg 等)解耦。因此,单独打包 Aurora 不需要安装 CUDA、ROCm 或配置主系统的庞大依赖,仅需标准的 Qt6 + MSVC 环境即可完成。
2. 一键打包命令
在 Lumina 仓库根目录下,打开 PowerShell 终端,执行以下脚本即可:
powershell -ExecutionPolicy Bypass -File scripts/package-aurora.ps1可选自定义参数
打包脚本支持传入参数以适配不同的本地路径和版本号:
powershell -ExecutionPolicy Bypass -File scripts/package-aurora.ps1 `
-QtRoot "E:\Qt\6.11.1" `
-Version "0.0.2" `
-FluentUiDirectory "share\qml\FluentUI" `
-Jobs 8| 参数名称 | 默认值 | 说明 |
|---|---|---|
-QtRoot | E:\Qt\6.12.0 | Qt 安装根目录(脚本会自动在其子目录查找 msvc2022_64) |
-Version | 0.0.1 | 发布版本号,需遵循 x.y.z 语义化版本格式 |
-FluentUiDirectory | share\qml\FluentUI | Release 版本 FluentUI 模块所在的目录 |
-Jobs | 8 | CMake 编译时的并行构建线程数 |
3. 打包内部流程与机制
脚本 scripts/package-aurora.ps1 采用严格的隔离式打包策略,保证产物的纯净性:
关键步骤解析
- 环境与依赖嗅探: 通过
vswhere.exe自动定位 Visual Studio 2022 的安装路径,并定位最新的Microsoft.VC143.CRT运行库目录;检查 Qt 编译器和windeployqt.exe。 - 独立 Release 构建: 在独立的
build-aurora-release目录中完成 CMake 配置与编译,与日常开发的构建产物隔离,避免覆盖ZBin/。 - 隔离暂存区生成: 每次打包都会在
dist/下生成一个带有随机 GUID 编号的独立目录(例如dist/aurora-dbb6c769.../Aurora-0.0.1-windows-x64/),确保不会混入旧版本或 Debug 模式的中间残留文件。 - Qt 运行时部署: 使用
windeployqt.exe分析Aurora/src/qml与FluentUI中的 QML 导入语句,精简提取所需的 Qt 动态库、平台插件(platforms/qwindows.dll)和图片支持库。 - 内嵌应用程序本地 CRT: 将
msvcp140.dll、vcruntime140.dll等 C++ 运行库直接拷贝至程序根目录,避免接收方因系统缺失运行库而弹出找不到 MSVCP140.dll的报错。 - 运行时路径配置 (
qt.conf): 自动写入qt.conf:使得程序在被移动或解压到任意文件夹后,均能正确定位同级目录下的 Qt 插件和 QML 依赖。[Paths] Prefix=. Plugins=. QmlImports=qml - 完整性自检与校验码生成: 检查关键 DLL 文件是否存在;最终将整个目录压缩为
.zip,并生成对应的.zip.sha256校验和文件。
4. 产物交付与验证
打包完成后,产物输出在 dist/aurora-<唯一编号>/ 目录下:
dist/
└── aurora-dbb6c769918d4c47b7cabe3f56b700b7/
├── Aurora-0.0.1-windows-x64/ # 解压后的便携程序目录
├── Aurora-0.0.1-windows-x64.zip # 便携式分发压缩包
└── Aurora-0.0.1-windows-x64.zip.sha256 # SHA-256 校验文件交付说明
- 将生成的
Aurora-x.x.x-windows-x64.zip发送给使用人员。 - 提醒收件人:必须将压缩包完整解压到本地文件夹后再双击运行
Aurora.exe。 - 硬件驱动提示:如果目标电脑是第一次使用无线发射机,需要安装对应的 USB 转串口芯片驱动(如 CH340 / CP210x)。
- 建议在发布前,在未安装 Qt 和 Visual Studio 的干净 Windows 机器上测试界面的启动与串口连接。
贡献者
更新日志
2026/10/31 22:50
查看所有更新日志
ceb7f-Aurora 教程于