Questo breve tutorial rappresenta una mini guida per iniziare a programmare con Qt e Qt Quick su target Android. In particolare esso vuole essere un “memo” da usare durante i meetup e workshop sull’argomento organizzati dalla web community Qt-Italia.org.

1. I Tutorial di 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 Qt-Italia.org
Installazione Qt/Qt Quick
per target Android
Prima edizione, Giugno 2015

2. I Tutorial di 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
Questo tutorial è rilasciato con licenza
Creative Commons: Attribuzione - Condividi allo stesso modo 3.0 Italia
(http://creativecommons.org/licenses/by-sa/3.0/it/deed.it)
Questo documento può quindi essere riprodotto senza violare nessuna legge, sia in versione elettronica, sia in versione
cartacea, purché sia riprodotto integralmente in tutte le sue parti, compresa la pagina che contiene queste informazioni.
Qt© è un marchio registrato da The Qt Company (http://www.qt.io/about-us/)
Tutti i marchi riportati in questa pubblicazione appartengono ai rispettivi proprietari.

3. I Tutorial di 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
Glossario
Termine Definizione
JDK Java Development Kit
NDK Native Development Kit
QML Qt Meta Language o Qt Modeling Language
Qt Qt , da pronunciare "cute", è l’ambiente di sviluppo software di The Qt Company
Qt Quick Qt User Interface Creation Kit
Scopo
Questo breve tutorial rappresenta una mini guida per iniziare a programmare con Qt e Qt Quick su target Android. In
particolare esso vuole essere un “memo” da usare durante i meetup e workshop sull’argomento organizzati dalla web
community Qt-Italia.org.
Ingredienti
1) Sistema operativo: 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 e dipendenze a 32 bits
6) Qt Application framework: http://www.qt.io/download-open-source/
Procuriamoci il necessario
Iniziamo a scaricare gli ambienti di sviluppo necessari riportati al capitolo precedente; iniziando con il software
development kit di Android. Puntiamo quindi il nostro browser su http://developer.android.com/sdk/index.html e
scarichiamo l’ultima versione aggiornata come in figura seguente:

4. I Tutorial di 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
Nota: Nel nostro caso scaricheremo la versione per Linux.
Successivamente scaricheremo il Native Development Kit; puntiamo quindi il nostro browser su
http://developer.android.com/tools/sdk/ndk/index.html ed effettuiamo il download della versione di nostro interesse,
come in figura seguente.
A questo punto dobbiamo scaricare l’ambiente di sviluppo Qt. Puntiamo il nostro browser su
http://www.qt.io/download-open-source/ e scarichiamo l’installer online.

5. I Tutorial di 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
Ora abbiamo scaricato da Internet tutto il necessario e possiamo iniziare le installazioni.
Installazione
Iniziamo per prima cosa ad installare openjdk e ant. Apriamo una finestra terminale su Ubuntu e digitiamo:
sudo apt-get install ant openjdk-7-jdk come illustrato in figura seguente:
Dopo aver inserito la password per il commando sudo ci verrà chiesta l’autorizzazione per l’installazione:
Possiamo quindi accettare e proseguire.
Poiché il sistema operativo usato è a 64 bits, occorre installare delle dipendenze per poter lanciare alcuni eseguibili a 32
bits come ad esempio adb, il comando che serve a Qt Creator per rilevare i dispositivi su cui fare deploy.
I comandi per installare queste dipendenze sono:
sudo apt-get install libstdc++6:i386 libgcc1:i386 zlib1g:i386 libncurses5:i386

6. I Tutorial di 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
Accettiamo ed installiamo.
Successivamente installiamo l’ultima dipendenza con questo secondo comando:
sudo apt-get install libsdl1.2debian:i386
Anche in questo caso, accettiamo l’installazione e proseguiamo.

7. I Tutorial di 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
Al termine delle installazioni con apt-get riportate in precedenza, possiamo spostarci nella directory dove sono stati
precedentemente scaricati i files dei development kit, in particolare useremo ora i seguenti:
Ora, sempre dalla finestra terminale, rendiamo eseguibile il pacchetto android-ndk-r10e-linux-x86_64.bin scaricato,
mediante il comando:
chmod a+x android-ndk-r10e-linux-x86_64.bin
Lanciando l’esecuzione di questo file binario andremo a scompattarne il contenuto.
Occorre quindi decidere dove collocare i files scompattati dei diversi development kit. Nel caso di esempio è stato scelto
di inserirli tutti nella directory /opt.
Muoviamo quindi i file dalla directory di download alla director /opt con il comando seguente:
sudo mv android-ndk-r10e-linux-x86_64.bin /opt
ed inoltre spostiamo anche il file file compresso android-sdk_r24.2-linux.tgz mediante il comando
sudo mv android-sdk_r24.2-linux.tgz /opt
Posizioniamoci ora nella cartella /opt e lanciamo ora l’esecuzione mediante il comando:
./android-ndk-r10e-linux-x86_64.bin
Al termine verrà creata la cartella android-ndk-r10e.
Scompattiamo ora il file compresso android-sdk_r24.2-linux.tgz mediante il comando da terminale
sudo tar –xzf android-sdk_r24.2-linux.tgz
tale comando creerà la directory android-sdk-linux sotto /opt. Se tutto è andato a buon fine ci troveremo ora le due
cartelle sotto /opt:
Prima di ogni altra cosa dobbiamo eseguire l’aggiornamento del nostro SDK Android mediante il comando
sudo /opt/android-sdk-linux/tools/android update sdk
Nel caso il file android non fosse eseguibile occorrerà digitare il comando
chmod a+x android
Il comando android update sdk ci presenterà la finestra di dialogo per selezionare quali componenti installare o aggiornare.
Nel nostro caso sono stati esclusi per la versione corrente (Android 5.1.1.con API 22) tutte quelle parti necessarie a
compilare per Android TV o dispositivi wear. La figura seguente mostra il risultato.

8. I Tutorial di 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
Premiamo ora il pulsante Install … accettiamo la licenza nella finestra di dialogo che si aprirà successivamente ed
attendiamo il download degli aggiornamenti.
A questo punto siamo pronti per installare l’ambiente di sviluppo Qt. Portiamoci nella cartella di downloads dove
avevamo scaricato l’installer online e rendiamo eseguibile il file qt-unified-linux-x64-2.0.1-online.run mediante il solito
comando:

9. I Tutorial di 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
chmod a+x qt-unified-linux-x64-2.0.1-online.run
ed infine lanciamone l’esecuzione con
./ qt-unified-linux-x64-2.0.1-online.run
Qui di seguito saranno riportate le diverse finestre di dialogo di impostazione dell’installer online di Qt.
Premiamo Next ed avremo
Inseriamo i dati del nostro account Qt gratuito precedentemente creato o creiamone uno nuovo, accettiamo i termini del
servizio e premiamo Next per avanzare. Otterremo la finestra:

10. I Tutorial di 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
Nel caso non si debbano personalizzare le impostazioni di connessione mediante proxy possiamo avanzare con Next e
dopo alcuni secondi (in funzione della velocità della nostra connessione ad Internet), otterremo la seguente finestra di
dialogo:
Nel caso di esempio si accetta la locazione di destinazione dell’ambiente di sviluppo. Avanziamo quindi con Next.
Il programma di installazione ci proporrà automaticamente i componenti da installare, come in figura seguente:

11. I Tutorial di 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
Poichè ciò corrisponde a quanto desiderato possiamo proseguire con il pulsante Next. Accettiamo di seguito la licenza
d’uso in questo modo:
Ed avanziamo con Next. Ora è tutto pronto, possiamo premere il pulsante Install ed iniziare il download e successiva
installazione:

12. I Tutorial di 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
A questo punto possiamo andare a prenderci una bibita, un panino o farci una passeggiata nell’attesa…
Al termine troveremo questa finestra di dialogo.

13. I Tutorial di 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
Ora quasi tutto è pronto. Dobbiamo solamente impostare Qt Creator per poter generare applicazioni Android. Per far
questo apriamo il menu Tools >> Options
Comparirà la seguente finestra di dialogo:

14. I Tutorial di 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
Portiamoci sull’opzione Android, come evidenziato sopra e scriviamo i percorsi in cui abbiamo installato i developer kit.
Nel caso di esempio SDK ed NDK sono posizionati all’interno della cartella /opt.
Deploy e debug su dispositivi Android
Per poter caricare le nostre applicazioni ed eseguire il debug dobbiamo connettere un dispositivo Android ad una porta
USB del nostro computer. Nel far ciò dobbiamo ricordarci di impostare la modalità sviluppatore nei settings dello
smartphone. Alla prima connessione tra Qt Creator ed il dispositivo dovremo poi consentire il debugging USB. Di seguito
viene riportato a titolo di esempio la visualizzazione sul display dello smartphone impiegato per la prova.
Analogamente, fino a che non sarà accettato il debugging sul dispositivo Android avremo la visualizzazione seguente sul
desktop di sviluppo:

15. I Tutorial di 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
Quanto riportato in questo paragrafo verrà applicato durante la prima operazione di deploy sullo smartphone. Vediamo
ora come creare un progetto di test con Qt Creator e come farne il deploy.
Prima Prova: Hello World
Vediamo ora il classico esempio Hello World per provare l’installazione. Per Prima cosa apriamo un nuovo progetto con
Qt Creator ad esempio mediante il pulsante:
Si aprirà la seguente finestra di dialogo. Selezioniamo una Applicazione Qt Quick.

16. I Tutorial di 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
Diamole un nome, nel caso di esempio HelloWorld.
Per la nostra prova possiamo accettare tutti i valori di default delle successive finestre e premiamo quindi sempre Next.

17. I Tutorial di 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
Accettiamo i valori di default e premiano Next.
Accettiamo i valori di default e premiano Next.

18. I Tutorial di 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
Accettiamo i valori di default e premiano Finish. Qt Creator creerà per noi tutti i files dell’applicazione come si può
osservare dalla seguente immagine.
A questo punto, premendo il tasto , lanciamo la compilazione ed il successivo deploy sul dispositivo. Nella finestra di
selezione del dispositivo Android su cui fare deploy andremo a scegliere il nostro smartphone e, se tutto è andato a buon
fine, troveremo sul nostro smartphone la seguente applicazione:

19. I Tutorial di 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
Dopo questa prima prova siamo pronti per sviluppare applicazioni e farne il deploy su dispositivi Android come cellulari
e tablet. Nei prossimi tutorial verranno trattati approfondimenti su Qt e Qt Creator e sulla pubblicazione per Google Play.
Buon divertimento!