Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions | ![]() |
This reference is a detailed index of all command line options, configurations and internal variables used by the cross-platform makefile generation utility qmake.
qmake [options] files
The following options can be specified on the command line to qmake:
-o file
qmake output will be directed to file. If this argument is not specified then qmake will try to guess a suitable name, if '-' is specified output is directed to stdout.
-unix
qmake will run in unix mode. In this mode, Unix file naming and path conventions will be used. This is the default mode on all Unices.
-win32
qmake will run in win32 mode. In this mode, Windows file naming and path conventions will be used. This is the default mode on Windows.
-d
qmake will output useful debugging information.
-t tmpl
qmake will override any set TEMPLATE variables with tmpl.
-help
qmake will go over these features and give some useful help.
QMake supports two different modes of operation. The first mode (and default) is makefile generation, in this mode qmake will take a .pro file and turn it into a makefile. This is the mode documented in this guide, however there is an additional mode in qmake to generate .pro files.
To toggle between these modes you must specify in the first argument what mode you want, if no mode is specified qmake will assume you want makefile mode, the available mode switches are:
-makefile
qmake output will be a makefile (Makefile mode).
-project
qmake output will be a project file (Project file mode).
In Makefile mode QMake will generate a makefile. Additionally you may supply the following arguments in this mode:
-nocache
qmake will ignore the .qmake.cache file.
-nodepend
qmake will not generate any dependency information.
-cache file
qmake will use file as the cache file, ignoring any other .qmake.cache file found
-spec spec
qmake will use spec as a path to platform-compiler information and QMAKESPEC will be ignored.
The files argument can be a list of one or more project files, separated by spaces. You may also pass qmake assignments on the commandline here and they will be processed before all files specified, for example:
qmake -makefile -unix -o Makefile "CONFIG+=test" test.pro
This will generate a Makefile from test.pro, with Unix pathnames, however many of these arguments aren't necessary as they are the default. Therefore the line can be simplified on Unix to:
qmake "CONFIG+=test" test.pro
In Projectfile mode QMake will generate a project file. Additionally you may supply the following arguments in this mode:
-nopwd
qmake will not look in your current working directory for source code and only use the specified files
The files argument can be a list of files or directories, if a directory is specified then this will be included in the DEPENDPATH variable and relevant code from there will be included in the generated project file, if a file is given it will go into the correct variable depending on extension (i.e. .ui files go into FORMS, .cpp files go into SOURCES, etc).
The following variables are recognized by qmake and are used most frequently when creating project files.
The CONFIG variable specifies project configuration and compiler options. The values will be recognized internally by qmake and have several special meaning. They are as follows.
These CONFIG values control compilation flags:
release - Compile with optimization enabled, ignored if "debug" is specified
debug - Compile with debug options enabled
warn_on - The compiler should emit more warnings than normally, ignored if "warn_off" is specified
warn_off - The compiler should emit no warnings except severe warnings.
These options define the application/library type:
qt - The target is a Qt application/library and requires the Qt header files/library. The proper include and library paths for the Qt library will automatically be added to the project.
opengl - The target requires the OpenGL (or Mesa) headers/libraries. The proper include and library paths for these libraries will automatically be added to the project.
thread - The target is a multi-threaded application or library. The proper defines and compiler flags will automatically be added to the project.
x11 - The target is a X11 application or library. The proper include paths and libraries will automatically be added to the project.
windows - The target is a Win32 window application (app only). The proper include paths,compiler flags and libraries will automatically be added to the project.
console - The target is a Win32 console application (app only). The proper include paths, compiler flags and libraries will automatically be added to the project.
dll - The target is a shared object/DLL.The proper include paths, compiler flags and libraries will automatically be added to the project.
staticlib - The target is a static library (lib only). The proper compiler flags will automatically be added to the project.
plugin - The target is a plugin (lib only). This enables dll as well.
The CONFIG variable will also be checked when resolving scopes. You may assign anything to this variable.
For example:
CONFIG += qt console newstuff ... newstuff { SOURCES += new.cpp HEADERS += new.h }
qmake adds the values of this variable as compiler C preprocessor macros (-D option).
For example:
DEFINES += USE_MY_STUFF QT_DLL
This is only used on Windows when using the 'app' template.
Specifies a .def file to be included in the project.
Specifies where to put the target file.
For example:
DESTDIR = ../../lib
Specifies where to copy the target dll.
Defines the header files for the project.
qmake will generate dependency information (unless -nodepend is specified on the command line) for the specified headers. qmake will also automatically detect if moc is required by the classes in these headers, and add the appropriate dependencies and files to the project for generating and linking the moc files.
For example:
HEADERS = myclass.h \ login.h \ mainwindow.h
See also SOURCES.
This variable specifies the #include directories which should be searched when compiling the project. Use ';' or a space as the directory separator.
For example:
INCLUDEPATH = c:\msdev\include d:\stl\include
This variable specifies the .ui files (see Qt Designer) to be processed through uic before compiling. All dependencies, headers and source files required to build these .ui files will automatically be added to the project.
For example:
FORMS = mydialog.ui \ mywidget.ui \ myconfig.ui
This variable contains a list of lex source files. All dependencies, headers and source files will automatically be added to the project for building these lex files.
For example:
LEXSOURCES = lexer.l
This variable contains a list of libraries to be linked into the project.
For example:
unix:LIBS += -lmath -L/usr/local/lib win32:LIBS += c:\mylibs\math.lib
This variable specifies the directory where all intermediate moc files should be placed.
For example:
unix:MOC_DIR = ../myproject/tmp win32:MOC_DIR = c:\myproject\tmp
This variable specifies the directory where all intermediate object should be placed.
For example:
unix:OBJECTS_DIR = ../myproject/tmp win32:OBJECTS__DIR = c:\myproject\tmp
This is a special variable processed by qmake. If the contents of this variable do not appear in CONFIG by the time this variable is assigned to then a minimal makefile will be generated that states what dependencies (the values assigned to REQUIRES) were missing.
This is mainly used in Qt's build system for building the examples.
This variable contains the name of all source files in the project.
For example:
SOURCES = myclass.cpp \ login.cpp \ mainwindow.cpp
See also HEADERS
This variable, when used with the 'subdir' TEMPLATE contains the names of all subdirectories to look for a project file.
For example:
SUBDIRS = kernel \ tools
This specifies the name of the target file.
For example:
TEMPLATE = app TARGET = myapp SOURCES = main.cpp
The above project file would produce an executable named 'myapp' on unix and 'myapp.exe' on windows.
This variable contains the name of the template to use when generating the project. The allowed values are:
app - Creates a makefile for building applications (the default)
lib - Creates a makefile for building libraries
subdirs - Creates a makefile for building targets in subdirectories
vcapp - win32 only Creates an application project file
vclib - win32 only Creates a library project file
For example:
TEMPLATE = lib SOURCES = main.cpp TARGET = mylib
This variable contains the version number of the library, if the 'lib' TEMPLATE is specified.
For example:
VERSION = 1.2.3
This variable contains a list of yacc source files to be included in the project. All dependencies, headers and source files will automatically be included in the project.
For example:
YACCSOURCES = moc.y
The following variables are also recognized by qmake but are either internal or very rarely used.
This variable is set internally by qmake which is basically the DESTDIR variable with the TARGET variable appened at the end. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is set internally by qmake which specifies where the dsp template file for basing generated dsp files is stored. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains a list of lex implementation files. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the names of intermediate lex object files.The value of this variable is typically handled by qmake and rarely needs to be modified.
This variable specifies the name of the makefile which qmake should use when outputting the dependency information for building a project. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the makefile generator to use when generating a makefile. The value of this variable is typically handled internally by qmake and rarely needs to be modified.
This variable is generated from the SOURCES variable. The extension of each source file will have been replaced by .o (Unix) or .obj (Win32). The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is set by qmake if files can be found that contain the Q_OBJECT macro. OBJMOC contains the name of all intermediate moc object files. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains a list of header files that require some sort of pre-compilation step (such as with moc). The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the qmake program itself and is placed in generated makefiles. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the qmake configuration to use when generating makefiles. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified. Use the QMAKESPEC environment variable instead.
If this variable is not empty, then this variable tells qmake to generate the TARGET as an AIX shared library.
This variable is empty unless the 'app' TEMPLATE is specified. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified. Use the following instead:
app { #conditional code for 'app' template here }
This variable is empty unless the 'app' or 'dll' TEMPLATE is specified. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains the command for invoking the program which creates, modifies and extracts archives. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the flags for the C compiler in debug mode.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the compiler flags for creating a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the compiler flags for creating a debuggable multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains the compiler flags for creating a multi-threaded dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains the compiler flags for creating a debuggable multi-threaded dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the compiler flags for creating a non-debuggable application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains the compiler flags for creating a shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the compiler flags for creating a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is not empty if the warn_off TEMPLATE option is specified. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is not empty if the warn_on TEMPLATE option is specified. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains any files which are not generated files (such as moc and uic generated files) and object files that should be removed when using "make clean".
This variable contains the C++ compiler flags for creating a debuggable application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for creating a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for creating a debuggable multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains the C++ compiler flags for creating a multi-threaded dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains the C++ compiler flags for creating a multi-threaded debuggable dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for creating an application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for creating a shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for creating a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the C++ compiler flags for suppressing compiler warnings. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains C++ compiler flags for generating compiler warnings. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the extention for shared libraries. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the list of requirements that were failed to be met when qmake was ran, such as, the sql module is needed and wasn't compiled into Qt. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the file tags needed to be entered into the makefile, such as SOURCES and HEADERS. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
If this variable is not empty then this variable tells qmake to generate the TARGET as an HPUX shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
If this variable is not empty then this variable tells qmake to generate the TARGET as an HPUX shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of all known header files to be added to INCLUDEPATH when building an application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of OpenGL header files to be added to INCLUDEPATH when building an application with OpenGL support. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of all known header files paths to be added to INCLUDEPATH when building a Qt application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of all known header files paths to be added to INCLUDEPATH when building a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains the location of X11 header files paths to be added to INCLUDEPATH when building a X11 application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains link flags when building console programs. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains link flags when building console dlls. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building debuggable applications. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building plugins. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building programs that use the Qt library built as a dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building applications for release. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building applications which are using the 'app' template. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building shared libraries The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the name of shared objects, such as .so or .dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains link flags when building multi-threaded projects. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains link flags when building windows projects. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains link flags when building windows dll projects. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of all known library directories.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains the location of all library directory with -L prefixed. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of the OpenGL library directory.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of the Qt library directory.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains the location of the X11 library directory.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all project libraries. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains all project libraries that should be linked against when building a console application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all OpenGL libraries. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all OpenGL Qt libraries.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all Qt libraries.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains all Qt libraries when Qt is built as a dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all the libraries needed to link against if OpenGL support is turned on. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains all the libraries needed to link against if thread support is turned on. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used with Borland compilers only
This variable contains the runtime library needed to link against when building an application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used with Borland compilers only
This variable contains the runtime library needed to link against when building a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains all libraries that need to be linked against when building a multi-threaded application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Windows only
This variable contains all windows libraries.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains all X11 libraries.The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This is used on Unix platforms only
This variable contains all X11 session management libraries. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is not empty if the 'lib' template is specified. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the command to execute when creating a shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the command to execute when creating a link to a shared library. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the makefile to create. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the names of all moc source files to generate and include in the project. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the location of qmake if it is not in the path. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is not empty if Qt was built as a dll. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the individual rule needed to build an object. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the individual rule needed to build an object. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the individual rule needed to build an object. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the individual rule needed to build an object. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the project target. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the resource file for the application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the name of the resource file for the application. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is set by qmake if files can be found that contain the Q_OBJECT macro. SRCMOC contains the name of all the generated moc files. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the target's extension. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the target's extension with a major version number. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable specifies the target's extension with version number. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains a list of the generated implementation files by UIC. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable is generated from the UICIMPLS variable. The extension of each file will have been replaced by .o (Unix) or .obj (Win32). The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains the major version number of the library, if the 'lib' template is specified.
This variable contains the minor version number of the library, if the 'lib' template is specified.
This variable contains the patch version number of the library, if the 'lib' template is specified.
This variable contains a list of yacc source files. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
This variable contains a list of yacc object files. The value of this variable is typically handled by qmake or qmake.conf and rarely needs to be modified.
qmake recognizes the following functions:
This function will include the contents of filename into the current project at the point it was included. The function succeeds if filename was included, otherwise it fails. You can check the return value of this function using a scope.
For example:
include( shared.pri ) OPTIONS = standard custom !include( options.pri ) { message( "No custom build options specified" ) OPTIONS -= custom }
This function will test if file exists, if so it will succeed; otherwise it will fail. You can specify a regular expression in file and it will succeed if any file matches the regular expression specified.
For example:
exists( $(QTDIR)/lib/qt-mt* ) { message( "Configuring for multi-threaded Qt..." ) CONFIG += thread }
This function will succeed if the variable variablename contains the value value. You can check the return value of this function using a scope.
For example:
contains( drivers, network ) { # drivers contains 'network' message( "Configuring for network build..." ) HEADERS += network.h SOURCES += network.cpp }
This function will succeed if the variable variablename contains number elements, otherwise it will fail. You can check the return value of this function using a scope.
For example:
MYVAR = one two three count( MYVAR, 3 ) { # always true }
This function will succeed if the variable variablename is empty (same as count(variable, 0)).
This function will execute command in a secondary shell and will succeed if the command exits with a exit status of 1.You can check the return value of this function using a scope.
For example:
system(ls /bin):HAS_BIN=FALSE
This function will always succeed, and will display the given string to the user.
This function will never return. It will display the given string to the user, and then exit qmake. This function should only be used for very fatal configurations
For example:
release:debug:error(You can't have release and debug at the same time!)
qmake requires a platform and compiler description file which contains many default values used to generate appropriate makefiles. The standard Qt distribution comes with many of these files, located in the 'mkspecs' subdirectory of the Qt installation.
The QMAKESPEC environment variable can contain any of the following:
A complete path to a directory containing a qmake.conf file. In this case qmake will open the qmake.conf file from within that directory. If the file does not exist, qmake will exit with an error.
The name of a platform-compiler combination. In this case, qmake will search in the directory specified by the QTDIR environment variable.
Note: the QMAKESPEC path will automatically be added to the INCLUDEPATH system variable.
The cache file (mentioned above in the options) is a special file qmake will read to find settings not specified in the qmake.conf file, the .pro file, or the command line. If neither -path or -nocache are specified qmake will try to find a file called .qmake.cache in parent directories. If it fails to find this file it will silently ignore this step of processing.
Copyright © 2001 Trolltech | Trademarks | Qt version 3.0.0-beta6
|