Qt pour macOS - Compilation à partir du code source

Prérequis

La compilation de Qt nécessite l'installation sur le système d'un SDK de la plateforme macOS et de la chaîne d'outils correspondante. Vous pouvez vous les procurer en installant Xcode, comme décrit dans la section Environnement de compilation.

Vous devez toujours utiliser exactement les mêmes versions de Xcode et du SDK que celles répertoriées dans la section « Configurations prises en charge », afin de vous assurer que Qt a bien été testé dans la configuration que vous utilisez pour la compilation.

En plus d'Xcode, vous devrez vous assurer que les dépendances suivantes se trouvent dans votre chemin d'accès : PATH.

• CMake (>=3.25)
• Ninja

Si vous souhaitez compiler Qt WebEngine ou Qt PDF, vous aurez besoin des dépendances supplémentaires suivantes :

• Python, html5lib
• Bison, Flex
• Gperf
• Node.js version 8 ou ultérieure (version 12 recommandée)

Dépendances de QDoc

QDoc utilise Clang pour analyser le code C++. Si vous souhaitez compiler QDoc manuellement, consultez la section « Installation de Clang pour QDoc » pour connaître les exigences de compilation spécifiques.

Étapes de compilation

Les instructions suivantes décrivent comment compiler Qt à partir du paquet source. Vous pouvez télécharger les sources de Qt depuis la page Téléchargements. Pour plus d'informations, consultez la page « Premiers pas avec Qt ».

Étape 1 : décompresser l'archive

Décompressez l'archive si vous ne l'avez pas encore fait. Par exemple, si vous disposez du paquet qt-everywhere-src-6.12.0.tar.xz, tapez les commandes suivantes dans une invite de commande :

cd /tmp
tar xf ~/Downloads/qt-everywhere-src-6.12.0.tar.xz

Cela crée le répertoire /tmp/qt-everywhere-src-6.12.0 contenant les fichiers de l’archive.

Étape 2 : Compiler la bibliothèque Qt

Pour configurer la bibliothèque Qt en fonction de votre type de machine, créez un répertoire de compilation et accédez-y. Exécutez le script « ./configure » dans ce répertoire.

mkdir -p ~/dev/qt-build
cd ~/dev/qt-build
/tmp/qt-everywhere-src-6.12.0/configure

Par défaut, Qt est configuré pour être installé dans le répertoire « /usr/local/6.12.0 », mais cela peut être modifié à l’aide de l’option « -prefix ».

Par défaut, Qt est compilé en tant que framework, mais vous pouvez le compiler sous forme d’un ensemble de bibliothèques dynamiques (dylibs) en spécifiant l’option -no-framework.

Comme décrit dans la section Architectures, Qt est compilé par défaut pour l’architecture de votre machine de développement. Pour configurer une compilation universelle de Qt prenant en charge à la fois les Mac Intel et Apple Silicon, ajoutez l’argument suivant :

./configure -- -DCMAKE_OSX_ARCHITECTURES="x86_64;arm64"

Veillez à spécifier l’architecture Intel (« x86_64 ») en premier, sinon Qt risque de ne pas activer toutes les fonctionnalités x86.

Qt peut également être configuré pour être compilé avec des symboles de débogage. Ce processus est décrit en détail dans le document Techniques de débogage.

La page Options de configuration contient plus d'informations sur les options de configuration.

Pour créer la bibliothèque et compiler tous les exemples et outils, tapez :

cmake --build . --parallel

Si le fichier « -prefix » se trouve en dehors du répertoire de compilation, vous devez installer la bibliothèque, les exemples et les outils à l’emplacement approprié. Pour ce faire, tapez :

cmake --install .

Cette commande nécessite que vous disposiez d’un accès administrateur sur votre machine.

Étape 3 : Définir les variables d’environnement

Pour pouvoir utiliser Qt, certaines variables d'environnement doivent être définies.

PATH               - to locate qmake, moc and other Qt tools

Pour ce faire, procédez comme suit :

Dans ` .profile ` (si votre shell est bash) ou ` .zshenv ` (pour zsh), ajoutez les lignes suivantes :

PATH=/usr/local/Qt-%VERSION%/bin:$PATH
export PATH

Dans le fichier ` .login ` (si votre shell est csh ou tcsh), ajoutez la ligne suivante :

setenv PATH /usr/local/Qt-%VERSION%/bin:$PATH

Si vous utilisez un autre shell, veuillez modifier vos variables d’environnement en conséquence.

Qt est désormais installé.