上篇文章（【Ubuntu工具】安裝教程：Ubuntu系統上源碼編譯安裝QT5.15.13（有坑））我們通過源碼成功編譯安裝了 QT5.15.13版本，但是里面是不包含 QWebEngine 這個組件的。這個組件是實現 QT + Web 頁面開發(fā)必不可少的一部分。所以，咱們需要再源碼編譯安裝一下這個組件。這個坑更多（主要是依賴太多），本文將用最少的步驟，帶你避坑，成功安裝 QWebEngine 5.15.13。

 0. 源碼下載及準備

有兩種下載源碼的方法。

0.1 通過官網下載源碼

（1）下載地址：https://download./archive/qt/5.15/5.15.13/submodules/

（2）解壓到本地目錄

（3）進入目錄

0.2 通過 Git 下載源碼

這個過程比通過上面官方直接下載源碼要慢。

git clone https://code./cgit/qt/qtwebengine.git
cd qtwebengine
git checkout 5.15.13
git submodule update --init --progress

1. 安裝過程

（1）新建一個build文件夾，進入build文件夾

mkdir build
cd build

（2）qmake + make編譯

注意這里的qmake要替換成你的 QT5.15.13 版本的qmake的路徑，例如 /opt/Qt5.15.13/5.15.13/gcc_64/bin/qmake

qmake .. -- -proprietary-codecs
make -j8

這里不需要指定安裝目錄，它的安裝目錄是 qmake 所在的 QT 的路徑

如果運氣好，這里編譯過了，也就基本算能安裝成功了，直接執(zhí)行下面的安裝命令即可：

（3）安裝

sudo make install

但是，80%的概率，你會遇到問題，下面來展開說說我遇到的坑。

2. 踩坑

踩坑的步驟主要在 qmake + make 編譯階段。

2.1 QtWebEngine will not be built

在運行 qmake 命令時，配置列表后經常會出現 QtWebEngine will not be built 這樣的提示，這表明依賴的環(huán)境不OK，需要先安裝依賴的內容。根據提示安裝依賴的庫即可。下面我列出了可能需要的依賴庫，大家在 qmake 前都安裝一下：

sudo apt-get install libx11-*
sudo apt-get install libx11*
sudo apt-get install libxcb-*
sudo apt-get install libxcb*
sudo apt-get install libxkbcommon-devsudo
sudo apt-get install libxkbcommon-x11-dev
sudo apt-get install libxcb-xinerama0-dev
sudo apt-get install libxcb-sync-dev
sudo apt install libnss3-dev
sudo apt-get install libfontconfig1-dev 
sudo apt-get install libxtst-dev
sudo apt-get install libxcomposite-dev
sudo apt-get install libxkbfile-dev
sudo apt-get install libxcursor-dev
sudo apt install dbus dbus-tests libdbus-glib-1-dev
sudo apt install llvm
sudo apt-get install libclang-dev
sudo apt install gperf
sudo apt install bison flex 
sudo apt install nodejs npm

qmake執(zhí)行完之后，出現以下界面，最底部沒有任何提示，才算是qmake成功，否則仍然需要安裝相關依賴庫，直到沒有提示為止。

2.2 WARNING: Could not find all necessary libraries for qpa-xcb support in QtWebEngine.

這是因為缺少部分依賴庫，安裝 2.1 中的那些庫應該可以解決此問題

2.3 fatal error: X11/extensions/Xrandr.h: No such file or directory

安裝依賴庫：

sudo apt install libxrandr-dev

2.4 fatal error: X11/extensions/Xdamage.h: No such file or directory

安裝依賴庫：

sudo apt install libxdamage-dev

2.5 編譯錯誤：double-conversion

安裝依賴庫：

sudo apt install libdouble-conversion-dev

3. 總結

源碼編譯安裝 QT WebEngine 其實步驟很明確，就是 qmake, make, make install，但是其依賴的庫太多了，所以非常容易遇到問題。

我是在 Ubuntu20.04 中編譯成功了 5.15.13 版本。Ubuntu18.04 理論上也可以成功，但是不知道什么原因，在我的Ubuntu18.04中編譯時，必現卡死，為此還重裝過一遍系統...... 感興趣的可以試一試。

附：QWebEngine各版本對應的瀏覽器內核版本

大多數人裝 QWebEngine 都是為了開發(fā) QT + Web 的應用，因此了解每個版本對應的瀏覽器內核版本非常重要。下面是官方文檔中的版本對應關系：

參考：https://wiki./QtWebEngine/ChromiumVersions

如果覺得本文對你有幫助，麻煩點個贊和關注唄 ~~~

• · 大家好，我是 同學小張，日常分享AI知識和實戰(zhàn)案例 

本站文章一覽：