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 compilation, fournissent 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 exécuter qmake se présente sous la forme simple suivante :

qmake [mode] [options] files

Modes de fonctionnement

qmake prend en charge deux modes de fonctionnement différents. En 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'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.
  

  Remarque : il est probable que le fichier créé doive être modifié. Par exemple, en ajoutant la variable « QT » pour l’adapter aux modules requis par le projet.

Vous pouvez utiliser la variable ` options ` pour spécifier à la fois des paramètres généraux et des paramètres 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 celles qui influencent la création de 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 compilation et de remplacer les paramètres par défaut de votre plate-forme. Les options de base suivantes fournissent une aide sur l’utilisation de qmake, spécifient l’emplacement où qmake écrit le fichier de sortie et contrôlent le niveau d’informations de débogage qui seront affichées sur la console :

• -help
  qmake passera en revue ces fonctionnalités et fournira des conseils utiles.
• -o file
  La sortie de qmake sera redirigée vers . Si cette option n’est pas spécifiée, qmake tentera 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 redirigée vers stdout. file
  
• -d
  qmake affichera des informations de débogage. Ajouter « » plusieurs fois augmente le niveau de détail. -d

Le modèle utilisé pour le projet est généralement spécifié par la variable TEMPLATE dans le fichier de projet. Vous pouvez le remplacer ou le modifier à l’aide des options suivantes :

• -t tmpl
  qmake remplacera toutes les variables « » définies par « », mais uniquement TEMPLATE tmplaprès le traitement du fichier .pro.
• -tp prefix
  qmake ajoutera à la variable . prefix TEMPLATE

Le niveau d’information des avertissements peut être ajusté pour vous aider à détecter les problèmes dans votre fichier de projet :

• -Wall
  qmake signalera tous les avertissements connus.
• -Wnone
  Aucun message d’avertissement ne sera généré par qmake.
• -Wparser
  qmake ne générera que des avertissements liés à l’analyse syntaxique. Cela vous alertera des pièges courants et des problèmes potentiels lors de l’analyse syntaxique 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érera un Makefile utilisé pour construire le projet. De plus, les options suivantes peuvent être utilisées dans ce mode pour influencer la manière dont le fichier de projet est généré :

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

Vous pouvez également passer des options à 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 celle-ci est spécifiée, toutes les affectations de la ligne de commande situées après l’option « -after » seront reportées jusqu’à ce que les fichiers spécifiés aient été 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 explorera récursivement les répertoires indiqués.
• -nopwd
  qmake ne recherchera pas le code source dans votre répertoire de travail actuel. Il utilisera uniquement les répertoires spécifiés par l’option ` `. 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 qu’il contient sera intégré au fichier de projet généré. Si un fichier est fourni, il sera ajouté à la variable appropriée, en fonction de son extension. Par exemple, les fichiers d’interface utilisateur 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 fin du fichier de projet généré.