ICU57 + Qt5.9.1 + QtWebKit在VC14下編譯

編譯所需工具

工具下載地址

Qt Source	https://download.qt.io/archive/qt/5.9/
VS Compiler	https://docs.microsoft.com/en-us/visualstudio/install/create-a-network-installation-of-visual-studio
Python	https://www.python.org/downloads/
Ruby	https://www.ruby-lang.org/en/downloads/
Perl	https://www.perl.org/get.html
ICU	http://site.icu-project.org/download

總覽（以Qt5.9.1_VC14_release_64bit為例）

• 工具環境

  • 確保編譯工具安裝目錄為默認目錄（C盤），并已將bin路徑加入Windows系統環境變量Path

  • 編譯目錄結構

    Root | |-- 5.9.1_x64.bat |-- ICU_57 | | | `--icu | |-- include | |-- lib64 | |-- bin64 | `-- ... `--qt-everywhere-opensource-src-5.9.1||--qtwebkit`-- ...

• 編譯腳本（5.9.1_x64.bat）

  REM Set up VC14 Tools Command Prompt CALL "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64SET ROOT=%CD% SET QT_SOURCE=%ROOT%\qt-everywhere-opensource-src-5.9.1 SET QT_WORKING=%ROOT%\5.9.1_vc14_64 SET QT_INSTALL=%ROOT%\Qt\Qt5.9.1\5.9.1\msvc2015_64SET ICU_OPT=%ROOT%\ICU_57\icu SET ICU_INCLUDE=%ICU_OPT%\include SET ICU_LIB=%ICU_OPT%\lib64 SET ICU_BIN=%ICU_OPT%\bin64REM Set perl, ruby and python path, for needing them to build the QtWebKit SET PATH=C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin;C:\Ruby24-x64\bin;C:\Python27amd64;%PATH%REM Set icu path, for needing it's dll to build something SET PATH=%QT_SOURCE%\qtbase\bin;%QT_SOURCE%\gnuwin32\bin;%ICU_BIN%;%PATH%REM Set the build working directory, so you can build 32/64 at the same time IF EXIST %QT_WORKING% RD /s /q %QT_WORKING% MKDIR %QT_WORKING% CD /d %QT_WORKING%REM Building Qt, Just build "qtbase" and "qttools" CALL %QT_SOURCE%\configure.bat -mp -release -shared -confirm-license -platform win32-msvc -opensource -prefix %QT_INSTALL% -icu -I %ICU_INCLUDE% -L %ICU_LIB% ICU_LIBS="icudt.lib icuuc.lib icuin.lib" -opengl desktop -nomake examples -nomake tests -no-dbus -skip qtmacextras -skip qtx11extras -skip qtimageformats -skip qtandroidextras -skip qtserialport -skip qtserialbus -skip qtactiveqt -skip qtxmlpatterns -skip qtsvg -skip qtdeclarative -skip qtremoteobjects -skip qtscxml -skip qtpurchasing -skip qtcanvas3d -skip qtgamepad -skip qt3d -skip qtwayland -skip qtconnectivity -skip qtwebsockets -skip qtwebchannel -skip qtsensors -skip qtmultimedia -skip qtspeech -skip qtdatavis3d -skip qtcharts -skip qtwinextras -skip qtgraphicaleffects -skip qtquickcontrols2 -skip qtquickcontrols -skip qtvirtualkeyboard -skip qtlocation -skip qtwebkit -skip qtscript -skip qtwebengine -skip qtwebview -skip qtnetworkauth -skip qttranslations -skip qtdocPAUSE ECHO ON nmake && nmake installREM The current used ICU version is 57.1 COPY /v /y %ICU_BIN%\icudt57.dll %QT_INSTALL%\bin\ COPY /v /y %ICU_BIN%\icuin57.dll %QT_INSTALL%\bin\ COPY /v /y %ICU_BIN%\icuuc57.dll %QT_INSTALL%\bin\PAUSE CALL %QT_WORKING%\qtbase\bin\qmake.exe %QT_SOURCE%\qtwebkit\Webkit.pro nmake && nmake install

• 若編譯工具都按要求安裝，ICU和Qt的源碼也按照相應的目錄結構放置，執行5.9.1_x64.bat腳本即可編譯Qt的qtbase, qttools, qtwebkit模塊

• 倘若編譯失敗，請閱讀完全文

---

Qt Source

• 解壓qt-everywhere-opensource-src-5.9.1.zip

• 下載 QtWebKit 模塊 https://download.qt.io/archive/qt/5.9/5.9.1/submodules/qtwebkit-opensource-src-5.9.1.zip

  • 將qtwebkit-opensource-src-5.9.1.zip解壓，文件夾改名為qtwebkit并復制到qt-everywhere-opensource-src-5.9.1文件夾下

• 目錄樹如下所示

  qt-everywhere-opensource-src-5.9.1 | |-- ... |-- gnuwin32 |-- qtbase | |-- configure.bat | |-- config_help.txt | |-- configure.exe | `-- mkspecs | | | |-- win32-msvc | |-- common | | | `-- msvc-desktop.conf |-- qtwebkit | | | |-- | `-- ... |-- qtwebengine |-- configure.bat |-- README `-- ...

• 編譯流程簡述

• 執行根目錄下的configure.bat腳本，在該腳本中會調用qtbase下的configure.bat，而此腳本又會調用同目錄下的configure.exe

• 在舊版本的qt源碼中，會在qtbase\tools\目錄下看到有個configure的項目，configure.exe正是由該項目編譯所得。但在Qt5.9.1的源碼中會發現整個tools目錄都被移除。（此外還有個對qt庫的可視化裁剪工具的項目也找不到，不知道是移除還是移動到了其他文件夾。）
• 編譯qt時，需要使用的是根目錄下的configure.bat加上編譯參數來進行編譯

• 在跟目錄和qtbase目錄下會發現各存在一個configure文件，此文件為在Linux/Unix系統下編譯時使用，在Windows系統下無論你在命令行中輸入configure或者configure.bat都會執行configure.bat這個腳本

• 根目錄下的README和qtbase目錄下的config_help.txt對編譯源碼所需的工具以及對Qt源碼庫的定制參數做出了詳細的介紹
  

• REAME文件主要介紹所需要編譯工具以及其最低版本
  
  • 可在其中看到以下字段
    
    Perl version 5.12 or later [http://www.activestate.com/activeperl/]
    Python version 2.7 or later [http://www.activestate.com/activepython/]
    Ruby version 1.9.3 or later [http://rubyinstaller.org/]
    
  • 由于官方發布的Qt5.9.1版本中已經移除了QtWebkit模塊，故在README中沒有看到ICU的版本需求說明。（本人使用57.1，有空的同學可以去嘗試下其他版本的ICU）
    
    ICU version 57.1 [http://site.icu-project.org/download/57#TOC-ICU4C-Download]
    
• config_help.txt則對Qt庫自身的編譯參數作出了說明
  
  • 第三方庫的include，lib文件夾以及libs文件名配置（使用opengssl，icu等庫編譯時會用上此部分）
    
    • 在config_help.txt中可看到以下說明，
      
      Usage: configure [options] [assignments]
      Configure understands variable assignments like VAR=value on the command line.
      Each uppercased library name (obtainable with -list-libraries) supports the
      suffixes _INCDIR, _LIBDIR, _PREFIX (INCDIR=PREFIX/include, LIBDIR=PREFIX/lib),
      _LIBS, and - on Windows and Darwin - _LIBS_DEBUG and _LIBS_RELEASE. E.g.,
      ICU_PREFIX=/opt/icu42 ICU_LIBS="-licui18n -licuuc -licudata".
      
      
      • 按照安裝文檔使用ICU_INCLUDE="icu_dir"這種方法配置include和lib文件夾時并不能生效（在編譯前檢查時會報錯），但是可以使用ICU_LIBS="icudt.lib icuuc.lib icuin.lib"來配置需要鏈接的lib文件。因此最終選擇使用
        
        • -I "icu_include_dir" 配置include路徑
        • -L "icu_lib_dir" 配置lib路徑
        • -l "icudt" -l "icuuc" -l "icuin"配置lib文件
    • 此外也可以使用SET VARIABLE=VALUE這種方式配置include和lib路徑
      
      • SET INCLUDE=%INCLUDE%;%ICU_DIST%\include
      • SET LIB=%LIB%;%ICU_DIST%\lib
        

上面兩行相當于在舊的路徑上加上了icu的include和lib路徑

• 僅編譯部分Qt庫（對Qt庫裁剪）
  
  • -nomake <part>
    part主要為examples, tests
  • -skip <module>
    基本在源碼根目錄下的每個一個文件名都為一個module（除了 coin 和 gnuwin32）
  • -no-dbus可以去除進程通信相關的一個庫
  • -no-feature-<feature> 去除某些feature，本人沒有用過該功能
  • 當需要編譯QtWebkit時，可修改編譯配置相關源碼進行裁剪
    [Qt5] 減少dll依賴和大小(特別是webkit的大小和依賴)
• 其他編譯參數
  
  • -opengl <api>
    Windows下常用的參數為Desktop，嵌入式絕大多數為es2
  • -static-runtime會把windows的runtime庫靜態鏈接到Qt庫的dll中，也即是說在沒有安裝runtime庫的機器上，僅有Qt的dll也可以運行程序
  • -platform <target>
    qtbase\mkspecs目錄下的每一個文件夾名為一個target，例子中使用win32-msvc這個target進行編譯
  • 編譯 Debug 和 Release 版本
    
    • -release
    • -debug
    • -debug-and-release
      三個參數三選一即可，（如需要Release版本下的pdb文件，需加上-force-debug-info）
  • 編譯 靜態庫 或 動態庫
    
    • -shared 動態庫
    • -static 靜態庫（注意與-static-runtime的差別，-static意為編譯出來的Qt庫為靜態庫， 而-static-runtime則是Qt庫靜態鏈接VC運行時庫）
      本人開發的為大型Windows桌面程序，故而僅需編譯動態庫，也未曾嘗試編譯靜態庫。但按照本文方法編譯靜態庫應該不會有太大問題。

• VS2015 或者 VS2017

  • 安裝

    • Visual Studio的安裝只需要機器可以聯網，一鍵安裝即可，這里就不在多做介紹。

  • VS2017中使用VC14的編譯工具報錯問題

    • 由于VS2017中集成了VC14編譯器，而且VS2017可選擇安裝目錄，可配置安裝模塊等等，有些同學更傾向于僅安裝了VS2017。在此環境下使用VC14編譯工具會有些小問題，這應該是M$工程師留下的小Bug。

    • 無論是在Start菜單中點擊VS2015 x64 Native Tools Command Prompt還是使用命令行，最終都會使用C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat這個bat腳本來初始化VC編譯環境。該腳本中有以下代碼

      @echo off REM VC command prompt depends on env. variable installed during VS. This causes VC command prompt to break for C++ Build SKU. REM So if VS is not installed and C++ Build SKU is installed, set appropriate environment for C++ Build SKU by calling into it's batch file. REM C++ Build SKU supports only desktop development environment.if exist "%~dp0..\common7\IDE\devenv.exe" goto setup_VS if not exist "%~dp0..\common7\IDE\wdexpress.exe" goto setup_buildsku:setup_VS
      • 調用此腳本時會在if exist "%~dp0..\common7\IDE\devenv.exe" goto setup_VS處中斷
      • 這是因為僅安裝了VS2017，也即是說機器中只有VS2017那一份IDE，所以在C:\Program Files (x86)\Microsoft Visual Studio 14.0\common7\IDE\文件夾下是不會有devenv.exe這個文件。(%~dp0代指bat腳本文件所在文件夾)
      • 解決方法，將這兩句判斷的語句注釋掉即可
        bat
        REM if exist "%~dp0..\common7\IDE\devenv.exe" goto setup_VS
        REM if not exist "%~dp0..\common7\IDE\wdexpress.exe" goto setup_buildsku
        

  Python Ruby Perl

• 在qtbase\bin文件夾下看到兩個后綴為pl的文件，在編譯qtbase模塊時應該需要Perl這個工具。

• 而在安裝過程中，并沒有仔細研究過編譯的log，此外也沒有時間去閱讀Qt源碼。這些工具都是為了編譯哪些模塊則不是太清楚。唯一確定是，如果你想編譯QtWebKit模塊，Python Ruby Perl 和 icu 是必須全部安裝的。

• QtWebKit依賴于Qt的其他模塊，若沒有編譯那些模塊就編譯QtWebKit會把那些模塊全部編譯到QtWebKit.dll中。（此項是我想當然猜的，有興趣的同學可以去研究一下，告訴下我正確答案）

ICU

• 如果不需要編譯QtWebKit庫，這個庫完全不需要安裝。

• 在網上搜索各種關于Qt icu的信息，各種搜索結果搜搞得好復雜，有些設置要求你在Windows下安裝一個Linux環境。也許是由于搜索了”Qt icu”，所以搜索結果就變得復雜了；也有可能是我水平太低，在這之前并不知道ICU是一個編碼轉碼庫…

• 在官方中下載到ICU的源碼解壓后，可得到以下目錄結構的文件

  icu | `--source|`allinone|`--allinone.sln

  • 使用VS2015/VS2017打開allinone.sln這個解決方案，可看到工程中配置的編譯器版本為VC10

  • 除了makedata這個工程以外，其他工程全部升級VC14

  • 右鍵點擊Solution ‘allinone’，然后Build Solution

    • 在Qt開發過程中無需對ICU庫Debug，而且編譯Debug/Release版本的Qt庫時都可使用Release版本的ICU，因此，我們僅需要編譯32/64bit的Release版本的ICU庫
    • Qt中僅使用icudt57.dll(stubdata), icuuc57.dll(common), icuin57.dll(i18n)這三個dll，本人貪圖方便就整個Solution都進行編譯了。但復制資源，僅復制這三個文件到Qt的安裝目錄下的bin文件夾即可。

  • 若ICU編譯成功，可得到icu目錄下會多出以下文件夾

    icu | |--source | | | `allinone | | | `--allinone.sln | |--include |--lib |--bin |--lib64 `--bin64

編譯腳本編寫

我們可以不學習OOP編程技術，但是我們絕不能不遵守SOP(SB Oriented Programming)編程準則–軟件設計的終極目標就是“不但SB會用你的程序，而且SB也能看懂你的代碼”。因此最后，我還是對文章開頭的腳本作下說明。

• 初始化編譯環境
  
  • CALL 'bat' 'value'，調用另外一個bat腳本，類似于一個函數調用
  • SET VAR=value，相當于定義變量VAR，并賦予初值value
  • %VAR%，則為取VAR的值
  • 如下代碼，初始化了VC14_x64編譯環境，并定義了當前的工作路徑，QT的路徑，ICU的路徑以備后用。
REM Set up VC14 Tools Command PromptCALL "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64SET ROOT=%CD%SET QT_SOURCE=%ROOT%\qt-everywhere-opensource-src-5.9.1SET QT_WORKING=%ROOT%\5.9.1_vc14_64SET QT_INSTALL=%ROOT%\Qt\Qt5.9.1\5.9.1\msvc2015_64SET ICU_OPT=%ROOT%\ICU_57\icuSET ICU_INCLUDE=%ICU_OPT%\includeSET ICU_LIB=%ICU_OPT%\lib64SET ICU_BIN=%ICU_OPT%\bin64

• 將編譯工具加入系統環境變量

  REM Set perl, ruby and python path, for needing them to build the QtWebKit SET PATH=C:\Strawberry\c\bin;C:\Strawberry\perl\site\bin;C:\Strawberry\perl\bin;C:\Ruby24-x64\bin;C:\Python27amd64;%PATH%REM Set icu path, for needing it's dll to build something SET PATH=%QT_SOURCE%\qtbase\bin;%QT_SOURCE%\gnuwin32\bin;%ICU_BIN%;%PATH%
  • 編譯Qt需要Perl, Ruby, Python這三個工具來做些事情，我們安裝了這些工具后，在編譯Qt時，又是如何找到這些工具的exe來執行編譯某些源碼？如果你在安裝這些工具時，提勾了加入系統環境變量，那么你會在Windows的System Info里面找到如下圖所示的配置。而在Qt的編譯腳本執行時，會檢查系統環境變量的Path里有沒有對應的工具。
    
  • 當然我們也可以設置一個臨時的PATH。如上述代碼所示，將需要的編譯工具路徑追加在原系統的PATH里（當退出當前的cmd命令窗口后，這些設置會被自動清除）。
  • 在使用-icu編譯的同時，也需要將ICU的dll所在目錄添加到PATH中。（如果我沒有記錯，在使用-icu編譯時，在編譯widgets模塊時，需要用到ICU的dll來生成某些文件）

• 設置編譯QT的工具目錄

  REM Set the build working directory, so you can build 32/64 at the same time IF EXIST %QT_WORKING% RD /s /q %QT_WORKING% MKDIR %QT_WORKING% CD /d %QT_WORKING%
  • 在使用configure.bat編譯時，會在將當前的目錄工作，所有生成的中間文件都會放在當前目錄，所以需要在一個工作目錄調用源碼目錄下configure.bat，這樣可以避免污染源碼。即使在編譯過程中發生了錯誤，我們還是可以刪了工作目錄或者換一個工作目錄重來。此外，也可以同時編譯多個版本（32/64,debug/release,vc140/vc141）的Qt。

• Qt編譯參數設置

  REM Building Qt, Just build "qtbase" and "qttools" CALL %QT_SOURCE%\configure.bat -mp -debug -shared -confirm-license -platform win32-msvc -opensource -prefix %QT_INSTALL% -icu -I %ICU_INCLUDE% -L %ICU_LIB% ICU_LIBS="icudt.lib icuuc.lib icuin.lib" -opengl desktop -nomake examples -nomake tests -no-dbus -skip qtmacextras -skip qtx11extras -skip qtimageformats -skip qtandroidextras -skip qtserialport -skip qtserialbus -skip qtactiveqt -skip qtxmlpatterns -skip qtsvg -skip qtdeclarative -skip qtremoteobjects -skip qtscxml -skip qtpurchasing -skip qtcanvas3d -skip qtgamepad -skip qt3d -skip qtwayland -skip qtconnectivity -skip qtwebsockets -skip qtwebchannel -skip qtsensors -skip qtmultimedia -skip qtspeech -skip qtdatavis3d -skip qtcharts -skip qtwinextras -skip qtgraphicaleffects -skip qtquickcontrols2 -skip qtquickcontrols -skip qtvirtualkeyboard -skip qtlocation -skip qtwebkit -skip qtscript -skip qtwebengine -skip qtwebview -skip qtnetworkauth -skip qttranslations -skip qtdoc PAUSE ECHO ON nmake && nmake install

Qt5.4.0 VC14下編譯

• 在官方提供的文檔中，可以發現是沒有對應的編譯platform。本人嘗試了多次，也試過修改下Qt的源碼，最終發現使用-platform win32-msvc2013也是可以編譯vc14版本的Qt。 但還是僅能可以編譯base模塊。另外，qttools下的designer這個程序也可以編譯通過，但是assistant這個卻不行，這個應該是Qt5.4.0中的一些C++STL中的模板和容器不支持在VC14上編譯。

• 由于Qt5.4是一個過度版本，我就不再在這個版本多做研究。我在下面給出了編譯腳本，有興趣的同學可以研究一下。遇到問題，去看看\qtbase\mkspecs\win32-msvc2013和\qtbase\tools\configure下的源碼，應該會有所幫助。

  REM Set up VC14 Tools Command Prompt CALL "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64SET ROOT=%CD% SET QT_SOURCE=%ROOT%\qt-everywhere-opensource-src-5.4.0 SET QT_WORKING=%ROOT%\5.4.0_vc14_64 SET QT_INSTALL=%ROOT%\Qt\Qt5.4.0\5.4.0\msvc2015_64REM Set icu path, for needing it's dll to build something SET PATH=%QT_SOURCE%\qtbase\bin;%QT_SOURCE%\gnuwin32\bin;%PATH%REM Set the build working directory, so you can build 32/64 at the same time IF EXIST %QT_WORKING% RD /s /q %QT_WORKING% MKDIR %QT_WORKING% CD /d %QT_WORKING%CALL %QT_SOURCE%\configure.bat -mp -debug -shared -confirm-license -platform win32-msvc2013 -opensource -prefix %QT_INSTALL% -opengl desktop -nomake examples -nomake tests -skip qtandroidextras -skip qtmacextras -skip qtx11extras -skip qtsvg -skip qtxmlpatterns -skip qtdeclarative -skip qtquickcontrols -skip qtmultimedia -skip qtwinextras -skip qtactiveqt -skip qtlocation -skip qtsensors -skip qtconnectivity -skip qtwebsockets -skip qtwebchannel -skip qtwebkit -skip qtwebkit-examples -skip qtimageformats -skip qtgraphicaleffects -skip qtscript -skip qttools -skip qtquick1 -skip qtserialport -skip qtenginio -skip qtwebengine -skip qttranslations -skip qtdocECHO ON nmake && nmake installcd %QT_SOURCE%\qttools\src\designer CALL %QT_WORKING%\qtbase\bin\qmake.exe designer.pro nmake && nmake installcd %QT_SOURCE%\qttools\src\linguist CALL %QT_WORKING%\qtbase\bin\qmake.exe linguist.pro nmake && nmake install

Referene

• Visual Studio 2015編譯安裝配置QT5.5.1(含QTWEBKIT)

• msvc2013編譯qt5.6源碼

• 自編譯QT中的ICU庫問題

• 用msvc2008編譯qt5.4.0

• [Qt5] 減少dll依賴和大小(特別是webkit的大小和依賴)

• VS2017自帶VS2015編譯器等在命令行下無法使用問題

• Create an offline installation of Visual Studio 2017

• Bat命令學習

• Markdown Src： https://github.com/joshion/CSDN.git

總結

以上是生活随笔為你收集整理的Qt源码在VC环境下编译（以VC14下Qt5.9.1和Qt5.4.0为例，包含icu和QtWebkit模块）的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。