Qt WebEngine Platform Notes
Building Qt WebEngine from Source
Static builds are not supported.
The requirements for building Qt 5 modules from source are listed separately for each supported platform:
In addition, the following tools are required for building the Qt WebEngine module:
The tests for skipping the Qt WebEngine build are located in the qtwebengine
repository, in the tools\qmake\mkspecs
subdirectory. They can be found by searching for skipBuild
.
All Platforms
On all platforms, the following tools are required:
- Python 2.7.5 or later
- Bison, Flex
- GPerf
Windows
On Windows, Visual Studio 2015 and Windows 10 SDK are required.
Linux
On Linux, Clang or GCC version 4.7 or later is required. Supported configurations are linux-g++
and linux-clang
.
Qt WebEngine requires pkg-config
to detect most of its dependencies. The following pkg-config
files are required:
dbus-1
fontconfig
If Qt was configured for xcb
, the following pkg-config
files are also required:
libdrm
xcomposite
xcursor
xi
xrandr
xscrnsaver
xtst
Further, development packages for khr
and libcap
need to be installed.
macOS
On macOS, the following are required:
Note: Qt WebEngine cannot be built for the 32-bit mode of macOS (using the macx-clang-32
mkspec
).
Mac App Store Compatibility
By default, Qt WebEngine uses private macOS API, which might cause an application to be rejected when submitted to the Mac App Store. To configure Qt WebEngine not to use these API calls, Qt WebEngine has to be recompiled:
qmake WEBENGINE_CONFIG+=use_appstore_compliant_code
However, this will cause some behavioral changes, such as:
- The macOS Kill Ring functionality will no longer work (emacs-like copy pasting).
- Certain Chromium sandboxing cleanup is not done.
- Text areas will be painted with a different style.
- Text fields might be painted with a different style on Mountain Lion (macOS 10.8).
Default QSurfaceFormat OpenGL Profile Support
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.
© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.