Qt源码编译过程中配置文件中的选项说明

选项	说明	默认值
	顶级安装目录
-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