靜態構建不被支持。
The requirements for building Qt modules from source are listed separately for each supported platform:
此外，需要以下工具為構建 Qt WebEngine 模塊：
On all platforms, the following tools are required at build time:
在 Windows，需要以下額外工具：
注意：
It is not recommended to use tools from
msys2
or
cygwin
to build Qt WebEngine as it may result in build errors.
On Linux, Clang or GCC version 9 or later is required.
Qt WebEngine 要求
pkg-config
以檢測其大多數依賴。以下
pkg-config
文件要求：
dbus-1
fontconfig
若 Qt 被配置為
xcb
，以下
pkg-config
文件也是必需的：
libdrm
xcomposite
xcursor
xi
xrandr
xscrnsaver
xtst
在 macOS，需要以下：
注意：
無法為 macOS 的 32 位模式構建 Qt WebEngine (使用
macx-clang-32
mkspec
).
Building Qt WebEngine with earlier Qt versions (down to the last LTS version) is supported. It means that Qt WebEngine 6.4 can be built with Qt 6.2.x, Qt 6.3.x, and Qt 6.4.
要使用早期 Qt 版本構建 Qt Webengine：
qmake && make (&& make install)
.
Applications using Qt WebEngine are not compatible with the Mac App Store, because:
To make Qt WebEngine work correctly when streaming to an AppleTV from a MacBook that supports GPU switching, it is important to add the
NSSupportsAutomaticGraphicsSwitching
option to the application Info.plist file, with the value set to
YES
. Otherwise rendering issues might occur when creating new web engine view instances after Airplay is switched on or off.
If a new default QSurfaceFormat with a modified OpenGL profile has to be set, it should be set before the application instance is declared, to make sure that all created OpenGL contexts use the same OpenGL profile.
On macOS, if the default QSurfaceFormat is set after the application instance, the application will exit with qFatal (), and print a message that the default QSurfaceFormat should be set before the application instance.
Qt WebEngine 為 Chromium 渲染過程提供開箱即用的沙盒支持。
在 Linux，注意以下限定：
/proc/sys/kernel/unprivileged_userns_clone
到 1。
seccomp-bpf
特徵 (內核版本 3.5 或更高版本)。
要明確禁用沙盒，使用以下選項之一：
QTWEBENGINE_DISABLE_SANDBOX
環境變量到 1。
--no-sandbox
命令行自變量，給用戶應用程序可執行文件。
QTWEBENGINE_CHROMIUM_FLAGS
to
--no-sandbox
.
更多信息，見 使用命令行參數 .
當在 Docker 容器中運行 Qt WebEngine 範例並瀏覽內容繁重站點時，可能報告 BUS 錯誤 (SIGBUS)。通常，這是由於 Docker 運行過小內存空間 (譬如 64MB) 容器導緻的。要修復此問題，增加內存空間大小。
Qt WebEngine enables accessibility support for web pages when the following conditions are met:
Due to some limitations, the Linux QPA plugin almost always reports that accessibility should be activated. On big HTML pages, this can cause a significant slowdown in rendering speed.
Because of that, Qt WebEngine accessibility support is disabled by default on Linux. It can be re-enabled by setting the
QTWEBENGINE_ENABLE_LINUX_ACCESSIBILITY
environment variable to a non-empty value.
Because of a limitation in the Windows compositor, applications that show a fullscreen web engine view will not properly display popups or other top-level windows. The reason and workaround is described in 基於 OpenGL 的窗口全屏 .