Configuration de qmake

Propriétés

qmake dispose d'un système de configuration persistante, qui vous permet de définir une propriété dans qmake une fois, et de l'interroger à chaque fois que qmake est invoqué. Vous pouvez définir une propriété dans qmake de la manière suivante :

qmake -set PROPERTY VALUE

La propriété et la valeur appropriées doivent être substituées à PROPERTY et VALUE.

Vous pouvez récupérer ces informations dans qmake de la manière suivante :

qmake -query PROPERTY
qmake -query #queries all current PROPERTY/VALUE pairs

Ces informations seront enregistrées dans un objet QSettings (ce qui signifie qu'elles seront stockées à différents endroits pour différentes plates-formes).

La liste suivante résume les propriétés de built-in:

• QMAKE_SPEC - le nom court de l'hôte mkspec qui est résolu et stocké dans la variable QMAKESPEC pendant la construction de l'hôte.
• QMAKE_VERSION - la version actuelle de qmake
• QMAKE_XSPEC - le nom court de la cible mkspec qui est résolu et stocké dans la variable QMAKESPEC pendant la construction de la cible.
• QT_HOST_BINS - emplacement des exécutables de l'hôte
• QT_HOST_DATA - emplacement des données pour les exécutables hôtes utilisés par qmake
• QT_HOST_LIBS - emplacement des bibliothèques de l'hôte
• QT_HOST_LIBEXECS - emplacement des exécutables requis par les bibliothèques de l'hôte au moment de l'exécution
• QT_HOST_PREFIX - préfixe par défaut pour tous les chemins d'accès à l'hôte
• QT_INSTALL_ARCHDATA - emplacement des données générales de Qt dépendant de l'architecture
• QT_INSTALL_BINS - emplacement des binaires Qt (outils et applications)
• QT_INSTALL_CONFIGURATION - emplacement des paramètres de Qt. Ne s'applique pas à Windows
• QT_INSTALL_DATA - emplacement des données générales de Qt indépendantes de l'architecture
• QT_INSTALL_DOCS - emplacement de la documentation
• QT_INSTALL_EXAMPLES - emplacement des exemples
• QT_INSTALL_HEADERS - emplacement de tous les fichiers d'en-tête
• QT_INSTALL_LIBEXECS - emplacement des exécutables requis par les bibliothèques au moment de l'exécution
• QT_INSTALL_LIBS - emplacement des bibliothèques
• QT_INSTALL_PLUGINS - emplacement des plugins Qt
• QT_INSTALL_PREFIX - préfixe par défaut pour tous les chemins d'accès
• QT_INSTALL_QML - emplacement des extensions QML 2.x
• QT_INSTALL_TESTS - emplacement des cas de test Qt
• QT_INSTALL_TRANSLATIONS - emplacement des informations de traduction pour les chaînes de caractères Qt
• QT_SYSROOT - le sysroot utilisé par l'environnement de construction cible
• QT_VERSION - la version de Qt. Nous vous recommandons d'interroger les numéros de version spécifiques aux modules Qt en utilisant les variables $$QT.<module>.version à la place.

Par exemple, vous pouvez demander l'installation de Qt pour cette version de qmake avec la propriété QT_INSTALL_PREFIX:

qmake -query "QT_INSTALL_PREFIX"

Vous pouvez interroger les valeurs des propriétés dans un fichier de projet comme suit :

QMAKE_VERS = $$[QMAKE_VERSION]

QMAKESPEC

qmake nécessite un fichier de description de la plate-forme et du compilateur qui contient de nombreuses valeurs par défaut utilisées pour générer les Makefiles appropriés. La distribution standard de Qt est livrée avec un grand nombre de ces fichiers, situés dans le sous-répertoire mkspecs de l'installation de Qt.

La variable d'environnement QMAKESPEC peut contenir l'un des éléments suivants :

• un chemin complet vers un répertoire contenant un fichier qmake.conf. Dans ce cas, qmake ouvrira le fichier qmake.conf à partir de ce répertoire. Si le fichier n'existe pas, qmake sortira avec une erreur.
• Le nom d'une combinaison plate-forme-compilateur. Dans ce cas, qmake cherchera dans le répertoire spécifié par le sous-répertoire mkspecs du chemin de données spécifié lors de la compilation de Qt (voir QLibraryInfo::DataPath).

Fichier cache

Le fichier cache est un fichier spécial que qmake lit pour trouver les paramètres non spécifiés dans le fichier qmake.conf, les fichiers de projet ou la ligne de commande. Lorsque qmake est lancé, il recherche un fichier appelé .qmake.cache dans les répertoires parents du répertoire actuel, à moins que vous ne spécifiiez -nocache. Si qmake ne trouve pas ce fichier, il ignore silencieusement cette étape du traitement.

Si qmake trouve un fichier .qmake.cache, il traitera d'abord ce fichier avant de traiter le fichier du projet.

Extensions de fichiers

Dans des circonstances normales, qmake essaiera d'utiliser les extensions de fichiers appropriées pour votre plate-forme. Cependant, il est parfois nécessaire d'outrepasser les choix par défaut pour chaque plate-forme et de définir explicitement les extensions de fichiers à utiliser par qmake. Pour ce faire, il faut redéfinir certaines variables intégrées. Par exemple, l'extension utilisée pour les fichiers moc peut être redéfinie avec l'affectation suivante dans un fichier de projet :

QMAKE_EXT_MOC = .mymoc

Les variables suivantes peuvent être utilisées pour redéfinir les extensions de fichiers courantes reconnues par qmake :

• QMAKE_EXT_MOC modifie l'extension placée sur les fichiers moc inclus.
• QMAKE_EXT_UI modifie l'extension utilisée pour Qt Widgets Designer les fichiers UI (généralement dans FORMS).
• QMAKE_EXT_PRL modifie l'extension des fichiers de dépendances de bibliothèques.
• QMAKE_EXT_LEX modifie le suffixe utilisé dans les fichiers Lex (généralement dans LEXSOURCES).
• QMAKE_EXT_YACC modifie le suffixe utilisé dans les fichiers Yacc (généralement dans YACCSOURCES).
• QMAKE_EXT_OBJ modifie le suffixe utilisé dans les fichiers objets générés.

Toutes les variables ci-dessus n'acceptent que la première valeur, vous devez donc lui attribuer une seule valeur qui sera utilisée dans l'ensemble de votre fichier de projet. Deux variables acceptent une liste de valeurs :

• QMAKE_EXT_CPP permet à qmake d'interpréter tous les fichiers portant ces suffixes comme des fichiers source C++.
• QMAKE_EXT_H fait en sorte que qmake interprète tous les fichiers avec ces suffixes comme des fichiers d'en-tête C et C++.