Qt pour macOS - Construction à partir des sources

Conditions requises

La construction de Qt nécessite l'installation du SDK de la plateforme macOS et de la chaîne d'outils correspondante sur le système. Vous pouvez les obtenir en installant le Xcode, comme décrit dans l'environnement de construction.

Vous devez toujours utiliser exactement la même version de Xcode et de SDK que celle indiquée dans les Configurations prises en charge, afin de vous assurer que Qt Test a été testé dans la configuration que vous construisez.

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

• CMake (>=3.22)
• Ninja

Si vous voulez construire Qt WebEngine ou Qt PDFvous 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, reportez-vous à la section Installation de Clang pour QDoc pour connaître les exigences spécifiques en matière de compilation.

Étapes de construction

Les instructions suivantes décrivent comment construire Qt à partir du paquetage source. Vous pouvez télécharger les sources de Qt à partir de la page Téléchargements. Pour plus d'informations, visitez la page Getting Started with Qt.

Étape 1 : Décompression de l'archive

Décompressez l'archive si vous ne l'avez pas encore fait. Par exemple, si vous avez le paquetage qt-everywhere-src-6.11.0.tar.xz, tapez les commandes suivantes à l'invite de la ligne de commande :

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

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

Étape 2 : Construction de la bibliothèque Qt

Pour configurer la bibliothèque Qt pour votre type de machine, créez un répertoire de construction 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.11.0/configure

Par défaut, Qt XML est configuré pour être installé dans le répertoire /usr/local/6.11.0, mais cela peut être modifié en utilisant l'option -prefix.

Par défaut, Qt XML est construit comme un framework, mais vous pouvez le construire comme un ensemble de bibliothèques dynamiques (dylibs) en spécifiant l'option -no-framework.

Comme décrit dans Architectures, Qt est construit par défaut pour l'architecture de votre machine de développement. Pour configurer une compilation universelle de Qt prenant en charge 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 construit 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 -prefix se trouve en dehors du répertoire de construction, vous devez installer la bibliothèque, les exemples et les outils à l'endroit approprié. Pour ce faire, tapez :

cmake --install .

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

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

Afin d'utiliser Qt, certaines variables d'environnement doivent être étendues.

PATH               - to locate qmake, moc and other Qt tools

Cela se fait de la manière suivante :

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 .login (si votre shell est csh ou tcsh), ajoutez la ligne suivante :

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

Si vous utilisez un shell différent, veuillez modifier vos variables d'environnement en conséquence.

Qt est maintenant installé.