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 or later
  • Bison, Flex
  • GPerf


On Windows, Visual Studio 2013 or Visual Studio 2015 is required.


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.


On macOS, the following are required:

  • macOS 10.9 or later
  • Xcode 6.1 or later
  • macOS 10.10 SDK or later

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 OS X 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 OS X 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 (OS X 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.

© 2016 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.