背景
默认自带的QWebEngine 因版权问题不支持音视频功能,需要自己编译源码以支持。
平台:Linux(UOS V20 1050)
Qt:5.15.2
准备工作
- 下载 Qt 5.15.2 对应版本源码,使用镜像网站或者Qt Maintenance Tool工具下载。
- 配置 Qt 环境变量
vim ~/.bashrc
将以下内容追加到bashrc文件后
#QT ENV
export PATH=/home/Leou/Qt/5.15.2/gcc_64/bin:$PATH
export LD_LIBRARY_PATH=/home/Leou/Qt/5.15.2/gcc_64/lib:$LD_LIBRARY_PATH
export QT_PLUGIN_PATH=/home/Leou/Qt/5.15.2/gcc_64/plugins:$QT_PLUGIN_PATH
export QML2_PATH=/home/Leou/Qt/5.15.2/gcc_64/qml:$QML2_PATH
刷新使其生效
source ~/.bashrc
这个阶段可以预先安装所需的库:
On all platforms, the following tools are required at build time:
- Python 2.7.5 or later. Python 3 is not supported.
- Bison, Flex
- GPerf
- Node.js version 8 or later (version 12 or later is recommended)
这些是最基本的要求,实际上还有很多库需要安装,可参考qtwebengine-platform-notes
编译
创建build目录,并使用qmake ../qtwebengine.pro -- -webengine-proprietary-codecs
命令
Leou@Leou-PC:/media/Leou/qtwebengine$ mkdir build
Leou@Leou-PC:/media/Leou/qtwebengine$ cd build/
Leou@Leou-PC:/media/Leou/qtwebengine/build$ qmake ../qtwebengine.pro -- -webengine-proprietary-codecs
输出信息:
Info: creating stash file /media/Leou/qtwebengine/build/.qmake.stash
Info: creating cache file /media/Leou/qtwebengine/build/.qmake.cacheRunning configuration tests...
Checking for architecture supported... yes
Checking for bison... no
Checking for submodule initialized... yes
Checking for build path without whitespace... yes
Checking for platform supported...
Checking for gperf... yes
Checking for flex... no
Checking for host pkg-config... /usr/bin/pkg-config
Checking for jumbo build merge limit... 8
Checking for linker supports -z noexecstack... yes
Checking for x11... yes
Checking for libdrm... yes
Checking for xcomposite... yes
Checking for xcursor... yes
Checking for xi... yes
Checking for xtst... yes
Checking for python2... /usr/bin/python2
Checking for d-bus... yes
Checking for fontconfig... yes
Checking for freetype >= 2.4.2... yes
Checking for glib-2.0 >= 2.32.0... yes
Checking for glibc > 2.16... yes
Checking for jsoncpp... no
Checking for khr... yes
Checking for lcms2... no
Checking for libevent... no
Checking for libvpx... no
Checking for libwebp, libwebpmux and libwebpdemux... no
Checking for compatible libxml2 and libxslt... no
Checking for minizip... no
Checking for system ninja... no
Checking for nss >= 3.26... yes
Checking for opus... no
Checking for protobuf... no
Checking for re2... no
Checking for snappy... no
Checking for zlib... yes
Done running configuration tests.Configure summary:Qt WebEngine Build Tools:Use System Ninja ....................... noUse System Gn .......................... noJumbo Build Merge Limit ................ 8Developer build ........................ noSanitizer .............................. noQtWebEngine required system libraries:fontconfig ........................... yesdbus ................................. yesnss .................................. yeskhr .................................. yesglibc ................................ yesQtWebEngine required system libraries for qpa-xcb:x11 .................................. yeslibdrm ............................... yesxcomposite ........................... yesxcursor .............................. yesxi ................................... yesxtst ................................. yesOptional system libraries used:re2 .................................. noicu .................................. nolibwebp, libwebpmux and libwebpdemux . noopus ................................. noffmpeg ............................... nolibvpx ............................... nosnappy ............................... noglib ................................. yeszlib ................................. yesminizip .............................. nolibevent ............................. nojsoncpp .............................. noprotobuf ............................. nolibxml2 and libxslt .................. nolcms2 ................................ nopng .................................. noJPEG ................................. noharfbuzz ............................. nofreetype ............................. yesNote: The following modules are not being compiled in this configuration:webenginecorewebenginewebenginewidgetspdfpdfwidgetsWARNING: Tool bison is required to build QtWebEngine.WARNING: Tool bison is required to build QtPdf.WARNING: QtWebEngine will not be built.WARNING: QtPdf will not be built.Qt is now configured for building. Just run 'make'.
Once everything is built, you must run 'make install'.
Qt will be installed into '/home/Leou/Qt/5.15.2/gcc_64'.Prior to reconfiguration, make sure you remove any leftovers from
the previous build.
查看输出信息并安装缺失的库:
安装bison
sudo apt install bison
安装flex
sudo apt install flex
安装后,疑似有缓存,所以导致未更新,可删除build下的产物,再运行一次qmake ../qtwebengine.pro -- -webengine-proprietary-codecs
输出信息:
Leou@Leou-PC:/media/Leou/QtSrc/Src/qtwebengine/build$ qmake ../qtwebengine.pro -- -webengine-proprietary-codecsRunning configuration tests...
Done running configuration tests.Configure summary:Qt WebEngine Build Tools:Use System Ninja ....................... noUse System Gn .......................... noJumbo Build Merge Limit ................ 8Developer build ........................ noSanitizer .............................. noQtWebEngine required system libraries:fontconfig ........................... yesdbus ................................. yesnss .................................. yeskhr .................................. yesglibc ................................ yesQtWebEngine required system libraries for qpa-xcb:x11 .................................. yeslibdrm ............................... yesxcomposite ........................... yesxcursor .............................. yesxi ................................... yesxtst ................................. yesOptional system libraries used:re2 .................................. noicu .................................. nolibwebp, libwebpmux and libwebpdemux . noopus ................................. noffmpeg ............................... nolibvpx ............................... nosnappy ............................... noglib ................................. yeszlib ................................. yesminizip .............................. nolibevent ............................. nojsoncpp .............................. noprotobuf ............................. nolibxml2 and libxslt .................. nolcms2 ................................ nopng .................................. noJPEG ................................. noharfbuzz ............................. nofreetype ............................. yes
Qt WebEngineCore:Embedded build ......................... noFull debug information ................. noPepper Plugins ......................... yesPrinting and PDF ....................... yesProprietary Codecs ..................... yesSpellchecker ........................... yesNative Spellchecker .................... noWebRTC ................................. yesPipeWire over GIO ...................... noGeolocation ............................ yesWebChannel support ..................... yesKerberos Authentication ................ noExtensions ............................. yesNode.js ................................ noSupport qpa-xcb ........................ yesUse ALSA ............................... yesUse PulseAudio ......................... yes
Qt WebEngineQml:Support Qt WebEngine Qml ............... yesUI Delegates ........................... yesTest Support ........................... no
Qt WebEngineWidgets:Support Qt WebEngine Widgets ........... yes
Qt PDF:Support V8 ............................. noSupport XFA ............................ noSupport XFA-BMP ........................ noSupport XFA-GIF ........................ noSupport XFA-PNG ........................ noSupport XFA-TIFF ....................... no
Qt PDF Widgets:Support Qt PDF Widgets ................. yesWARNING: Building without node.js will disable some features of QtWebEngine DevTools.Qt is now configured for building. Just run 'make'.
Once everything is built, you must run 'make install'.
Qt will be installed into '/home/Leou/Qt/5.15.2/gcc_64'.Prior to reconfiguration, make sure you remove any leftovers from
the previous build.
执行make
make -j14
如果出错,则多执行几次make命令
执行结束后:
mv -f libqwebengineview.so ../../../plugins/designer/libqwebengineview.so
objcopy --only-keep-debug ../../../plugins/designer/libqwebengineview.so ../../../plugins/designer/libqwebengineview.so.debug && objcopy --strip-debug ../../../plugins/designer/libqwebengineview.so && objcopy --add-gnu-debuglink=../../../plugins/designer/libqwebengineview.so.debug ../../../plugins/designer/libqwebengineview.so && chmod -x ../../../plugins/designer/libqwebengineview.so.debug
make[3]: 离开目录“/media/Leou/QtSrc/Src/qtwebengine/build/src/plugins/qwebengineview”
make[2]: 离开目录“/media/Leou/QtSrc/Src/qtwebengine/build/src/plugins”
rm -f libQt5PdfWidgets.so.5.15.2 libQt5PdfWidgets.so libQt5PdfWidgets.so.5 libQt5PdfWidgets.so.5.15
g++ -Wl,--no-undefined -Wl,--version-script,QtPdfWidgets.version -Wl,--enable-new-dtags -Wl,-z,origin -Wl,-rpath,\$ORIGIN -Wl,-rpath,\$ORIGIN -Wl,-rpath-link,/home/Leou/Qt/5.15.2/gcc_64/lib -shared -Wl,-Bsymbolic-functions -Wl,-soname,libQt5PdfWidgets.so.5 -o libQt5PdfWidgets.so.5.15.2 .obj/qpdfview.o -L/home/qt/openssl-1.1.1g/lib /media/Leou/QtSrc/Src/qtwebengine/build/lib/libQt5Pdf.so /home/Leou/Qt/5.15.2/gcc_64/lib/libQt5Widgets.so /home/Leou/Qt/5.15.2/gcc_64/lib/libQt5Gui.so /home/Leou/Qt/5.15.2/gcc_64/lib/libQt5Core.so -lpthread -lGL
ln -s libQt5PdfWidgets.so.5.15.2 libQt5PdfWidgets.so
ln -s libQt5PdfWidgets.so.5.15.2 libQt5PdfWidgets.so.5
ln -s libQt5PdfWidgets.so.5.15.2 libQt5PdfWidgets.so.5.15
rm -f ../../lib/libQt5PdfWidgets.so.5.15.2
mv -f libQt5PdfWidgets.so.5.15.2 ../../lib/libQt5PdfWidgets.so.5.15.2
rm -f ../../lib/libQt5PdfWidgets.so
rm -f ../../lib/libQt5PdfWidgets.so.5
rm -f ../../lib/libQt5PdfWidgets.so.5.15
mv -f libQt5PdfWidgets.so ../../lib/libQt5PdfWidgets.so
mv -f libQt5PdfWidgets.so.5 ../../lib/libQt5PdfWidgets.so.5
mv -f libQt5PdfWidgets.so.5.15 ../../lib/libQt5PdfWidgets.so.5.15
objcopy --only-keep-debug ../../lib/libQt5PdfWidgets.so.5.15.2 ../../lib/libQt5PdfWidgets.so.5.15.2.debug && objcopy --strip-debug ../../lib/libQt5PdfWidgets.so.5.15.2 && objcopy --add-gnu-debuglink=../../lib/libQt5PdfWidgets.so.5.15.2.debug ../../lib/libQt5PdfWidgets.so.5.15.2 && chmod -x ../../lib/libQt5PdfWidgets.so.5.15.2.debug
make[2]: 离开目录“/media/Leou/QtSrc/Src/qtwebengine/build/src/pdfwidgets”
make[1]: 离开目录“/media/Leou/QtSrc/Src/qtwebengine/build/src”
可以看到lib下的产物
安装
直接替换安装当前Qt 的 QWebEngine
make install
测试
使用Qt的simplebrowser demo程序打开 html5test 网站测试功能:
可见已经支持了h264、mp3等音视频功能。
总结
在Linux上编译QWebEngine总体上比较容易,没有编译chromium那么困难。
https://doc.qt.io/qt-5/qtwebengine-platform-notes.html