Qt使用windeployqt工具實現程序打包發佈方法

Posted on by

Qt 官方開發環境使用的動態鏈接庫方式，在發佈生成的exe程序時，需要復制一大堆 dll，如果自己去復制dll，很可能丟三落四，導致exe在別的電腦裡無法正常運行。因此 Qt 官方開發環境裡自帶瞭一個工具：windeployqt.exe。

以官方 Qt 5.4.0+MinGW 開發環境為例，windeployqt工具在 %QTDIR%\Qt5.4.0\5.4\mingw491_32\bin 目錄下，其中 QTDIR 是 Qt 的安裝目錄，是環境變量。

在集成開發環境 QtCreator 中可選擇 “Qt Widgets Application” 或 “Qt Quick Application” 兩種方式生成圖形界面應用程序。

下面分別介紹這兩種方式創建應用的發佈方式。

1. Qt Widgets Application

首先用 QtCreator 新建一個 Qt Widgets Application 項目，直接用默認的 QMainWindow 程序就可以瞭，項目名字假定是 hellomw。

然後以 Release 方式編譯生成 exe 程序：

這裡寫圖片描述

生成的程序運行正常之後，找到項目的生成目錄，比如 項目源碼路徑：C:\QtPros\hellomw\ 。
它的項目生成目錄是 C:\QtPros\build-hellomw-Desktop_Qt_5_4_0_MinGW_32bit-Release\ 。
進入這個文件夾，在進入它的子文件夾 release 裡面，找到 hellomw.exe，將這個exe 復制到一個新的單獨的文件夾裡用於發佈，比如存到 D:\hellomw\ 文件夾裡面。

然後從開始菜單打開 Qt 命令行，輸入命令：cd /d D:\hellomw
然後使用 Qt安裝目錄（如D:\Qt\5.15.0\msvc2019\bin）的windeployqt 工具命令：D:\Qt\5.15.0\msvc2019\bin\windeployqt hellomw.exe

這裡寫圖片描述

然後可以在 D:\hellomw 文件夾裡看到 windeployqt 工具自動復制的插件文件夾和 dll文件、qm文件。這時候得到的就完整的 exe 程序發佈集合，依賴關系都解決好瞭。
把 D:\hellomw 文件夾 打包就可以發佈瞭，不用自己一個個找 dll 文件瞭。D:\hellomw 文件夾裡的qm文件是多國語言翻譯文件，不需要可以刪瞭，其他的都保留。

2.Qt Quick Application

首先用 QtCreator 新建一個 Qt Quick Application 項目，直接用默認的項目模版，點擊下一步生成項目，項目名字假定是 helloqml。
然後以 Release 方式編譯生成 exe 程序：

這裡寫圖片描述

然後找到項目的構建目錄，比如項目源碼目錄 C:\QtPros\helloqml 。
它的構建目錄是：C:\QtPros\build-helloqml-Desktop_Qt_5_4_0_MinGW_32bit-Release\ 。
進入這個目錄，再進入 release 子文件夾，找到 helloqml.exe ，復制到一個新的單獨的文件夾裡面，比如 D:\helloqml\ 文件夾裡面。

然後從開始菜單打開 Qt 命令行，進入D:\helloqml\文件夾：cd /d D:\helloqml
然後使用 windeployqt 工具命令：windeployqt helloqml.exe –qmldir C:\Qt\Qt5.4.0\5.4\mingw491_32\qml

這裡寫圖片描述

註意不要跟完全一樣照抄上條命令！–qmldir 是指出 Qt 庫裡面的 qml 文件夾位置，上面命令裡 C:\Qt\Qt5.4.0 是 Qt 官方開發環境安裝的文件夾，C:\Qt\Qt5.4.0\5.4\mingw491_32 是Qt類庫的目錄（QTDIR），因此使用的 –qmldir 後面寫的是 C:\Qt\Qt5.4.0\5.4\mingw491_32\qml ，讀者Qt環境安裝路徑不一樣，要根據實際情況修改！

然後可以看到 D:\helloqml 文件夾裡有一大堆文件，就是 QtQuick程序需要的依賴文件。將整個 D:\helloqml 文件夾 打包就可以發佈出去，在別的電腦上使用。
這個 D:\helloqml 文件夾裡的東西很多，看不懂就不要刪，老老實實打包發佈就行瞭。

上面是最簡單的程序發佈，實際復雜程序可能還帶一些圖片文件、數據庫文件、配置文件之類的，可以按自己需要添加這些文件到發佈文件夾裡面。

到此這篇關於Qt使用windeployqt工具實現程序打包發佈方法的文章就介紹到這瞭,更多相關Qt程序打包發佈內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：