The following table describes the mapping of configure options to CMake arguments.
Note that not everything is implemented in configure/configure.bat yet.
The effort of this is tracked in QTBUG-85373 and QTBUG-85349.
| configure | cmake | Notes |
|---------------------------------------|---------------------------------------------------|-----------------------------------------------------------------|
| -prefix /opt/qt6 | -DCMAKE_INSTALL_PREFIX=/opt/qta6 | |
| -extprefix /opt/qt6 | -DCMAKE_STAGING_PREFIX=/opt/qt6 | |
| -hostprefix /where/ever | n/a | When cross-building Qt, we do not build for host system anymore |
| -external-hostbindir /path/to/host/qt | -DQT_HOST_PATH=/path/to/host/qt | |
| -bindir
| -DINSTALL_BINDIR= | similar for -headerdir -libdir and so on |
| -host*dir | n/a | |
| -help | n/a | Handled by configure[.bat]. |
| -verbose | | |
| -continue | | |
| -redo | n/a | Handled by configure[.bat]. |
| -recheck [test,...] | | |
| -feature-foo | -DFEATURE_foo=ON | |
| -no-feature-foo | -DFEATURE_foo=OFF | |
| -list-features | | At the moment: configure with cmake once, |
| | | then use ccmake or cmake-gui to inspect the features. |
| -list-libraries | | |
| -opensource | | |
| -commercial | | |
| -confirm-license | | |
| -release | -DCMAKE_BUILD_TYPE=Release | |
| -debug | -DCMAKE_BUILD_TYPE=Debug | |
| -debug-and-release | -G "Ninja Multi-Config" | |
| | -DCMAKE_CONFIGURATION_TYPES=Release;Debug | |
| -optimize-debug | -DFEATURE_optimize_debug=ON | |
| -optimize-size | -DFEATURE_optimize_size=ON | |
| -optimized-tools | n/a | This affects only host tools. |
| -force-debug-info | Use the RelWithDebInfo build config. | |
| -separate-debug-info | -DFEATURE_separate_debug_info=ON | |
| -gdb-index | -DFEATURE_enable_gdb_index=ON | |
| -strip | | |
| -gc-binaries | -DFEATURE_gc_binaries=ON | |
| -force-asserts | -DFEATURE_force_asserts=ON | |
| -developer-build | -DFEATURE_developer_build=ON | |
| -shared | -DBUILD_SHARED_LIBS=ON | |
| -static | -DBUILD_SHARED_LIBS=OFF | |
| -framework | -DFEATURE_framework=ON | |
| -platform | -DQT_QMAKE_TARGET_MKSPEC= | |
| -xplatform | -DQT_QMAKE_TARGET_MKSPEC= | Only used for generating qmake-compatibility files. |
| -device | equivalent to -xplatform devices/ | |
| -device-option | -DQT_QMAKE_DEVICE_OPTIONS=key1=value1;key2=value2 | Only used for generation qmake-compatibility files. |
| | | The device options are written into mkspecs/qdevice.pri. |
| -appstore-compliant | | |
| -qtnamespace | -DQT_NAMESPACE= | |
| -qtlibinfix | | |
| -testcocoon | | |
| -gcov | | |
| -trace [backend] | | |
| -sanitize | -DFEATURE_sanitize_ | |
| -coverage | | |
| -c++std c++2a | -DFEATURE_cxx2a=ON | |
| -sse2/sse3/-ssse3/-sse4.1 | | |
| -mips_dsp/-mips_dspr2 | | |
| -qreal | -DQT_COORD_TYPE= | |
| -R | -DQT_EXTRA_RPATHS=path1;path2 | |
| -rpath | negative CMAKE_SKIP_BUILD_RPATH | |
| | negative CMAKE_SKIP_INSTALL_RPATH | |
| -reduce-exports | | |
| -reduce-relocations | -DFEATURE_reduce_relocations=ON | |
| -plugin-manifests | | |
| -static-runtime | -DFEATURE_static_runtime=ON | |
| -pch | -DBUILD_WITH_PCH=ON | |
| -ltcg | | |
| -linker [bfd,gold,lld] | -DINPUT_linker= or | |
| | -DFEATURE_use__linker=ON | |
| -incredibuild-xge | | |
| -ccache | -DQT_USE_CCACHE=ON | |
| -make-tool | n/a | |
| -mp | n/a | |
| -warnings-are-errors | -DWARNINGS_ARE_ERRORS=ON or | |
| | -DFEATURE_warnings_are_errors=ON | |
| -silent | n/a | |
| -sysroot | -DCMAKE_SYSROOT= | Should be provided by a toolchain file that's |
| | | passed via -DCMAKE_TOOLCHAIN_FILE= |
| -no-gcc-sysroot | | |
| -no-pkg-config | | |
| -D | -DQT_EXTRA_DEFINES=; | |
| -I | -DQT_EXTRA_INCLUDEPATHS=; | |
| -L | -DQT_EXTRA_LIBDIRS=; | |
| -F | -DQT_EXTRA_FRAMEWORKPATHS=; | |
| -sdk | | |
| -android-sdk path | | |
| -android-ndk path | | |
| -android-ndk-platform | | |
| -android-ndk-host | | |
| -android-abis | | |
| -android-style-assets | | |
| -skip | -DBUILD_=OFF | |
| -make | -DBUILD_TESTING=ON | A way to turn on tools explicitly is missing. |
| | -DBUILD_EXAMPLES=ON | |
| -nomake | -DBUILD_TESTING=OFF | A way to turn off tools explicitly is missing. |
| | -DBUILD_EXAMPLES=OFF | |
| -compile-examples | | |
| -gui | | |
| -widgets | | |
| -no-dbus | | |
| -dbus-linked | | |
| -dbus-runtime | | |
| -accessibility | | |
| -doubleconversion | | |
| -glib | | |
| -eventfd | | |
| -inotify | | |
| -icu | | |
| -pcre | | |
| -pps | | |
| -zlib | | |
| -ssl | | |
| -no-openssl | | |
| -openssl-linked | | |
| -openssl-runtime | | |
| -schannel | | |
| -securetransport | | |
| -sctp | | |
| -libproxy | | |
| -system-proxies | | |
| -cups | | |
| -fontconfig | | |
| -freetype | | |
| -harfbuzz | | |
| -gtk | | |
| -lgmon | | |
| -no-opengl | | |
| -opengl | | |
| -opengles3 | | |
| -egl | | |
| -qpa | | |
| -xcb-xlib | | |
| -direct2d | | |
| -directfb | | |
| -eglfs | | |
| -gbm | | |
| -kms | | |
| -linuxfb | | |
| -xcb | | |
| -libudev | | |
| -evdev | | |
| -imf | | |
| -libinput | | |
| -mtdev | | |
| -tslib | -DFEATURE_tslib=ON | |
| -bundled-xcb-xinput | | |
| -xkbcommon | | |
| -gif | | |
| -ico | | |
| -libpng | | |
| -libjpeg | | |
| -sql- | | |
| -sqlite | | |