Exécution de qmake

Le comportement de qmake peut être personnalisé lors de son exécution en spécifiant diverses options sur la ligne de commande. Celles-ci permettent d'affiner le processus de construction, de fournir des informations de diagnostic utiles et peuvent être utilisées pour spécifier la plate-forme cible de votre projet.

Syntaxe de la commande

La syntaxe utilisée pour lancer qmake prend la forme simple suivante :

qmake [mode] [options] files

Modes de fonctionnement

qmake prend en charge deux modes de fonctionnement différents. Dans le mode par défaut, qmake utilise les informations contenues dans un fichier de projet pour générer un Makefile, mais il est également possible d'utiliser qmake pour générer des fichiers de projet. Si vous souhaitez définir explicitement le mode, vous devez le spécifier avant toutes les autres options. L'adresse mode peut prendre l'une des deux valeurs suivantes :

• -makefile
  la sortie de qmake sera un Makefile.
• -project
  La sortie de qmake sera un fichier de projet.
  

  Note : Il est probable que le fichier créé doive être édité. Par exemple, en ajoutant la variable QT en fonction des modules requis pour le projet.

Vous pouvez utiliser options pour spécifier des paramètres généraux et spécifiques à un mode. Les options qui s'appliquent uniquement au mode Makefile sont décrites dans la section Options du mode Makefile, tandis que les options qui influencent la création des fichiers de projet sont décrites dans la section Options du mode Projet.

Fichiers

L'argument files représente une liste d'un ou plusieurs fichiers de projet, séparés par des espaces.

Options générales

Un large éventail d'options peut être spécifié sur la ligne de commande de qmake afin de personnaliser le processus de construction et d'ignorer les paramètres par défaut de votre plate-forme. Les options de base suivantes fournissent de l'aide sur l'utilisation de qmake, spécifient où qmake écrit le fichier de sortie, et contrôlent le niveau d'information de débogage qui sera écrit sur la console :

• -help
  qmake passera en revue ces fonctionnalités et fournira une aide utile.
• -o file
  La sortie de qmake sera dirigée vers file. Si cette option n'est pas spécifiée, qmake essaiera d'utiliser un nom de fichier approprié pour sa sortie, en fonction du mode dans lequel il s'exécute.
  Si '-' est spécifié, la sortie est dirigée vers stdout.
• -d
  qmake affichera des informations de débogage. L'ajout de -d plus d'une fois augmente la verbosité.

Le modèle utilisé pour le projet est généralement spécifié par la variable TEMPLATE dans le fichier de projet. Vous pouvez l'ignorer ou le modifier en utilisant les options suivantes :

• -t tmpl
  qmake remplacera tout ensemble de variables TEMPLATE par tmpl, mais seulement après que le fichier .pro ait été traité.
• -tp prefix
  qmake ajoutera prefix à la variable TEMPLATE.

Le niveau d'information sur les avertissements peut être affiné pour vous aider à trouver des problèmes dans votre fichier de projet :

• -Wall
  qmake signale tous les avertissements connus.
• -Wnone
  Aucune information d'avertissement ne sera générée par qmake.
• -Wparser
  qmake ne génère que les avertissements de l'analyseur. Cela vous alertera sur les pièges courants et les problèmes potentiels dans l'analyse de vos fichiers de projet.
• -Wlogic
  qmake vous avertira des pièges courants et des problèmes potentiels dans votre fichier de projet. Par exemple, qmake signalera les occurrences multiples de fichiers dans les listes et les fichiers manquants.

Options du mode Makefile

qmake -makefile [options] files

En mode Makefile, qmake génère un Makefile qui est utilisé pour construire le projet. De plus, les options suivantes peuvent être utilisées dans ce mode pour influencer la façon dont le fichier de projet est généré :

• -after
  qmake traitera les affectations données sur la ligne de commande après les fichiers spécifiés.
• -nocache
  qmake ignorera le fichier .qmake.cache.
• -nodepend
  qmake ne génère aucune information sur les dépendances.
• -cache file
  qmake utilisera file comme fichier de cache, en ignorant tout autre fichier .qmake.cache trouvé.
• -spec spec
  qmake utilisera spec comme chemin d'accès aux informations relatives à la plate-forme et au compilateur, et ignorera la valeur de QMAKESPEC.

Vous pouvez également passer des assignations qmake sur la ligne de commande. Elles sont traitées avant tous les fichiers spécifiés. Par exemple, la commande suivante génère un Makefile à partir de test.pro :

qmake -makefile -o Makefile "CONFIG+=test" test.pro

Cependant, certaines des options spécifiées peuvent être omises car il s'agit de valeurs par défaut :

qmake "CONFIG+=test" test.pro

Si vous êtes certain de vouloir que vos variables soient traitées après les fichiers spécifiés, vous pouvez passer l'option -after. Lorsque cette option est spécifiée, toutes les affectations sur la ligne de commande après l'option -after seront reportées jusqu'à ce que les fichiers spécifiés soient analysés.

Options du mode projet

qmake -project [options] files

En mode projet, qmake génère un fichier de projet. De plus, vous pouvez fournir les options suivantes dans ce mode :

• -r
  qmake cherchera dans les répertoires fournis de manière récursive.
• -nopwd
  qmake ne cherchera pas le code source dans votre répertoire de travail actuel. Il n'utilisera que le répertoire spécifié files.

Dans ce mode, l'argument files peut être une liste de fichiers ou de répertoires. Si un répertoire est spécifié, il sera inclus dans la variable DEPENDPATH, et le code pertinent de ce répertoire sera inclus dans le fichier de projet généré. Si un fichier est indiqué, il sera ajouté à la bonne variable, en fonction de son extension. Par exemple, les fichiers UI sont ajoutés à FORMS, et les fichiers C++ sont ajoutés à SOURCES.

Vous pouvez également passer des affectations sur la ligne de commande dans ce mode. Dans ce cas, ces affectations seront placées en dernier dans le fichier de projet généré.