Platform Notes

Many cross-platform projects can be handled by the basic qmake configuration features. However, on some platforms, it is sometimes useful, or even necessary, to take advantage of platform-specific features. qmake knows about many of these features, which can be accessed via specific variables that only take effect on the platforms where they are relevant.

OS X and iOS

Features specific to these platforms include support for creating universal binaries, frameworks and bundles.

Source and Binary Packages

The version of qmake supplied in source packages is configured slightly differently to that supplied in binary packages in that it uses a different feature specification. Where the source package typically uses the macx-g++ specification, the binary package is typically configured to use the macx-xcode specification.

Users of each package can override this configuration by invoking qmake with the -spec option (see Running qmake for more information). For example, to use qmake from a binary package to create a Makefile in a project directory, invoke the following command:

qmake -spec macx-g++

Using Frameworks

qmake is able to automatically generate build rules for linking against frameworks in the standard framework directory on OS X, located at /Library/Frameworks/.

Directories other than the standard framework directory need to be specified to the build system, and this is achieved by appending linker options to the QMAKE_LFLAGS variable, as shown in the following example:

QMAKE_LFLAGS += -F/path/to/framework/directory/

The framework itself is linked in by appending the -framework options and the name of the framework to the LIBS variable:

LIBS += -framework TheFramework

Creating Frameworks

Any given library project can be configured so that the resulting library file is placed in a framework, ready for deployment. To do this, set up the project to use the lib template and add the lib_bundle option to the CONFIG variable:

CONFIG += lib_bundle

The data associated with the library is specified using the QMAKE_BUNDLE_DATA variable. This holds items that will be installed with a library bundle, and is often used to specify a collection of header files, as in the following example:

FRAMEWORK_HEADERS.version = Versions
FRAMEWORK_HEADERS.files = path/to/header_one.h path/to/header_two.h

You use the FRAMEWORK_HEADERS variable to specify the headers required by a particular framework. Appending it to the QMAKE_BUNDLE_DATA variable ensures that information about these headers is added to the collection of resources that will be installed with the library bundle. Also, the framework name and version are specified by the QMAKE_FRAMEWORK_BUNDLE_NAME and QMAKE_FRAMEWORK_VERSION variables. By default, the values used for these variables are obtained from the TARGET and VERSION variables.

See Qt for OS X - Deployment for more information about deploying applications and libraries.

Creating and Moving Xcode Projects

Developers on OS X can take advantage of the qmake support for Xcode project files, as described in Qt is OS X Native, by running qmake to generate an Xcode project from an existing qmake project file. For example:

qmake -spec macx-xcode

Note: If a project is later moved on the disk, qmake must be run again to process the project file and create a new Xcode project file.

Supporting Two Build Targets Simultaneously

Implementing this is currently not feasible, because the Xcode concept of Active Build Configurations is conceptually different from the qmake idea of build targets.

The Xcode Active Build Configurations settings are for modifying Xcode configurations, compiler flags and similar build options. Unlike Visual Studio, Xcode does not allow for the selection of specific library files based on whether debug or release build configurations are selected. The qmake debug and release settings control which library files are linked to the executable.

It is currently not possible to set files in Xcode configuration settings from the qmake generated Xcode project file. The way the libraries are linked in the Frameworks & Libraries phase in the Xcode build system.

Furthermore, the selected Active Build Configuration is stored in a .pbxuser file, which is generated by Xcode on first load, not created by qmake.


Features specific to this platform include support for creating Visual Studio project files and handling manifest files when deploying Qt applications developed using Visual Studio 2005, or later.

Creating Visual Studio Project Files

Developers using Visual Studio to write Qt applications can use the Visual Studio integration facilities provided with the Qt Commercial License and do not need to worry about how project dependencies are managed.

However, some developers may need to import an existing qmake project into Visual Studio. qmake is able to take a project file and create a Visual Studio project that contains all the necessary information required by the development environment. This is achieved by setting the qmake project template to either vcapp (for application projects) or vclib (for library projects).

This can also be set using a command line option, for example:

qmake -tp vc

It is possible to recursively generate .vcproj files in subdirectories and a .sln file in the main directory, by typing:

qmake -tp vc -r

Each time you update the project file, you need to run qmake to generate an updated Visual Studio project.

Note: If you are using the Visual Studio Add-in, select Qt > Import from .pro file to import .pro files.

Visual Studio Manifest Files

When deploying Qt applications built using Visual Studio 2005, or later, make sure that the manifest file that was created when the application was linked is handled correctly. This is handled automatically for projects that generate DLLs.

Removing manifest embedding for application executables can be done with the following assignment to the CONFIG variable:

CONFIG -= embed_manifest_exe

Also, the manifest embedding for DLLs can be removed with the following assignment to the CONFIG variable:

CONFIG -= embed_manifest_dll

This is discussed in more detail in the deployment guide for Windows.

© 2015 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.