Qt pour Android - Construction à partir des sources

Cette page décrit le processus de configuration et de construction de Qt pour Android. Pour télécharger et installer une version préconstruite de Qt pour Android, suivez les instructions de la page Démarrer avec Qt.

Conditions préalables

Pour construire Qt pour Android à partir des sources, veuillez vous assurer que toutes les exigences de la page Démarrer avec Qt pour Android sont remplies avant de continuer.

Windows

La construction de Qt pour Android sur Windows nécessite également le logiciel suivant :

• Chaîne d'outils Mingw-w64 13.1

Installez les prérequis et ajoutez leurs chemins binaires au système PATH:

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 répertorier mingw32-make.exe sous le chemin <MINGW_ROOT> en premier.

Obtenir les sources

Vous pouvez télécharger les sources de Qt à partir de la page de téléchargement de Qt, ou suivre le guide wiki pour obtenir le code source.

Configuration

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

Pour configurer Qt pour Android, créez un répertoire de construction fictif pour garder le répertoire source propre :

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 de configuration à partir du répertoire de construction 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 dans les emplacements suivants :

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

Arguments de configuration avancés

Avant d'explorer cette section, consultez les options de configuration de Qt, qui contiennent plus d'informations sur les options de configuration.

Qt pour Android contient du code Java compilé dans des fichiers *.jar avec le 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 8 -android-javac-target 8

Pour construire Qt XML en tant que build développeur au lieu d'un build préfixe, utilisez ce qui suit à la place de l'argument -prefix:

-developer-build

L'argument -qt-host-path doit pointer vers le répertoire qtbase dans le répertoire de construction de l'hôte dans le cas d'une construction de développeur de l'hôte. Par exemple : ~/dev/build-qt-host/qtbase.

Construction

Pour compiler Qt, exécutez la commande suivante :

cmake --build . --parallel

Installation

Pour les versions préfixes, pour installer Qt, exécutez la commande suivante :

cmake --install .

Sous Unix, si vous n'avez pas fourni l'option de configuration -prefix <install_path>, l'installation est placée sous /usr/local/Qt-<version>, dans ce cas, vous devez utiliser sudo avec la commande install.