Building Qt4 for BlackBerry

This page provides instructions on how to build Q4 for BlackBerry10 and PlayBook OS. These instructions are addressed to those who need to build a custom version of Qt for their application to work on BlackBerry10 products, or would like to develop applications for PlaybookOS . Developers looking to create applications which do not have unusual needs should rather use QtCreator 3.0 and Qt provided in the BlackBerry 10 NDK, see this page for more details.

Setting up the environment

See BlackBerry for the introduction and further instructions.

Open a terminal window and load the Blackberry NDK enviroment variables with:

  1. source /opt/bbndk-2.1.0/  

All the commands below should be ran in the same terminal window.
If you close it between steps you need to run the again.

Getting the source

  1.  git clone git://

NOTE: we suggest to start with a clean source tree before building for different architectures (ARM/x86).

On the Playbook, the last officially supported version is 4.8.3. The recommended version is 4.8.3. To switch to 4.8.3, do:

  1.   cd qt
  2.   git checkout v4.8.3

Those who would like to use a more recent version of Qt 4.8 for the Playbook will need to use the blackberry-playbook-armv7le-qcc mkspec instead of the usual blackberry-armv7le-qcc. Please be advised that versions later than 4.8.3 are not officially supported and are not guaranteed to work. Use it at your own risk.

Building on a Linux/OS X host.

Building Qt 4.8 for ARM (BlackBerry 10 and PlaybookOS)

  1.   cd qt
  2.   ./configure -opensource -confirm-license -qpa -iconv -shared -release -xplatform blackberry-armv7le-qcc \
  3.      -little-endian -arch arm -largefile -nomake examples -xmlpatterns -no-webkit -no-rpath \
  4.      -opengl es2 -reduce-exports -system-sqlite -prefix <prefix>
  5.   make
  6.   make install

When compiling for the Playbook, you also need the -no-neon option, as NEON support on the Playbook is known to be flaky. This is only required for Qt 4.8.3 or later.

Building Qt 4.8 for x86 (Simulator)

  2.  cd qt
  3.  ./configure -opensource -confirm-license -qpa -iconv -shared -release -xplatform blackberry-x86-qcc \
  4.      -little-endian -arch i386 -largefile -nomake examples -nomake demos -xmlpatterns -no-webkit \
  5.      -no-rpath -opengl es2 -reduce-exports -system-sqlite -prefix <prefix>
  6.  make
  7.  make install

Qt will be installed at $PWD/stage. Alternatively, you can then use -prefix-install and pass a directory to the -prefix option to change the installation directory.

  1.  ./configure -opensource -confirm-license -qpa -iconv -shared -release -xplatform blackberry-x86-qcc \
  2.      -little-endian -arch i386 -largefile -nomake examples* -nomake demos -xmlpatterns -no-webkit \
  3.      -no-rpath -opengl es2 -reduce-exports -system-sqlite* -prefix-install  -prefix ~/build/

Building on a Windows host

In order to build Qt 4.8 for BlackBerry on a Windows host, you will need to rebuild the configure.exe utility first:

  1. Clone git:// to a separated directory;

For Playbook users only: You need to checkout tag v4.8.3 and cherry-pick c14694621aab2e7df13830f80621fb5680b432e4 before you can continue.

  1. Configure Qt with configure.exe -opensource -confirm-license
  2. cd into tools/configure
  3. Rebuild with ..\..\bin\qmake and then mingw32-make
  4. The new configure.exe binary will be place on $QTSRC/configure.exe
  5. You can now use it to replace the configure.exe on the Qt source tree you will use to build for BlackBerry.

Building Qt 4.8 for ARM (Playbook and phone devices)

  1. C:\dev> cd qt
  2. C:\dev\qt>configure.exe -opensource -confirm-license -release -xplatform blackberry-armv7le-qcc -arch arm  -nomake examples -nomake demos -no-webkit -opengl es2 -inotify -prefix c:\dev\qt4install
  3. C:\dev\qt> mingw32-make -j
  4. C:\dev\qt> mingw32-make -j install

When compiling for the Playbook, also supply the -no-neon option (see above for the reasons).

Building Qt 4.8 for x86 (Simulator)

  2. C:\dev> cd qt
  3. C:\dev\qt> configure.exe -opensource -confirm-license -release -xplatform blackberry-x86-qcc -arch i386  -nomake examples -nomake demos -no-webkit -opengl es2 -inotify -prefix c:\dev\qt4install
  4. C:\dev\qt> mingw32-make -j
  5. C:\dev\qt> mingw32-make -j install

Qt will be installed at C:\dev\qt4install. Alternatively, you can then use -prefix-install and pass a directory to the -prefix option to change the installation directory.

Building QtMobility

QtMobility [] is an addon module to Qt that provides various modules for mobile device functions. For BlackBerry devices, the sensor and multimedia backends are implemented, providing access to the device’s sensors such as the accelerometer or the light sensor, and providing the ability to playback audio and video.
For various reasons, such as that there will be no more official releases of QtMobility for Qt4, the repository of QtMobility is a fork [] of the upstream one (unlike the Qt5 version, in which the BlackBerry backends are all upstream).

Building on a Linux host

To build QtMobility on a Linux host, first make sure that the qmake of the cross-compiled Qt from above is first in $PATH. $QTDIR needs to be set to the path of the Qt installation from above. Otherwise, the environment should be the same as when Qt itself was built.

  1. $ git clone git://
  2. $ cd qnx-qt-mobility
  3. $ ./configure -prefix $QTDIR
  4. $ make
  5. $ make install

Now QtMobility is installed into the Qt installation and is ready to be used.

See also