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
On all platforms, the following tools are required:
- Python 2.7.5 or later
- Bison, Flex
On Windows, Visual Studio 2015 and Windows 10 SDK are required.
On Linux, Clang or GCC version 4.7 or later is required. Supported configurations are
Qt WebEngine requires
pkg-config to detect most of its dependencies. The following
pkg-config files are required:
If Qt was configured for
xcb, the following
pkg-config files are also required:
Further, development packages for
libcap need to be installed.
On macOS, the following are required:
Note: Qt WebEngine cannot be built for the 32-bit mode of macOS (using the
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:
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.