Qt pour Android - Compilation à partir du code source

Cette page décrit la procédure de configuration et de compilation de Qt pour Android. Pour télécharger et installer une version précompilée de Qt pour Android, suivez les instructions de la page « Premiers pas avec Qt ».

Prérequis

Pour compiler Qt pour Android à partir du code source, veuillez vous assurer que toutes les conditions requises décrites dans la section « Prérequis pour Qt pour Android » sont remplies avant de continuer.

Windows

La compilation de Qt pour Android sous Windows nécessite également les logiciels suivants :

• Chaîne d'outils Mingw-w64 13.1

Installez les prérequis et ajoutez leurs chemins d'accès binaires à l'PATH s du système :

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

Pour vérifier l'installation, exécutez :

where mingw32-make.exe

La commande doit d'abord afficher mingw32-make.exe sous le chemin <MINGW_ROOT>.

Obtenir les sources

Vous pouvez télécharger les sources Qt depuis la page de téléchargement de Qt, ou suivre le guide du wiki intitulé « Obtenir le code source ».

Configuration

Avec Qt 6, vous pouvez compiler Qt pour Android à partir du code source à l'aide de CMake. Qt 6 pour Android nécessite une compilation Qt hôte, ce qui signifie que pour compiler Qt pour Android, vous devez d'abord compiler Qt pour la plateforme de bureau utilisée comme hôte (c'est-à-dire Linux, macOS ou Windows). Voir « Compilation croisée de Qt » pour plus de détails.

Pour configurer Qt pour Android, créez un répertoire de compilation « shadow » afin de préserver la propreté du répertoire source :

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Qt pour Android prend en charge les architectures de périphériques (ABI) suivantes : arm64-v8a, x86_64, x86, et armeabi-v7a

Exécutez ensuite le script `configure` depuis le répertoire de compilation que vous venez de créer :

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

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\

Arguments avancés de `configure`

Avant de consulter cette section, consultez la page Options de configuration de Qt, qui contient davantage d’informations sur les options de configuration.

Qt pour Android contient du code Java compilé en fichiers *.jar à l’aide du compilateur javac. Pour définir la version de javac pour la source et la cible, utilisez respectivement -android-javac-source et -android-javac-target:

-android-javac-source 17 -android-javac-target 17

Pour compiler Qt en tant que version développeur plutôt qu’en tant que version préfixée, utilisez ce qui suit à la place de l’argument ` -prefix ` :

-developer-build

L'argument « -qt-host-path » doit pointer vers le répertoire « qtbase » situé dans le répertoire de compilation de l'hôte, dans le cadre d'une compilation développeur sur l'hôte. Par exemple : ~/dev/build-qt-host/qtbase.

Compilation

Pour compiler Qt, exécutez la commande suivante :

cmake --build . --parallel

Installation

Pour les compilations avec préfixe, pour installer Qt, exécutez la commande suivante :

cmake --install .

Sous Unix, si vous n’avez pas spécifié l’option de configuration ` -prefix <install_path> `, l’installation est placée dans le répertoire ` /usr/local/Qt-<version>` ; dans ce cas, vous devrez utiliser ` sudo ` avec la commande d’installation.