当前位置：首页 > news >正文

QT6实战：从Qt Creator 13到Qt Design Studio 4的桌面应用一站式发布指南

news 2026/4/25 15:09:17

1. 从零搭建Qt6开发环境

第一次接触Qt6开发的朋友可能会被各种工具链搞晕，其实只需要三个核心组件：Qt Creator 13作为代码编辑器、Qt Design Studio 4负责UI设计、以及Qt6框架库本身。我建议直接从Qt官网下载在线安装器，勾选这三个组件即可。安装时有个小技巧：记得同时勾选CMake和MinGW工具链，这是后续项目构建的关键。

安装完成后，建议先做个简单的环境验证。打开Qt Creator，新建一个"Qt Quick Application"项目，直接点击运行。如果能看到一个空白窗口弹出，说明基础环境已经配置正确。这里有个容易踩的坑：有些朋友会遇到"qml module not found"错误，这通常是因为Qt Creator没有正确关联Qt6的qml路径，需要在项目的运行配置中手动指定qml目录。

2. 创建跨工具协作的项目结构

2.1 在Qt Creator中初始化项目

新建项目时选择"Qt Quick Application - CMake"，这个模板会自动生成适合Qt6的项目骨架。我习惯在项目根目录下创建三个子目录：

/src存放C++源码
/ui存放QML设计文件
/assets放图标等资源文件

关键是要在CMakeLists.txt中正确配置QML模块路径：

qt_add_qml_module(${PROJECT_NAME} URI Main VERSION 1.0 QML_FILES ui/main.qml RESOURCES assets/icons/main.png )

2.2 与Qt Design Studio协同工作

在Qt Design Studio中打开项目时，要特别注意文件同步问题。我推荐使用Git进行版本控制，两个工具都内置了Git支持。每次在Design Studio中修改完UI后，记得执行：

保存所有.qml文件
在Git面板提交变更
回到Qt Creator拉取最新修改

3. 定制化你的应用程序

3.1 设置应用程序图标

Windows平台需要准备.ico格式的图标文件。我常用一个在线工具将png转换为包含多种尺寸的ico文件。把图标放在assets目录后，需要在CMake中声明资源文件：

qt_add_resources(${PROJECT_NAME} "app_icon" PREFIX "/" FILES assets/icons/main.ico )

然后在main.cpp中加载图标：

QGuiApplication app(argc, argv); app.setWindowIcon(QIcon(":/main.ico"));

3.2 隐藏控制台窗口

对于GUI程序，控制台窗口是多余的。在CMakeLists.txt中加入以下配置：

if(WIN32) set_target_properties(${PROJECT_NAME} PROPERTIES WIN32_EXECUTABLE TRUE LINK_FLAGS "/ENTRY:mainCRTStartup" ) endif()

4. 构建与发布实战

4.1 Release模式构建技巧

在Qt Creator中构建Release版本时，建议先执行以下操作：

点击左侧"项目"按钮
在构建配置中选择"Release"
勾选"Shadow build"（建议使用独立构建目录）
在CMake配置中添加优化参数：

set(CMAKE_CXX_FLAGS_RELEASE "-O3 -DNDEBUG")

4.2 自动化部署依赖项

windeployqt工具是Qt自带的部署神器，但有几个实用参数经常被忽略：

windeployqt MyApp.exe --qmldir qml --no-translations --compiler-runtime

--no-translations跳过不需要的翻译文件
--compiler-runtime自动包含VC++运行时库

4.3 一键打包批处理脚本

这是我优化过的部署脚本，增加了版本号和清理旧文件功能：

@echo off set BUILD_DIR=build\release set DEPLOY_DIR=deploy\v1.0 set QT_BIN=C:\Qt\6.8.0\mingw_64\bin :: 清理旧部署文件 if exist "%DEPLOY_DIR%" ( rmdir /s /q "%DEPLOY_DIR%" ) :: 创建部署目录 mkdir "%DEPLOY_DIR%" :: 复制可执行文件 copy "%BUILD_DIR%\MyApp.exe" "%DEPLOY_DIR%" :: 部署Qt依赖项 call "%QT_BIN%\windeployqt.exe" "%DEPLOY_DIR%\MyApp.exe" --qmldir qml :: 创建快捷方式 powershell -Command "$ws = New-Object -ComObject WScript.Shell; $sc = $ws.CreateShortcut('%DEPLOY_DIR%\MyApp.lnk'); $sc.TargetPath='%DEPLOY_DIR%\MyApp.exe'; $sc.IconLocation='%DEPLOY_DIR%\MyApp.exe,0'; $sc.Save()"

5. 高级调试技巧

发布后如果遇到程序崩溃，可以配置Windows错误报告生成dump文件。在main.cpp中添加：

#include <windows.h> #include <dbghelp.h> LONG WINAPI crashHandler(EXCEPTION_POINTERS* pExp) { HANDLE hFile = CreateFile(L"crash.dmp", GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL); MINIDUMP_EXCEPTION_INFORMATION ei; ei.ThreadId = GetCurrentThreadId(); ei.ExceptionPointers = pExp; ei.ClientPointers = FALSE; MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(), hFile, MiniDumpNormal, &ei, NULL, NULL); CloseHandle(hFile); return EXCEPTION_EXECUTE_HANDLER; } int main(int argc, char *argv[]) { SetUnhandledExceptionFilter(crashHandler); // ...原有代码 }

6. 跨平台打包方案

虽然本文以Windows为例，但Qt6的跨平台特性同样强大。对于macOS平台，可以使用macdeployqt工具；Linux平台则建议使用AppImage或Snapcraft打包。在CMake中可以通过条件判断实现多平台配置：

if(APPLE) set_target_properties(${PROJECT_NAME} PROPERTIES MACOSX_BUNDLE TRUE MACOSX_BUNDLE_ICON_FILE main.icns ) elseif(UNIX AND NOT APPLE) install(TARGETS ${PROJECT_NAME} DESTINATION bin) endif()

在实际项目中，我通常会为每个平台编写单独的部署脚本，并通过CI/CD工具自动执行打包流程。例如使用GitHub Actions可以同时构建Windows、macOS和Linux三个平台的发布包。

查看全文

http://www.jsqmd.com/news/698492/