Démarrer avec Qt pour Android

La vidéo ci-dessous est un guide d'initiation à l'utilisation de la chaîne d'outils Qt pour Android, y compris l'IDE Qt Creator, pour vous permettre de commencer à développer des applications Qt pour Android.

Pour apprendre les bases de l'utilisation de Qt pour Android, suivez le cours " Getting Started with Qt for Android " de la Qt Academy.

Le reste de cette page contient des informations plus détaillées sur la prise en main.

Pour télécharger et installer Qt pour Android, suivez les instructions de la page Démarrer avec Qt.

Conditions préalables au développement Android

Afin de développer avec Qt pour Android, vous aurez besoin des prérequis suivants :

• Kit de développement Java (JDK)
• Outils de ligne de commande Android, y compris
  • Android NDK: pour construire du code C++.
  • Android SDK Platform et Android SDK Build Tools: pour construire des applications Android pour des versions spécifiques de l'API.
  • Outils de plateforme SDK Android: pour le déploiement et la gestion des dépendances Android.

La manière la plus simple de gérer les dépendances est d'utiliser l'installation de développement Android intégrée à Qt Creator. Lorsque vous ouvrez Qt Creator pour la première fois après avoir installé Qt XML pour Android, il vous est demandé si vous souhaitez exécuter l'assistant d'installation d'Android. Celui-ci configure également OpenSSL pour Android.

Utilisation d'un emplacement SDK existant

Si vous disposez déjà d'un SDK Android, vous n'avez pas besoin d'exécuter cet assistant. Au lieu de cela, dans Qt Creator, allez à Preferences > Devices > Android et naviguez jusqu'à vos chemins JDK et SDK existants. Voir les chemins d'accès communs au SDK Android. Pour plus d'informations, voir Qt Creator: Configuration de l'environnement de développement Android.

Installation manuelle des prérequis

Si vous préférez installer manuellement les prérequis, veuillez suivre les étapes suivantes.

Kit de développement Java (JDK)

Le développement de Qt pour Android nécessite le JDK 21 ou supérieur, fourni par l'une des distributions prises en charge suivantes :

• Adoptium
• OpenJDK
• Kit de développement Java SE

Installez le JDK de votre choix. Si le programme d'installation ne définit pas la variable d'environnement JAVA_HOME qui indique l'emplacement du JDK installé, vous pouvez la définir manuellement. Par exemple, sous Linux :

sudo apt-get install openjdk-21-jdk
export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

ou sur macOS :

brew install openjdk@21
sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \
    "/Library/Java/JavaVirtualMachines/openjdk-21.jdk"
export JAVA_HOME="$(/usr/libexec/java_home -v 21)"

Outils de ligne de commande du SDK Android

Téléchargez la dernière version de Android SDK Command Line Tools pour votre système d'exploitation et extrayez-la dans le chemin approprié comme indiqué ci-dessous.

Chemins du SDK Android

Le SDK Android est généralement installé par Qt Creator ou Android Studio dans les emplacements suivants :

• Linux : ~/Android/Sdk/
• macOS : ~/Bibliothèque/Android/sdk/
• Windows : C :\Users\N-<UTILISATEUR>\AppData\Local \Android \Sdk \N-<UTILISATEUR> \N-<UTILISATEUR>

Vous pouvez également utiliser le gestionnaire de paquets de votre système d'exploitation, par exemple pour macOS :

brew install android-commandlinetools

Paquets obligatoires du SDK Android

Veillez à installer le SDK Platform, Platform Tools et Build Tools. Pour Qt 6.11, utilisez :

sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

NDK Android

Qt 6.11 utilise le NDK 27.2.12479018, vous pouvez l'installer en exécutant :

sdkmanager "ndk;27.2.12479018"

Par exemple pour macOS :

Emulateur

Si vous souhaitez utiliser l'émulateur Android, vous pouvez l'installer en exécutant :

sdkmanager "emulator"

Configurations spécifiques à la plateforme

Windows

Le pilote USB par défaut de Windows ne permet pas le débogage à l'aide de l'outil Android Debug Bridge (ADB). Vous devez installer le pilote USB supplémentaire fourni par le kit SDK Android. Installez-le en exécutant ce qui suit :

sdkmanager.bat "extras;google;usb_driver"

Linux

Les dépendances suivantes sont nécessaires pour utiliser des outils tels que adb ou gdb qui peuvent être utilisés par Qt Creator:

sudo apt-get install libstdc++6 libncurses5

Test de l'installation

Vous pouvez maintenant tester votre configuration de développement en exécutant les exemples fournis avec l'installation de Qt Test. Pour plus d'informations, voir Exemples mobiles.

Pour développer une application simple à partir de zéro, voir Qt Creator: Tutorial : Application mobile.