Qt 5.x 应用程序 Windows 部署方法

关注

转载最新推荐文章于 2026-08-13 08:22:49 发布 772 阅读 AI 写同款· GEO 优化 ›

QT使用qt.conf文件来部署应用程序 后经查证是没有macdeployqt进行部署，程序内没有平台依赖库Plugins文件Qt程序启动时会用QLibraryInfo类载入qt.conf文件，按下面的路径顺序搜索：资源系统， :/qt/etc/qt.confMac系统下会在资源目录，例如：assistant.app/Contents/Resources/qt.conf执行档所在目录，如：QCoreApplication::applicationDirPath()+QDir::seperator()+”qt.conf” 阅读详情

使用 Qt 5.2.1 开发了一个程序之后，部署竟然用了我很长时间来调试。现在总算搞明白了。

1、源代码使用 UTF-8 编码格式，对于 VC++ 2010 来说，创建并引入头文件 charset.h：

[cpp]view plaincopy 
    
 #pragma once  
   
 // VC 2010 以后，要求源码设置 UTF-8 BOM  
 #if defined(_MSC_VER) && (_MSC_VER >= 1600)  
 # pragma execution_character_set("utf-8")  
 #endif  

只要是源代码中使用了中文，都要引入这个头文件。

使用 UTF-8，必须使用如下 DLL：

[plain]view plaincopy 
    
 icudt51.dll  
 icuin51.dll  
 icuuc51.dll  

2、必须的 DLL，比如：

[plain]view plaincopy 
    
 Qt5Core.dll  
 Qt5Gui.dll  
 Qt5Network.dll  
 Qt5Sql.dll  
 Qt5Websockets.dll  
 Qt5Widgets.dll  
 ...  

3、VC++ 2010 Redistribution Package x86

4、由于 Qt 使用了　Qt 5.2.1 for Windows 32-bit (VS 2010, OpenGL, 517 MB) 这个版本，因此还需要

[plain]view plaincopy 
    
 libEGL.dll  
 LibGLESv2.dll  
 D3DCompiler_43.dll  

起初不知道需要这些文件，部署后总是报 This application failed to start because it could not find or load the Qt platform plugin "windows".

还以为是插件目录的问题，折腾了好久，总是不正确，后来在 QtCreator 目录中发现这些 dll，复制过来。

5、插件配置

⑴在应用程序 app.exe 目录下创建插件子目录，类似如下目录结构：

[plain]view plaincopy 
    
 ./bin/app.exe  
 ./bin/platforms  

将 Qt 系统目录中的相应子目录复制过来，文件包括：

[plain]view plaincopy 
    
 qminimal.dll  
 qoffscreen.dll  
 qwindows.dll  
 ...  

⑵使用 Qt 设置库目录的 API：

[cpp]view plaincopy 
    
 QStringList libraryPaths = QStringList()  
                                << qApp->applicationDirPath()  
                                << qApp->applicationDirPath().append("/plugins");  
 QApplication::setLibraryPaths(libraryPaths);  

或者：

[cpp]view plaincopy 
    
 QApplication::addLibraryPath(“./plugins”);  

⑶使用资源文件 app.qrc，将 qt.conf 配置文件作为资源，加入路径 :/qt/etc/qt.conf，

Qt5Core.dll 加载时默认访问这个配置文件。

⑷使用外部 qt.conf 配置文件

qt.conf 放置于 app.exe 所在目录，内容如下：

[plain]view plaincopy 
    
 [Paths]  
 Plugins=./plugins  

6、总结，

以上设置如果不正确，从而找不到 platforms 目录时，会报 This application failed to start because it could not find or load the Qt platform plugin "windows".这个错误。

Qt 5.x 应用程序 Windows 部署方法

相关推荐