Running qmake

Options

A wide range of options can be specified on the command line to qmake in order to customize the build process, and to override default settings for your platform. The following basic options provide usage information, specify where qmake writes the output file, and control the level of debugging information that will be written to the console:

• -help
  qmake will go over these features and give some useful help.
• -o file
  qmake output will be directed to file. If this option is not specified, qmake will try to use a suitable file name for its output, depending on the mode it is running in.
  If '-' is specified, output is directed to stdout.
• -d
  qmake will output debugging information.

For projects that need to be built differently on each target platform, with many subdirectories, you can run qmake with each of the following options to set the corresponding platform-specific variable in each project file:

• -unix
  qmake will run in unix mode. In this mode, Unix file naming and path conventions will be used, additionally testing for unix (as a scope) will succeed. This is the default mode on all Unices.
• -macx
  qmake will run in Mac OS X mode. In this mode, Unix file naming and path conventions will be used, additionally testing for macx (as a scope) will succeed. This is the default mode on Mac OS X.
• -win32
  qmake will run in win32 mode. In this mode, Windows file naming and path conventions will be used, additionally testing for win32 (as a scope) will succeed. This is the default mode on Windows.

The template used for the project is usually specified by the TEMPLATE variable in the project file. We can override or modify this by using the following options:

• -t tmpl
  qmake will override any set TEMPLATE variables with tmpl, but only after the .pro file has been processed.
• -tp prefix
  qmake will add the prefix to the TEMPLATE variable.

The level of warning information can be fine-tuned to help you find problems in your project file:

• -Wall
  qmake will report all known warnings.
• -Wnone
  No warning information will be generated by qmake.
• -Wparser
  qmake will only generate parser warnings. This will alert you to common pitfalls and potential problems in the parsing of your project files.
• -Wlogic
  qmake will warn of common pitfalls and potential problems in your project file. For example, qmake will report whether a file is placed into a list of files multiple times, or if a file cannot be found.

    qmake -makefile [options] files

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

    qmake "CONFIG+=test" test.pro

    qmake -project [options] files