Building Qt 5 for BlackBerry: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Created page with "Category:BlackBerry Category:HowTo Category:Developing_with_Qt::Qt 5 [toc align_right="yes" depth="2"] = Building Qt5 for BlackBerry = This page provides instru...")
 
No edit summary
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:BlackBerry]]
[[Category:BlackBerry]]
[[Category:HowTo]]
[[Category:HowTo]]
[[Category:Developing_with_Qt::Qt 5]]
[[Category:Developing_with_Qt::Qt 5]]


[toc align_right="yes" depth="2"]


= Building Qt5 for BlackBerry =


This page provides instructions on how to build Qt5 for BlackBerry 10 and the Playbook OS. Please note that the work is currently focused on Qt5 for BlackBerry 10. Qt5 might not build or not run well on the PlayBook OS, whereas Qt v5.1.1 is known to build and work with some potential issues when executing an application on Playbook.
This page provides instructions on how to build Qt5 for BlackBerry 10 and the Playbook OS. Please note that the work is currently focused on Qt5 for BlackBerry 10. Qt5 might not build or not run well on the PlayBook OS, whereas Qt v5.1.1 is known to build and work with some potential issues when executing an application on Playbook.
Line 11: Line 11:
== Setting up the environment ==
== Setting up the environment ==


See [[Setup for BlackBerry10 development]] for the introduction and further instructions.
See [[Setup-for-BlackBerry10-development|Setup for Blackberry10 development]] for the introduction and further instructions.


== Getting the source ==
== Getting the source ==


We do an in-source build of the Qt5 repositories that are needed and install them into dedicated build directory. <code>$HOME/development/qnx/qt5<code> is used in the examples below. Please also note that we clone and build git submodules separately. This procedure is different to the builds for desktop platforms and allows to include only those submodules which are relevant without managing a master repository. Please adjust the paths to suit your setup as needed.
We do an in-source build of the Qt5 repositories that are needed and install them into dedicated build directory. <code>$HOME/development/qnx/qt5</code> is used in the examples below. Please also note that we clone and build git submodules separately. This procedure is different to the builds for desktop platforms and allows to include only those submodules which are relevant without managing a master repository. Please adjust the paths to suit your setup as needed.


First create a directory to hold the source code:
First create a directory to hold the source code:
Line 25: Line 25:
</code>
</code>


The following repositories are used in regular builds for BlackBerry 10 in "BlackBerry's public CI":http://qtlab.blackberry.com as of Qt 5.2 :
The following repositories are used in regular builds for BlackBerry 10 in [http://qtlab.blackberry.com BlackBerry's public CI] as of Qt 5.2 :


# qtbase
# qtbase
Line 47: Line 47:
Then clone:
Then clone:
<code>
<code>
git clone git://gitorious.org/qt/qtbase.git
git clone git://code.qt.io/qt/qtbase.git
git clone git://gitorious.org/qt/qtxmlpatterns.git
git clone git://code.qt.io/qt/qtxmlpatterns.git
git clone git://gitorious.org/qt/qtsensors.git
git clone git://code.qt.io/qt/qtsensors.git
git clone git://gitorious.org/qt/qtdeclarative.git
git clone git://code.qt.io/qt/qtdeclarative.git
git clone git://gitorious.org/qt/qtmultimedia.git
git clone git://code.qt.io/qt/qtmultimedia.git
git clone git://gitorious.org/qt/qtgraphicaleffects.git
git clone git://code.qt.io/qt/qtgraphicaleffects.git
git clone git://gitorious.org/qt/qtconnectivity.git
git clone git://code.qt.io/qt/qtconnectivity.git
git clone git://gitorious.org/qt/qtquickcontrols.git
git clone git://code.qt.io/qt/qtquickcontrols.git


</code>
</code>
Line 63: Line 63:


<code>
<code>
./init-repository -f —no-webkit —module-subset=qtbase,qtxmlpatterns,qtdeclarative,qtsensors,qtmultimedia,qtgraphicaleffects,qtconnectivity,qtquickcontrols,qtlocation
./init-repository -f —no-webkit —module-subset=qtbase,qtxmlpatterns,qtdeclarative,qtsensors,qtmultimedia,
 
qtgraphicaleffects,qtconnectivity,qtquickcontrols,qtlocation
</code>
</code>


Line 81: Line 81:
First we need to configure Qt.
First we need to configure Qt.


==== Linux/OS X ====
==== Linux/macOS ====


The examples below show a minimal set of configure options. You can see the full set of configure options used in the "BlackBerry's public CI":http://qtlab.blackberry.com in the raw console output of the <code>qtbase<code> build. See "this link":http://qtlab.blackberry.com/job/qt-5-qtbase-stable/ and then open the raw "Console Output" for the last successful build for ARM or for x86.
The examples below show a minimal set of configure options. You can see the full set of configure options used in the [http://qtlab.blackberry.com BlackBerry's public CI] in the raw console output of the ''qtbase'' build. See [http://qtlab.blackberry.com/job/qt-5-qtbase-stable/ this link] and then open the raw "Console Output" for the last successful build for ARM or for x86.


<code>
cd qtbase
./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc -opengl es2
-nomake examples -nomake tests -opensource -confirm-license -release
</code>
</code>
cd qtbase
./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc -opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release
<code>


When compiling for the PlayBook, use the following command:
When compiling for the PlayBook, use the following command:


<code>
./configure -prefix $HOME/development/qnx/qt5 -device blackberry-playbook-armle-v7
-opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon
</code>
</code>
./configure -prefix $HOME/development/qnx/qt5 -device blackberry-playbook-armle-v7 -opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon
<code>


And afterwards we simply build it by calling <code>make<code> and <code>make install<code>:
And afterwards we simply build it by calling '''make''' and '''make install''':


</code>
<code>
make -j<N>
make -j<N>
make install
make install
<code>
</code>


where <N> is the number of parallel make jobs to run. Usually, this is set to <No. of CPU cores + 1>.
where <N> is the number of parallel make jobs to run. Usually, this is set to <No. of CPU cores + 1>.
Line 107: Line 109:
=== Windows ===
=== Windows ===


<code>
C:> cd qtbase
C:> configure -prefix C:stall -xplatform blackberry-armle-v7-qcc -opengl es2 -nomake examples
-nomake tests -opensource -confirm-license -release
</code>
</code>
C:> cd qtbase
C:> configure -prefix C:stall -xplatform blackberry-armle-v7-qcc -opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release
<code>


For the PlayBook:
For the PlayBook:


<code>
C:> cd qtbase
C:> configure -prefix C:stall -device blackberry-playbook-armle-v7 -opengl es2 -nomake examples
-nomake tests -opensource -confirm-license -release -no-c+''11 -no-pps
</code>
</code>
C:> cd qtbase
C:> configure -prefix C:stall -device blackberry-playbook-armle-v7 -opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-c+''11 -no-pps
<code>


And afterwards we simply build it by calling mingw32-make and mingw32-make install.
And afterwards we simply build it by calling mingw32-make and mingw32-make install.


</code>
<code>
mingw32-make -j
mingw32-make -j
mingw32-make install
mingw32-make install
<code>
</code>


If you want to work with the HTTPS protocol, add '''-openssl''' option. ''need to check if the same is required on Linux''
If you want to work with the HTTPS protocol, add '''-openssl''' option. ''need to check if the same is required on Linux''


h3. Mac OS X
=== macOS ===
 
This is almost the same as on Linux. We just add '''-no-c11''' option when compiling on macOS, since the current version of the toolchain does not support c11.
This is almost the same as on Linux. We just add </code>-no-c11</code> option when compiling on Mac OSX, since the current version of the toolchain does not support c11.


<code>
<code>
$ cd qtbase
$ cd qtbase
$ ./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc -opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon -no-c''+11
$ ./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc  
-opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon -no-c''+11
</code>
</code>


Line 141: Line 145:
After above steps have been completed you should have QtBase installed in the prefix directory (i.e. in $HOME/development/qnx/qt5 or in C:stall, depending on your operating system).
After above steps have been completed you should have QtBase installed in the prefix directory (i.e. in $HOME/development/qnx/qt5 or in C:stall, depending on your operating system).


In order to complete build, we go through all modules and build them as "regular" Qt projects, but use use the <code>qmake<code> '''from our new Qt5 installation''' (i.e. from the prefix directory). A few modules have dependencies to each other. Make sure you build modules in the order as listed above.
In order to complete build, we go through all modules and build them as "regular" Qt projects, but use use the qmake '''from our new Qt5 installation''' (i.e. from the prefix directory). A few modules have dependencies to each other. Make sure you build modules in the order as listed above.


=== Extend the path ===
=== Extend the path ===


On Linux or OS X
On Linux or macOS


<code>
<code>
Line 159: Line 163:
=== Build and install additional git submodules ===
=== Build and install additional git submodules ===


On Linux or OS X:
On Linux or macOS:


<code>
<code>

Latest revision as of 22:02, 14 June 2016



This page provides instructions on how to build Qt5 for BlackBerry 10 and the Playbook OS. Please note that the work is currently focused on Qt5 for BlackBerry 10. Qt5 might not build or not run well on the PlayBook OS, whereas Qt v5.1.1 is known to build and work with some potential issues when executing an application on Playbook.

Setting up the environment

See Setup for Blackberry10 development for the introduction and further instructions.

Getting the source

We do an in-source build of the Qt5 repositories that are needed and install them into dedicated build directory.

$HOME/development/qnx/qt5

is used in the examples below. Please also note that we clone and build git submodules separately. This procedure is different to the builds for desktop platforms and allows to include only those submodules which are relevant without managing a master repository. Please adjust the paths to suit your setup as needed.

First create a directory to hold the source code:

cd $HOME/development
mkdir qt5
cd qt5

The following repositories are used in regular builds for BlackBerry 10 in BlackBerry's public CI as of Qt 5.2 :

  1. qtbase
  2. qtdeclarative
  3. qtmultimedia
  4. qtgraphicaleffects
  5. qtconnectivity
  6. qtxmlpatterns
  7. qtsensors
  8. qtquickcontrols

This matches all essential modules, plus several add-on modules. QtWebKit is currently not a part of the regular builds. Still, it is possible to build it, see Building-QtWebKit-for-Blackberry

Other repositories known to build:

  1. qtjsbackend (not relevant anymore for Qt 5.2 and later)
  2. qt3d (optional, provides 3D scenes using QML)
  3. qtscript (optional, only needed when using the qtquick1 submodule)
  4. qtlocation

Then clone:

git clone git://code.qt.io/qt/qtbase.git
git clone git://code.qt.io/qt/qtxmlpatterns.git
git clone git://code.qt.io/qt/qtsensors.git
git clone git://code.qt.io/qt/qtdeclarative.git
git clone git://code.qt.io/qt/qtmultimedia.git
git clone git://code.qt.io/qt/qtgraphicaleffects.git
git clone git://code.qt.io/qt/qtconnectivity.git
git clone git://code.qt.io/qt/qtquickcontrols.git

Using the master repository

The presented approach handles repositories from related Qt5 modules separately. If you prefer, you can also adapt the standard procedure based on a build from the master repository. You just need to make sure that your master repository has been initialized for those repositories which are actually supported on BlackBerry 10. The following can be used to initialize the master repository for the Qt modules out lined above:

./init-repository -f no-webkit module-subset=qtbase,qtxmlpatterns,qtdeclarative,qtsensors,qtmultimedia,
qtgraphicaleffects,qtconnectivity,qtquickcontrols,qtlocation

Building

The process of building Qt5 for BlackBerry devices is very similar to building it for any other platform so it is worth having a quick read through the generic instructions for building Qt5 before proceeding.

Be sure that you have configured your environment to use the BlackBerry 10 NDK as described in Blackberry. This especially concerns setting the right values in $PATH to pickup tools and the cross-compile tool-chain provided in the NDK.

Note

When building Qt5 with the latest public NDK some features might be disabled (Input Method Framework, LGMON, NFC Share). This is due to missing header files which have not been published yet.

The "configure" step

First we need to configure Qt.

Linux/macOS

The examples below show a minimal set of configure options. You can see the full set of configure options used in the BlackBerry's public CI in the raw console output of the qtbase build. See this link and then open the raw "Console Output" for the last successful build for ARM or for x86.

cd qtbase
./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc -opengl es2 
-nomake examples -nomake tests -opensource -confirm-license -release

When compiling for the PlayBook, use the following command:

./configure -prefix $HOME/development/qnx/qt5 -device blackberry-playbook-armle-v7 
-opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon

And afterwards we simply build it by calling make and make install:

make -j<N>
make install

where <N> is the number of parallel make jobs to run. Usually, this is set to <No. of CPU cores + 1>.

Windows

C:> cd qtbase
C:> configure -prefix C:stall -xplatform blackberry-armle-v7-qcc -opengl es2 -nomake examples 
-nomake tests -opensource -confirm-license -release

For the PlayBook:

C:> cd qtbase
C:> configure -prefix C:stall -device blackberry-playbook-armle-v7 -opengl es2 -nomake examples 
-nomake tests -opensource -confirm-license -release -no-c+''11 -no-pps

And afterwards we simply build it by calling mingw32-make and mingw32-make install.

mingw32-make -j
mingw32-make install

If you want to work with the HTTPS protocol, add -openssl option. need to check if the same is required on Linux

macOS

This is almost the same as on Linux. We just add -no-c11 option when compiling on macOS, since the current version of the toolchain does not support c11.

$ cd qtbase
$ ./configure -prefix $HOME/development/qnx/qt5 -xplatform blackberry-armle-v7-qcc 
-opengl es2 -nomake examples -nomake tests -opensource -confirm-license -release -no-neon -no-c''+11

The actual "build" step

After above steps have been completed you should have QtBase installed in the prefix directory (i.e. in $HOME/development/qnx/qt5 or in C:stall, depending on your operating system).

In order to complete build, we go through all modules and build them as "regular" Qt projects, but use use the qmake from our new Qt5 installation (i.e. from the prefix directory). A few modules have dependencies to each other. Make sure you build modules in the order as listed above.

Extend the path

On Linux or macOS

export PATH=$HOME/development/qnx/qt5/bin:$PATH

On Windows>

C:> set PATH=C:stall\bin;PATH

Build and install additional git submodules

On Linux or macOS:

cd <sub_module_name>
qmake
make -j<N>
make install

On Windows:

C:> cd <sub_module_name>
C:> qmake
C:> mingw32-make -j
C:> mingw32-make -j install

How to use this build

You next reading should be Using custom Qt builds on BlackBerry 10 devices . It will explain how configure Qt Creator with the new build and how to use it in application development.