Qt for Windows - 構建從源

此頁麵描述瞭配置和構建的過程,針對 Qt for Windows 。在構建之前,有一些要求更詳細給齣在 Qt for Windows - 要求 文檔。

可以下載 Qt 5 源代碼,從 下載 頁麵。更多信息,拜訪 Qt 快速入門 頁麵。

步驟 1:安裝許可文件 (僅商業許可的 Qt)

若在商業許可下使用 Qt,則 Qt 工具會查找本地許可文件。若正使用二進製安裝程序或商用 Qt Creator,則會自動取齣許可並存儲在本地用戶 Profile (配置文件) 中 ( %USERPROFILE%\AppData\Roaming\Qt\qtlicenses.ini file).

若不使用任何二進製安裝程序或 Qt Creator,可以下載各自的許可文件從您的 Qt 帳戶 Web 門戶並將其保存到您的用戶 Profile (配置文件) 作為 %USERPROFILE%\.qt-license 。若偏愛不同的位置或文件名,需要設置 QT_LICENSE_FILE 環境變量到各個文件路徑。

步驟 2:解包存檔

把文件解壓到要安裝 Qt 的目錄;如 C:\Qt\%VERSION% .

注意: 安裝路徑不得包含任何空格或 Windows 特定文件係統字符。

步驟 3:設置環境變量

我們推薦創建桌麵鏈接打開命令提示,采用的環境設置類似 命令提示 菜單條目提供通過 Visual Studio。這是通過創建應用程序鏈接完成,傳遞 .cmd 文件設置環境和命令行選項 /k (保持打開) 給 cmd.exe .

假定文件名為 qt5vars.cmd 和 Qt 文件夾名為 qt-5 及位於 C:\qt :

REM Set up \Microsoft Visual Studio 2017, where <arch> is \c amd64, \c x86, etc.
CALL "C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Auxiliary\Build\vcvarsall.bat" <arch>
SET _ROOT=C:\qt\qt-5
SET PATH=%_ROOT%\qtbase\bin;%_ROOT%\gnuwin32\bin;%PATH%
REM Uncomment the below line when using a git checkout of the source repository
REM SET PATH=%_ROOT%\qtrepotools\bin;%PATH%
SET _ROOT=
					

然後,可以創建桌麵鏈接通過指定命令 %SystemRoot%\system32\cmd.exe /E:ON /V:ON /k c:\qt\qt5vars.cmd 作為應用程序和 c:\qt\qt-5 作為工作目錄。

注意: 設置 MinGW 相似;唯一不同之處是 bin folder of the installation should be added to the path instead of calling the Visual Studio setup script. For MinGW ,請確保沒有 sh.exe 可以在路徑中被找到,因為它影響 mingw32-make .

其它庫所需的設置 (見 Qt for Windows - 要求 ) 還應將此文件放置到 Windows SDK 設置腳本的調用下。

步驟 4:構建 Qt 庫

configure 的默認行為是創建 Qt 5 的源代碼內構建。若希望將 Qt 5 安裝到單獨位置,則需要指定命令行選項 -prefix <location> 。另外,命令行選項 -developer-build 創建供開發者使用的源代碼內構建。

為您的機器的調試構建配置 Qt 庫,在命令提示後鍵入以下命令:

configure -debug -nomake examples -nomake tests -skip qtwebengine -opensource
					

The 配置選項 頁麵包含有關 configure 選項的更多信息。

要構建 Qt 使用 jom ,鍵入:

jom
					

若沒有 jom 安裝,鍵入:

nmake
					

For MinGW ,鍵入:

mingw32-make
					

若給定瞭安裝前綴,鍵入 jom install , nmake install or mingw32-make install .

注意: 若以後需要在相同位置重新配置和重構 Qt,確保移除所有先前配置痕跡,通過進入構建目錄並鍵入 nmake distclean 先於運行 configure 再次。

並行構建

jom 置換 nmake ,充分利用所有 CPU 核心,從而加速構建。