path: root/src
diff options
authorTopi Reinio <>2016-05-02 12:05:39 +0200
committerTopi Reiniƶ <>2016-05-03 07:25:21 +0000
commit046ad79065faff555168bae13e3414b23b0521a8 (patch)
tree2af40bcdf27e60b7013af26fc31b087488b59253 /src
parent2aee2c61e0f1c190179f244fa29b780a69402dc3 (diff)
Doc: Update static build documentation
- Update the instructions to use correct mkspec and sysroot paths - Copying the mkspec step no longer needed - Mention Qt WebEngine not supporting static builds. Task-number: QTBUG-53117 Change-Id: I79b506b154f3fe36e02fbffee073bd0ad1b48cc1 Reviewed-by: Samuli Piippo <>
Diffstat (limited to 'src')
1 files changed, 8 insertions, 17 deletions
diff --git a/src/doc/src/qtee-static-linking.qdoc b/src/doc/src/qtee-static-linking.qdoc
index 33ebd6b..4014dbc 100644
--- a/src/doc/src/qtee-static-linking.qdoc
+++ b/src/doc/src/qtee-static-linking.qdoc
@@ -50,20 +50,6 @@
\section1 Building Qt for Static Linking
- As the first step before configuring Qt, the \e mkspec for the target device
- needs to be copied over to Qt sources, so that \e qmake will reference the
- correct toolchains when creating the makefiles.
- Using Raspberry Pi 2 as an example:
- \badcode
- cp -a <INSTALL_DIR>/5.6/Boot2Qt/raspberrypi2-eLinux/qt5/mkspecs/devices/linux-rasp-pi2-g++-b2qt \
- <QT_SRC>/qtbase/mkspecs/devices
- \endcode
- Above, <QT_SRC> is the location of Qt sources (top-level directory containing
- the \e configure script).
To use static linking, Qt must be built with the \c -static configuration
option. The following configure command selects the correct options and
\e sysroot for the Raspberry Pi 2.
@@ -72,13 +58,17 @@
device-specific paths are defined as environment variables:
- export SYSROOT_BASE=<INSTALL_DIR>/5.6/Boot2Qt/raspberrypi2-eLinux/toolchain/sysroots
- export TARGET_DEVICE=linux-rasp-pi2-g++-b2qt
+ export SYSROOT_BASE=<INSTALL_DIR>/5.6/Boot2Qt/raspberrypi2/toolchain/sysroots
+ export TARGET_DEVICE=linux-rasp-pi2-g++
export SYSROOT_TARGET=cortexa7hf-vfp-vfpv4-neon-poky-linux-gnueabi
export CROSSCOMPILE_PREFIX=x86_64-pokysdk-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-
export HOST_PREFIX=~/build/qt5-rasp-pi2
+ To configure and build Qt for some other device, modify the variables to
+ contain the correct sysroot paths and device target strings as they appear
+ in your \SDK installation.
Description of the used variables:
@@ -118,7 +108,8 @@
\c sysroot/prefix.
Compiling in \e xcb support is disabled, OpenGL ES 2.0 support is selected,
- and \l [QtWebEngine] {Qt WebEngine} is excluded from the build.
+ and \l [QtWebEngine] {Qt WebEngine} is excluded from the build, as it does
+ not support static builds.
More information about configure options is available in the \l [QtDoc]
{Qt for Embedded Linux#Configuring a Specific Device}{Qt for Embedded Linux}