AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7d35e31efb
qt5base-lts/cmake/configure-cmake-mapping.md

155 lines
24 KiB
Markdown
Raw Normal View History

CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
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 <dir> | -DINSTALL_BINDIR=<dir> | similar for -headerdir -libdir and so on |
| -host*dir <dir> | n/a | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -help | n/a | Handled by configure[.bat]. |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -verbose | | |
| -continue | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -redo | n/a | Handled by configure[.bat]. |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -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 | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -release | -DCMAKE_BUILD_TYPE=Release | |
| -debug | -DCMAKE_BUILD_TYPE=Debug | |
| -debug-and-release | -G "Ninja Multi-Config" | |
| | -DCMAKE_CONFIGURATION_TYPES=Release;Debug | |
CMake: Document more configure argument mappings Change-Id: Icda71c14cde638e874cc2e6406527b9c98535165 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-20 13:19:07 +00:00
| -optimize-debug | -DFEATURE_optimize_debug=ON | |
CMake: Implement configure -optimize-size This configure switch controls the feature 'optimize_size'. This isn't merely a mapping to CMAKE_BUILD_TYPE=MinSizeRel, because we potentially want to combine -optimize-size with -force-debug-info, which maps to CMAKE_BUILD_CONFIG=RelWithDebInfo. Task-number: QTBUG-85373 Change-Id: I1a9343ebc54816f52e90e9d33ea3df4c99b1ec9f Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-21 06:40:54 +00:00
| -optimize-size | -DFEATURE_optimize_size=ON | |
CMake: Document more configure argument mappings Change-Id: Icda71c14cde638e874cc2e6406527b9c98535165 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-20 13:19:07 +00:00
| -optimized-tools | n/a | This affects only host tools. |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -force-debug-info | Use the RelWithDebInfo build config. | |
| -separate-debug-info | -DFEATURE_separate_debug_info=ON | |
CMake: Implement configure -gdb-index Change-Id: Iea0fb99297751b1baf830a416ea5041d0b9a3b63 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-21 07:22:23 +00:00
| -gdb-index | -DFEATURE_enable_gdb_index=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -strip | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -gc-binaries | -DFEATURE_gc_binaries=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -force-asserts | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -developer-build | -DFEATURE_developer_build=ON | |
| -shared | -DBUILD_SHARED_LIBS=ON | |
| -static | -DBUILD_SHARED_LIBS=OFF | |
| -framework | -DFEATURE_framework=ON | |
| -platform <target> | -DQT_QMAKE_TARGET_MKSPEC=<mkspec> | |
| -xplatform <target> | -DQT_QMAKE_TARGET_MKSPEC=<mkspec> | Only used for generating qmake-compatibility files. |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -device <name> | equivalent to -xplatform devices/<name> | |
| -device-option <key=value> | -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 | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -qtnamespace <name> | -DQT_NAMESPACE=<name> | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -qtlibinfix <infix> | | |
| -testcocoon | | |
| -gcov | | |
| -trace [backend] | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -sanitize <arg> | -DFEATURE_sanitize_<arg> | |
| -coverage <arg> | | |
| -c++std c++2a | -DFEATURE_cxx2a=ON | |
| -sse2/sse3/-ssse3/-sse4.1 | | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -mips_dsp/-mips_dspr2 | | |
CMake: Implement configure -qreal <type> The configure argument -qreal <type> maps to the CMake argument -DQT_COORD_TYPE=<type>. Fixes: QTBUG-83325 Change-Id: I94970f31ccfb241b1dd4f1d9b6cef25d6684dc05 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-18 08:59:03 +00:00
| -qreal <type> | -DQT_COORD_TYPE=<type> | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -R <string> | -DQT_EXTRA_RPATHS=path1;path2 | |
| -rpath | negative CMAKE_SKIP_BUILD_RPATH | |
| | negative CMAKE_SKIP_INSTALL_RPATH | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -reduce-exports | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -reduce-relocations | -DFEATURE_reduce_relocations=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -plugin-manifests | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -static-runtime | -DFEATURE_static_runtime=ON | |
| -pch | -DBUILD_WITH_PCH=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -ltcg | | |
CMake: Implement configure -linker [bfd,gold,lld] Fixes: QTBUG-86155 Change-Id: I5ba2d3b52d9ca240b48904c492f7902a056c0292 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-20 07:06:16 +00:00
| -linker [bfd,gold,lld] | -DINPUT_linker=<name> or | |
| | -DFEATURE_use_<name>_linker=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -incredibuild-xge | | |
| -ccache | -DQT_USE_CCACHE=ON | |
| -make-tool <tool> | n/a | |
| -mp | n/a | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -warnings-are-errors | -DWARNINGS_ARE_ERRORS=ON or | |
| | -DFEATURE_warnings_are_errors=ON | |
| -silent | n/a | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -sysroot <dir> | -DCMAKE_SYSROOT=<dir> | Should be provided by a toolchain file that's |
| | | passed via -DCMAKE_TOOLCHAIN_FILE=<filename> |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -no-gcc-sysroot | | |
| -no-pkg-config | | |
CMake: Handle -D, -I, -F and -L configure arguments Introduce new CMake variables and map -D to QT_EXTRA_DEFINES, -I to QT_EXTRA_INCLUDEPATHS, -L to QT_EXTRA_LIBDIRS, and -F to QT_EXTRA_FRAMEWORKPATHS. Those variables only affect the Qt build, not user projects. Fixes: QTBUG-85878 Change-Id: I229df2eed1505a2619068d0d32975962b052569a Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-13 12:36:50 +00:00
| -D <string> | -DQT_EXTRA_DEFINES=<string1>;<string2> | |
| -I <string> | -DQT_EXTRA_INCLUDEPATHS=<string1>;<string2> | |
| -L <string> | -DQT_EXTRA_LIBDIRS=<string1>;<string2> | |
| -F <string> | -DQT_EXTRA_FRAMEWORKPATHS=<string1>;<string2> | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -sdk <sdk> | | |
| -android-sdk path | | |
| -android-ndk path | | |
| -android-ndk-platform | | |
| -android-ndk-host | | |
| -android-abis | | |
| -android-style-assets | | |
CMake: Extend configure-cmake-mapping.md Change-Id: Ie54b131c9a7b0f560fa735562fc4cbae4df35a49 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-02 09:25:28 +00:00
| -skip <repo> | -DBUILD_<repo>=OFF | |
| -make <part> | -DBUILD_TESTING=ON | A way to turn on tools explicitly is missing. |
| | -DBUILD_EXAMPLES=ON | |
| -nomake <part> | -DBUILD_TESTING=OFF | A way to turn off tools explicitly is missing. |
| | -DBUILD_EXAMPLES=OFF | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -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 <api> | | |
| -opengles3 | | |
| -egl | | |
| -qpa <name> | | |
| -xcb-xlib | | |
| -direct2d | | |
| -directfb | | |
| -eglfs | | |
| -gbm | | |
| -kms | | |
| -linuxfb | | |
| -xcb | | |
| -libudev | | |
| -evdev | | |
| -imf | | |
| -libinput | | |
| -mtdev | | |
CMake: Document more configure argument mappings Change-Id: Icda71c14cde638e874cc2e6406527b9c98535165 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-08-20 13:19:07 +00:00
| -tslib | -DFEATURE_tslib=ON | |
CMake: Document the mapping of configure options to CMake arguments Add internal documentation how to map configure options to CMake arguments. This patch adds a markdown file with a giant table, and cmake/README.md links to it. Change-Id: I94a6a4ee24ed0114ccb3095d2c13cf5d84e2de72 Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
2020-07-01 15:42:07 +00:00
| -bundled-xcb-xinput | | |
| -xkbcommon | | |
| -gif | | |
| -ico | | |
| -libpng | | |
| -libjpeg | | |
| -sql-<driver> | | |
| -sqlite | | |
Reference in New Issue Copy Permalink