summaryrefslogtreecommitdiffstats
path: root/cmake/configure-cmake-mapping.md
blob: 49af2e6433626966940361b7bda0d46c03871579 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
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                                               |                                                                 |
| -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                       |                                                   |                                                                 |
| -optimize-size                        |                                                   |                                                                 |
| -optimized-tools                      |                                                   |                                                                 |
| -force-debug-info                     | Use the RelWithDebInfo build config.              |                                                                 |
| -separate-debug-info                  | -DFEATURE_separate_debug_info=ON                  |                                                                 |
| -gdb-index                            |                                                   |                                                                 |
| -strip                                |                                                   |                                                                 |
| -gc-binaries                          | -DFEATURE_gc_binaries=ON                          |                                                                 |
| -force-asserts                        |                                                   |                                                                 |
| -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.             |
| -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                   |                                                   |                                                                 |
| -qtnamespace <name>                   | -DQT_NAMESPACE=<name>                             |                                                                 |
| -qtlibinfix <infix>                   |                                                   |                                                                 |
| -testcocoon                           |                                                   |                                                                 |
| -gcov                                 |                                                   |                                                                 |
| -trace [backend]                      |                                                   |                                                                 |
| -sanitize <arg>                       | -DFEATURE_sanitize_<arg>                          |                                                                 |
| -coverage <arg>                       |                                                   |                                                                 |
| -c++std c++2a                         | -DFEATURE_cxx2a=ON                                |                                                                 |
| -sse2/sse3/-ssse3/-sse4.1             |                                                   |                                                                 |
| -mips_dsp/-mips_dspr2                 |                                                   |                                                                 |
| -qreal <type>                         |                                                   |                                                                 |
| -R <string>                           | -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]                |                                                   |                                                                 |
| -incredibuild-xge                     |                                                   |                                                                 |
| -ccache                               | -DQT_USE_CCACHE=ON                                |                                                                 |
| -make-tool <tool>                     | n/a                                               |                                                                 |
| -mp                                   | n/a                                               |                                                                 |
| -warnings-are-errors                  | -DWARNINGS_ARE_ERRORS=ON or                       |                                                                 |
|                                       | -DFEATURE_warnings_are_errors=ON                  |                                                                 |
| -silent                               | n/a                                               |                                                                 |
| -sysroot <dir>                        | -DCMAKE_SYSROOT=<dir>                             | Should be provided by a toolchain file that's                   |
|                                       |                                                   | passed via -DCMAKE_TOOLCHAIN_FILE=<filename>                    |
| -no-gcc-sysroot                       |                                                   |                                                                 |
| -no-pkg-config                        |                                                   |                                                                 |
| -D <string>                           |                                                   |                                                                 |
| -I <string>                           |                                                   |                                                                 |
| -L <string>                           |                                                   |                                                                 |
| -F <string>                           |                                                   |                                                                 |
| -sdk <sdk>                            |                                                   |                                                                 |
| -android-sdk path                     |                                                   |                                                                 |
| -android-ndk path                     |                                                   |                                                                 |
| -android-ndk-platform                 |                                                   |                                                                 |
| -android-ndk-host                     |                                                   |                                                                 |
| -android-abis                         |                                                   |                                                                 |
| -android-style-assets                 |                                                   |                                                                 |
| -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                              |                                                                 |
| -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                                |                                                   |                                                                 |
| -tslib                                |                                                   |                                                                 |
| -bundled-xcb-xinput                   |                                                   |                                                                 |
| -xkbcommon                            |                                                   |                                                                 |
| -gif                                  |                                                   |                                                                 |
| -ico                                  |                                                   |                                                                 |
| -libpng                               |                                                   |                                                                 |
| -libjpeg                              |                                                   |                                                                 |
| -sql-<driver>                         |                                                   |                                                                 |
| -sqlite                               |                                                   |                                                                 |