| 顶级安装目录 | |
-prefix
| 部署目录,如目标设备上所示。 | /usr/local/Qt-$QT_VERSION |
-extprefix
| 安装目录,如主机上所示。 | SYSROOT/PREFIX |
-hostprefix [dir] | 主机上运行的生成工具的安装目录。如果未给定[dir],则将使用当前构建目录 | EXTPREFIX |
-external-hostbindir
| 为此机器构建的Qt工具路径。当平台与当前系统不匹配时,使用此选项,即进行交叉构建 | |
| 微调安装目录布局。请注意,除-sysconfdir之外的所有目录都应位于-prefix/-hostprefix下 | |
-bindir
| 可执行安装目录 | PREFIX/bin |
-headerdir
| 头文件安装目录 | PREFIX/include |
-libdir
| 库文件安装目录 | PREFIX/lib |
-archdatadir
| 依赖于架构的数据安装目录 | PREFIX |
-plugindir
| 插件安装目录 | ARCHDATADIR/plugins |
-libexecdir
| 帮助程序安装目录 | ARCHDATADIR/bin on Windows, ARCHDATADIR/libexec otherwise |
-importdir
| QML1导入目录 | ARCHDATADIR/imports |
-qmldir
| QML2导入目录 | ARCHDATADIR/qml |
-datadir
| 不依赖于架构的独立数据安装目录 | PREFIX |
-docdir
| 文档安装目录 | DATADIR/doc |
-translationdir
| 翻译安装目录 | DATADIR/translations |
-sysconfdir
| Qt程序使用的设置安装目录 | PREFIX/etc/xdg |
-examplesdir
| 例程安装目录 | PREFIX/examples |
-testsdir
| 测试安装目录 | PREFIX/tests |
-hostbindir
| 主机可执行文件安装目录 | HOSTPREFIX/bin |
-hostlibdir
| 主机库安装目录 | HOSTPREFIX/lib |
-hostdatadir
| qmake使用的数据安装目录 | HOSTPREFIX |
| 配置元数据 | |
-help, -h | 显示帮助信息 | |
-verbose, -v | 在配置期间打印详细消息 | |
-continue | 尽管有错误,仍继续配置 | |
-redo | 使用以前使用的选项重新配置。其他选项可能会被传递,但不会被-redo保存以供以后使用。 | |
-recheck [test,…] | 放弃缓存的否定配置测试结果。在安装缺少的依赖项后使用此选项。或者,如果指定了测试,则只丢弃其结果。 | |
-recheck-all | 放弃所有缓存的配置测试结果。 | |
-feature- | 启用 | |
-no-feature- | 放弃启用 | |
-list-features | 列出可用功能。请注意,某些功能还具有专用的命令行选项。 | |
-list-libraries | 列出可能的外部依赖项。 | |
| 构建选项 | |
-opensource | 构建Qt的开源版本 | |
-commercial | 构建Qt商业版 | |
-confirm-license | 自动确认许可证 | |
-release | 关闭调试时生成Qt | yes |
-debug | 打开调试时生成Qt | no |
-debug-and-release | 构建Qt的两个版本,启用和不启用调试[yes](仅限苹果和Windows) | |
-optimize-debug | 在调试构建[auto]中启用调试友好优化(MSVC或Clang工具链不支持) | |
-optimize-size | 优化发布版本的大小而不是速度 | no |
-optimized-tools | 即使在调试构建中也可以构建优化的主机工具 | no |
-force-debug-info | 为发布版本创建符号文件 | no |
-separate-debug-info | 将调试信息拆分为单独的文件 | no |
-gdb-index | 索引调试信息以加快GDB | |
-strip | 去除不需要的符号的释放二进制文件 | yes |
-gc-binaries | 将每个函数或数据项放入其自己的节中,并启用未使用节的链接器垃圾收集。[自动生成静态生成,否则为否] | |
-force-asserts | 即使在发布版本中也启用Q_ASSERT | no |
-developer-build | 编译并链接Qt以开发Qt本身(用于自动测试、额外检查等的导出) | no |
-shared | 构建共享Qt库(UIKit为否) | yes |
-static | 构建静态Qt库(对于UIKit是) | no |
-framework | 构建Qt框架捆绑包(仅限Apple) | yes |
-platform | 选择主机mkspec | detected |
-xplatform | 交叉编译时选择目标mkspec | PLATFORM |
-device | 设备的交叉编译 | name |
-device-option <key=value> | 为设备mkspec添加选项 | |
-appstore-compliant | 禁用平台应用商店中不允许的代码。默认情况下,对于需要通过应用商店分发的平台,特别是Android、iOS、tvOS、watchOS和通用Windows平台,此选项处于启用状态 | auto |
-qtnamespace | 将所有Qt库代码包装在“namespace<name>{…}”中。 | |
-qtlibinfix | 将所有libQt5*.so重命名为libQt5*.so。 | no |
-qtlibinfix-plugins | 根据-qtlibinfix重命名Qt插件 | no |
-testcocoon | 使用TestCocoon代码覆盖工具的仪器 | no |
-gcov | 使用GCov代码覆盖工具的仪器 | no |
-trace [backend] | 启用带有跟踪点的检测。当前支持的后端是“etw”(Windows)和“lttng”(Linux),或“yes”用于自动检测。 | no |
-sanitize {address | thread | memory |
-coverage {trace-pc-guard} | 添加代码覆盖率检测 | |
-c++std | 选择C++标准[C++2a/C++17/C++14/C++11](MSVC 2015不支持) | |
-sse2 | 使用SSE2指令 | auto |
-sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512 | 启用特定x86指令[auto]启用的指令仍受运行时检测的影响。 | auto |
-mips_dsp/-mips_dspr2 | 使用MIPS DSP/rev2指令 | auto |
-qreal | typedef qreal到指定类型 | double |
-R | 向Qt库添加显式运行库路径。支持相对于LIBDIR的路径。 | |
-rpath | 使用库安装路径作为运行库路径链接Qt库和可执行文件。类似于-R LIBDIR。在Apple平台上,禁用这意味着对动态库和框架使用绝对安装名称(基于LIBDIR) | auto |
-reduce-exports | 减少导出符号的数量 | auto |
-reduce-relocations | 减少搬迁数量(Unix only) | auto |
-plugin-manifests | 将清单嵌入插件(Windows only) | no |
-static-runtime | 对于-static,使用静态运行时(Windows only) | no |
-pch | 使用预编译头 | auto |
-ltcg | 使用链接时间代码生成 | no |
-linker [bfd,gold,lld] | 强制使用GNUld、GNUgold或LLVM/LDD链接器,而不是默认链接器(仅限GCC) | |
-incredibuild-xge | 使用IncrediBuild XGE(仅限Windows) | no |
-ccache | 使用ccache编译器缓存(仅限Unix) | no |
-make-tool | 使用构建qmake(仅限Windows) | nomake |
-mp | 使用多个处理器进行编译(仅限MSVC) | |
-warnings-are-errors | 将警告视为错误 | no |
-silent | 减少生成输出,以便更容易看到警告和错误 | |
| 生成环境 | |
-sysroot
| 将
设置为目标sysroot
| |
-gcc-sysroot | 使用-sysroot,将–sysroot传递给编译器 | yes |
-pkg-config | 使用pkg配置(Unix only) | auto |
-D | 传递额外的预处理器定义 | |
-I | 传递附加包含路径 | |
-L | 传递附加库路径 | |
-F | 传递附加框架路径(仅限Apple) | |
-sdk | 使用苹果提供的SDK<SDK>构建Qt。参数应该是“xcodebuild-showsdks”列出的可用SDK之一。注意,该参数仅适用于使用目标mkspec构建的Qt库和应用程序,而不适用于qmake、moc、rcc等主机工具。 | |
-android-sdk path | 设置Android SDK根路径 | $ANDROID_SDK_ROOT |
-android-ndk path | 设置Android NDK根路径 | $ANDROID_NDK_ROOT |
-android-ndk-platform | 设置Android平台 | |
-android-ndk-host | 设置Android NDK主机(linux-x86、linux-x86_64等) | $ANDROID_NDK_HOST |
-android-abis | 逗号分隔的Android abis,默认为:armeabi-v7a、arm64-v8a、x86、x86_64 | |
-android-style-assets | 在运行时自动从设备中提取样式资源。此选项使Android风格正确运行,但也使Android平台插件与LGPL2.1不兼容 | yes |
| 组件选择 | |
-skip | 从生成中排除整个存储库 | |
-make | 将<part>添加到要构建的部件列表中。指定此选项将首先清除默认列表 | |
-nomake | 从要生成的零件列表中排除 | |
-compile-examples | 取消设置时,仅安装示例源 | yes |
-gui | 构建Qt GUI模块和依赖项 | yes |
-widgets | 构建Qt Widgets模块和依赖项 | yes |
-no-dbus | 不构建Qt D-Bus模块 | yes |
-dbus-linked | 构建Qt D-Bus并链接到libdbus-1 | auto |
-dbus-runtime | 构建Qt D-Bus并动态加载libdbus-1 | no |
-accessibility | 启用辅助功能支持注意:不建议禁用辅助功能。 | yes |
| 核心选项 | |
-doubleconversion | 选择使用的双转换库no表示使用sscanf_l和snprintf_l(不精确)。 | system/qt/no |
-glib | 启用Glib支持 | no |
-eventfd | 启用eventfd支持 | |
-inotify | 启用inotify支持 | |
-iconv | 启用图标(3)支持 | posix/sun/gnu/no |
-icu | 启用ICU支持 | auto |
-pcre | 选择使用的libpcre2 | system/qt/no |
-pps | 启用PPS支持 | auto |
-zlib | 选择使用的zlib | system/qt |
| 记录后端 | |
-journald | 启用日志支持 | no |
-syslog | 启用syslog支持 | no |
-slog2 | 启用slog2支持 | auto |
| 网络选项 | |
-ssl | 启用任一SSL支持方法 | auto |
-no-openssl | 不要使用OpenSSL | default on Apple and WinRT |
-openssl-linked | 使用OpenSSL并链接到libssl | no |
-openssl-runtime | 使用OpenSSL并动态加载libssl | auto |
-schannel | 使用安全通道 (Windows only) | no |
-securetransport | 使用SecureTransport (Apple only) | auto |
-sctp | 启用SCTP支持 | no |
-libproxy | 启用libproxy的使用 | no |
-system-proxies | 默认情况下使用系统网络代理 | yes |
| Gui、打印、小部件选项 | |
-cups | 启用CUPS支持(Unix only) | auto |
-fontconfig | 启用Fontconfig支持(Unix only) | auto |
-freetype | 选择使用的FreeType | system/qt/no |
-harfbuzz | 选择使用的HarfBuzz NG | system/qt/no |
-gtk | 启用GTK平台主题支持 | auto |
-lgmon | 启用lgmon支持(QNX only) | auto |
-no-opengl | 禁用OpenGL支持 | |
-opengl | 启用OpenGL支持。支持的API:es2(Windows默认)、桌面(Unix默认)、动态(仅Windows) | |
-opengles3 | 启用OpenGL ES 3.x支持,而不是ES 2.x | auto |
-egl | 启用EGL支持 | auto |
-angle | 使用捆绑的ANGLE支持OpenGL ES 2.0(Windows only) | auto |
-combined-angle-lib | 将LibEGL和LibGLESv2合并到LibANGLE中(Windows only) | |
-qpa | 选择默认QPA后端(例如,xcb、cocoa、windows)一个由分号分隔的优先级列表。 | |
-xcb-xlib | Enable Xcb-Xlib support | auto |
| 平台后端 | |
-direct2d | 启用Direct2D支持 (Windows only) | auto |
-directfb | 启用DirectFB支持 (Unix only) | no |
-eglfs | 启用EGLFS支持 | auto; no on Android and Windows |
-gbm | 为GBM启用后端 (Linux only) | auto |
-kms | 为KMS启用后端 (Linux only) | auto |
-linuxfb | 启用Linux Framebuffer支持 (Linux only) | auto |
-xcb | 启用X11支持。选择使用的xcb-*库 | system/qt/no |
| 输入后端 | |
-libudev. | 启用udev支持 | auto |
-evdev | 启用evdev支持 | auto |
-imf | 启用IMF支持 (QNX only) | auto |
-libinput | 启用libinput支持 | auto |
-mtdev | 启用mtdev支持 | auto |
-tslib | 启用tslib支持 | auto |
-xcb-xinput | 启用XInput2支持 | auto |
-xkbcommon | 启用密钥映射支持 | auto |
| 图像格式 | |
-gif | 启用GIF阅读支持 | auto |
-ico | 启用对ICO的支持 | auto |
-libpng | 选择使用的libpng | auto |
-libjpeg | 选择使用的libjpeg | auto |
-jasper | 使用JasPer库启用JPEG-2000支持 | no |
-mng | 启用MNG支持 | no |
-tiff | 启用TIFF支持 | system/qt/no |
-webp | 启用WEBP支持 | system/qt/no |
| 数据库选项 | |
-sql- | 启用SQL<driver>插件。支持的驱动程序:db2 ibase mysql oci odbc psql sqlite2 sqlite tds | auto |
-sqlite | 选择使用的sqlite3 | system/qt |
| Qt3D选项 | |
-assimp | 选择使用的assimp库 | system/qt/no |
-qt3d-profile-jobs | 启用作业分析 | no |
-qt3d-profile-gl | 启用OpenGL评测 | no |
-qt3d-simd | 选择SIMD支持级别 | no/sse2/avx2 |
-qt3d-render | 启用Qt3D渲染工具 | yes |
-qt3d-input | 启用Qt3D输入功能 | yes |
-qt3d-logic | 启用Qt3D逻辑功能 | yes |
-qt3d-extras | 启用Qt3D Extras功能 | yes |
-qt3d-animation | 启用Qt3D动画功能 | yes |
| 多媒体选项 | |
-pulseaudio | 启用PulseAudio支持 (Unix only) | auto |
-alsa | 启用ALSA支持 (Unix only) | auto |
-no-gstreamer | 禁用对GStreamer的支持 | |
-gstreamer [version] | 启用GStreamer支持, 如果没有参数,首先尝试1.0,然后尝试0.10。 | auto |
-evr | 在DirectShow和WMF中启用EVR | system/qt/no |
| QtQuick3D选项 | |
-assimp | 选择使用的assimp库 | system/qt/no |
| 文本到语音选项 | |
-flite | 启用Flite支持 (Unix only) | auto |
-flite-alsa | 使用ALSA支持启用Flite (Unix only) | auto |
-speechd | 启用语音调度程序支持 (Unix only) | auto |
| WebEngine选项 | |
-webengine-alsa | 启用ALSA支持 (Linux only) | auto |
-webengine-pulseaudio | 启用PulseAudio支持 (Linux only) | auto |
-webengine-embedded-build | 启用Linux嵌入式构建 (Linux only) | auto |
-webengine-icu | 使用系统ICU库 (Linux only) | system/qt |
-webengine-ffmpeg | 使用系统FFmpeg库 (Linux only) | system/qt |
-webengine-opus | 使用系统Opus库 (Linux only) | system/qt |
-webengine-webp | 使用系统WebP库 (Linux only) | system/qt |
-webengine-pepper-plugins | 启用Pepper Flash和Widevine插件 | auto |
-webengine-printing-and-pdf | 启用打印并输出为PDF | auto |
-webengine-proprietary-codecs | 启用对专有编解码器的支持 | no |
-webengine-spellchecker | 启用拼写检查器支持 | yes |
-webengine-native-spellchecker | 启用对本机拼写检查器的支持 (macOS only) | no |
-webengine-webrtc | 启用对WebRTC的支持 | auto |