This tutorial introduces Qt and Qt Quick application framework for Android. It is a howto guide to install the development environment on Ubuntu Host for Android target.

1. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 1 | 19
Tutorial
Install Qt/Qt Quick
Target : Android
June 2015

2. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 2 | 19
The enclosed material is provided under the Creative Commons Attribution-Share Alike 3.0 License Agreement.
The full license text is available here:
http://creativecommons.org/licenses/by-sa/3.0/legalcode.
Qt and Qt logos are registered trademarks of The Qt Company (http://www.qt.io/about-us/) in Finland and other
countries worldwide.

3. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 3 | 19
Definitions
Termine Definizione
JDK Java Development Kit
NDK Native Development Kit
QML Qt Meta Language o Qt Modeling Language
Qt Qt , or "cute", is the Cross platform Application Framework provided by The Qt Company
Qt Quick Qt User Interface Creation Kit
Purpose
This tutorial introduces Qt and Qt Quick application framework for Android target. Qt Italia web community uses it
during meetups or workshops as a step-by-step guide to show installation process.
What we need
1) OS: Ubuntu Linux 15.04 64 bits
2) Android SDK: http://dl.google.com/android/android-sdk_r24.2-linux.tgz
3) Android NDK: http://dl.google.com/android/ndk/android-ndk-r10e-linux-x86_64.bin
4) Java SE Development Kit (JDK) v6 o successivi oppure OpenJDK per Linux
5) Apache ant and 32 bits dependency libraries
6) Qt Application framework: http://www.qt.io/download-open-source/
Download the packages
We can start now by downloading all the packages we need. First of all we go to
http://developer.android.com/sdk/index.html
to download the package for Linux as reported in following picture:

4. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 4 | 19
Now we can download the Native Development Kit. We can go to:
http://developer.android.com/tools/sdk/ndk/index.html
to download the package for Linux as reported in following picture:
Now we need the Qt Application framework. We go to
http://www.qt.io/download-open-source/
to download the online installer.

5. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 5 | 19
Now we have all we need and we can start the installation process.
Installing
First of all we have to install openjdk and ant on our Linux Ubuntu distro. We can open a terminal window and type:
sudo apt-get install ant openjdk-7-jdk:
The system will ask for a password and then starts the installation:

6. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 6 | 19
We can accept (Y) and go on.
As mentioned before, we use a 64 bits Linux Distro. It is necessary to install the following dependencies library to use
some 32 bits executables like adb (Qt Creator uses adb to detect connected devices)
This is the command to install the dependencies:
sudo apt-get install libstdc++6:i386 libgcc1:i386 zlib1g:i386 libncurses5:i386
Type Y and go on.
Now we can install another library with the following command:

7. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 7 | 19
sudo apt-get install libsdl1.2debian:i386
Type Y and go on.
Now we can go on Downloads directory. We are going to use following files:
From a terminal window we have to make executable the package android-ndk-r10e-linux-x86_64.bin, we can do this
with following command:
chmod a+x android-ndk-r10e-linux-x86_64.bin
Then we can run it, but before we have to choose where to put the extracted files. In our example we decided to put all
the extracted files in /opt.
First of all we have to move the files to /opt. Type:
sudo mv android-ndk-r10e-linux-x86_64.bin /opt
and
sudo mv android-sdk_r24.2-linux.tgz /opt
We can go to /opt folder and run this command:
./android-ndk-r10e-linux-x86_64.bin
At the end the new directory android-ndk-r10e will be created under /opt.
Now we have to exctract the second file. Type the command:
sudo tar –xzf android-sdk_r24.2-linux.tgz

8. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 8 | 19
The new directory /opt/android-sdk-linux will be created. Now under /opt we will find the following directory:
Now it’s time to update our SDK Android with this command:
sudo /opt/android-sdk-linux/tools/android update sdk
Remember to change the attributes in order to make it executable if necessary…
chmod a+x android
The following picture will show the main window of the program. We decided to remove Android TV and Android Wear
target for current API version (Android 5.1.1. - API 22).
Press Install … accept the license and wait for the download… it will take some time…

9. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 9 | 19
Now it’s time to install the Qt Application framework we downloaded before.
If the downloaded file qt-unified-linux-x64-2.0.1-online.run is not executable we have to change the attribute with the
following command:
chmod a+x qt-unified-linux-x64-2.0.1-online.run
and now we can run it:
./ qt-unified-linux-x64-2.0.1-online.run
Following pictures will show the dialogs used by the online installer.
Press Next

10. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 10 | 19
Type your account credentials or create a brand new account and press Next.
If you don’t need custom proxy settings press Next

11. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 11 | 19
Now choose the desired target folder and press Next. For this example we used the default location.
This is what we need so press Next. And then accept the license.

12. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 12 | 19
Press Next and then Install
It will take some time…

13. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 13 | 19
At the end we have
Now almost everything is ready. We have to do some custom settings to allow code generation from Qt Creator. To do
so, open the menu Tools >> Options

14. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 14 | 19
The following dialog will be shown:
As reported in picture, select Android tab and write the path for Android SDK and NDK. In our exampe they are located
in /opt directory.
Deploy e debug
In order to load and debug our applications it is important to select developer mode on the target smartphone. During the
first USB connection between the development computer and the device we have to confirm USB debug. On the
development desktop following message will be shown

15. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 15 | 19
Hello World
In order to test our installation we now use Qt Creator to write a first “Hello World” application.
Press New Project button on Qt Creator main window:
On the New Project wizard select Qt Quick Application as in following picture:

16. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 16 | 19
Name the project HelloWorld.
Press Next.

17. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 17 | 19
Press Next.
Press Next.

18. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 18 | 19
Press Finish. Qt Creator will prepare the application files as reported in following picture.
Now press button , this will start the compiler and then the deploy on target.
A new dialog window will appear to select the target device as reported in previous picture. Choose your device and press
OK.
If everything is fine we see this App on our Android device:

19. Qt-Italia.org
P . S e r e n o ( h t t p : / / w w w . q t - i t a l i a . o r g ) P a g . 19 | 19
Now we are ready to develop Android Applications for smartphones and tablets. Qt Italia web community is going to
prepare other tutorials concerning Qt and Qt Creator, google Play publishing, QML and more…
Stay tuned!