View source for Building-Qt4-for-Blackberry

=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 <span class="caps">NDK</span>, see [[Qt-Creator-with-BlackBerry-10|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 <span class="caps">NDK</span> enviroment variables with:

All the commands below should be ran in the same terminal window.<br /> If you close it between steps ''you need to run the bbndk-env.sh again''.

===Getting the source===

'''<span class="caps">NOTE</span>:''' we suggest to start with a clean source tree before building for different architectures (<span class="caps">ARM</span>/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:

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 <span class="caps">ARM</span> (BlackBerry 10 and PlaybookOS)====

When compiling for the '''Playbook''', you also need the '''-no-neon''' option, as <span class="caps">NEON</span> 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)====

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.<br />

===Building on a Windows host===

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

# Clone <code>git://gitorious.org/qt/qt.git</code> to a separated directory;

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

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

====Building Qt 4.8 for <span class="caps">ARM</span> (Playbook and phone devices)====

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

====Building Qt 4.8 for x86 (Simulator)====

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

===Building QtMobility===

[http://doc.trolltech.com/qtmobility-1.2/ QtMobility] ''[doc.trolltech.com]'' 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.<br /> For various reasons, such as that there will be no more official releases of QtMobility for Qt4, the repository of QtMobility is a [https://gitorious.org/+kdab-developers/qt-mobility/qnx-qt-mobility fork] ''[gitorious.org]'' 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.<br /> Now QtMobility is installed into the Qt installation and is ready to be used.

===See also===

* [[Building-Qt5-for-Blackberry|Building Qt5 for Blackberry]]
* [[A-HelloWorld-using-the-Blackberry-NDK-CLI-tools|A HelloWorld using the Blackberry <span class="caps">NDK</span> <span class="caps">CLI</span> tools]]
* [[Building and Deploying Qt Applications to the Playbook|Building_and_Deploying_Qt_Applications_to_the_Playbook]]
* [[Deploying Qt to a central place on Blackberry devices|Deploying_Qt_to_a_central_place_on_Blackberry_devices]]

===Categories:===

* [[:Category:BlackBerry|BlackBerry]]
* [[:Category:HowTo|HowTo]]