Prérequis pour Qt pour Android

Pour développer des applications Android avec Qt, vous devez configurer votre environnement de développement en y installant les outils et les dépendances nécessaires. Cette page fournit des instructions étape par étape pour vous aider à démarrer.

Prérequis pour le développement Android

Pour développer avec Qt pour Android, vous devez disposer des prérequis suivants :

• Kit de développement Java (JDK)
• Outils de ligne de commande Android, comprenant :
  • Android NDK: pour compiler du code C++.
  • Plateforme SDK Android et outils de compilation SDK Android: pour compiler des applications Android.
  • Outils de la plateforme Android SDK: pour le déploiement et la gestion des dépendances Android.

Installation des prérequis

Utilisation de la configuration de développement Android d'Qt Creator

La manière la plus simple de gérer les dépendances consiste à utiliser la configuration de développement Android intégrée à Qt Creator. Lorsque vous ouvrez Qt Creator pour la première fois après avoir installé Qt pour Android, le programme vous demande si vous souhaitez lancer l’assistant de configuration Android. Cela permet également de configurer OpenSSL pour Android.

Utilisation d’un emplacement SDK existant

Si vous disposez déjà d’une installation du SDK Android, vous n’avez pas besoin de lancer cet assistant. Dans Qt Creator, rendez-vous plutôt sur Preferences > Devices > Android et indiquez les chemins d’accès de votre JDK et de votre SDK existants. Consultez les chemins d’accès courants au SDK Android. Pour plus d’informations, consultez Qt Creator: Configurer l’environnement de développement Android.

Installation manuelle des prérequis

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

1. Installez le kit de développement Java (JDK).

   Le développement Qt pour Android nécessite le JDK 21 ou une version supérieure, 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 votre programme d'installation ne définit pas la variable d'environnement ` JAVA_HOME ` pointant vers 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 sous 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)"

2. Installez les outils de ligne de commande du SDK Android. Téléchargez la dernière version des outils de ligne de commande du SDK Android pour votre système d'exploitation et extrayez-la dans le répertoire approprié, comme indiqué ci-dessous.

   Le SDK Android est généralement installé par « Qt Creator » ou Android Studio aux emplacements suivants :

   • Linux : ~/Android/Sdk/
   • macOS : ~/Library/Android/sdk/
   • Windows : C:\Users\<USER>\AppData\Local\Android\Sdk\

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

   brew install android-commandlinetools

3. Installez la plateforme SDK Android, les outils de compilation et les outils de plateforme.

   Veillez à installer la plateforme SDK, les outils de plateforme et les outils de compilation. Pour Qt 6.12, utilisez :

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

4. Installez le NDK Android.

   Qt 6.12 utilise le NDK 27.2.12479018, que vous pouvez installer en exécutant la commande suivante :

   sdkmanager "ndk;27.2.12479018"

5. (Facultatif) Installez l'émulateur Android.

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

   sdkmanager "emulator"

6. Configurations spécifiques à la plateforme
   • Sous Windows, vous devez installer le pilote USB supplémentaire fourni par le package « extras » du SDK Android. Installez-le en exécutant la commande suivante :

     sdkmanager.bat "extras;google;usb_driver"

   • Sous Linux, les dépendances suivantes sont nécessaires pour utiliser des outils tels que adb ou gdb, qui peuvent être utilisés via Qt Creator:

     sudo apt-get install libstdc++6 libncurses5

     Remarque : l'accélérationmatérielle est nécessaire pour obtenir des performances acceptables de l'émulateur Android. Sans elle, l'émulateur utilise une émulation logicielle du processeur, ce qui le rend extrêmement lent. Consultez la page Android : Accélération de l'émulateur pour plus d'informations.

Test de la configuration

Une fois les prérequis installés et configurés, vous pouvez tester votre environnement de développement en exécutant les exemples fournis avec l'installation de Qt. Pour plus d'informations, consultez la section Exemples mobiles.