qt5的configure选项说明

关注

转载 2022-03-15 10:34:15 3.8k 阅读 AI 写同款· GEO 优化 ›

用mingw静态编译Qt4.8.2和Qt5.1.1 因为一些乱七八糟的原因，我需要用mingw静态编译Qt4.8.2和Qt5.1.1。经历了一天的折腾之后，自觉编译一下Qt还是件颇为麻烦的事情，故将过程略作总结，以备不时之需。首先，在编译之前，我需要下载mingw、qt-everywhere-opensource-src-4.8.2和qt-everywhere-opensource-src-5.1.1。然后，准备开始编译了，当然阅读详情

一、配置选项查看及初步解释

通过下面命令查看都有哪一些编译配置选项。

./configure -help

 
 1

有一些选项的后面有中括号[]括起来的值，有以下三种情况，分别举例。

yes，表示该选项默认选中。
no，表示该选项默认不选中。
auto，应当是系统会自动检测是否添加该选项吧。
- 那可以通过 --xxx=no或者-xxx=yes来进行手动配置。例如：-qt-freetype <=> --freetype=qt；-no-openssl <=> --openssl=no

变量配置方法： -VAR=VALUE的形式。

1、安装选项

-prefix： 指定部署目录，默认路径为 /usr/local/Qt-$QT_VERSION 。
-extprefix： 指定安装目录，如主机上所示，[SYSROOT/PREFIX]。
-hostprefix： 指定运行在本主机上的构建工具的安装目录，如果不指定则使用当前目录。
-external-hostbindir： 指定为这台机器构建的Qt工具路径，当-platform和当前系统不匹配时使用，例如：创建交叉编译。

可以使用下面选项来对安装目录进行微调，请注意，所有目录除-sysconfdir外，其他的应位于-prefix和-hostprefix下。

-bindir： 可执行文件安装目录，[PREFIX/bin]。
-headerdir： 头文件安装目录，[PREFIX/include]。
-libdir： 库文件安装目录，[PREFIX/lib]。
-archdatadir： Arch-dependent 数据安装目录，[PREFIX]。
-plugindir： 插件安装目录，[ARCHDATADIR/plugins]。
-libexecdir： 辅助程序安装目录，[ARCHDATADIR/bin on Windows, ARCHDATADIR/libexec otherwise]
-importdir： QML1 导入安装目录，[ARCHDATADIR/imports]。
-qmldir： QML2 导入安装目录，[ARCHDATADIR/qml]。
-datadir： Arch-independent 数据安装目录，[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]。

2、配置选项

-help： -h 显示帮助信息。
-verbose： -v 配置过程中打印每个步骤的的详细信息。
-continue： 如果发生错误，尽管继续。
-redo： 重新配置以前使用的选项，可能会传递其他额外的选项，但不会保存供稍后的-redo选项使用。
-recheck [test,…]： 丢弃缓存的无用的配置测试结果，在安装完丢失的依赖项后使用该选项，或者，如果指定了 tests，只有它们的结果会被丢弃。
-recheck-all： 丢弃所有缓存的配置测试结果。
-feature-<feature>： 启用<feature>。
-no-feature-<feature>： 禁止<feature>，[none]。
-list-features： 列出可用的特性，请注意，一些特性还有专用的命令行选项。
-list-libraries： 列出可能的外部依赖项。

3、编译选项

-opensource： 编译Qt的开源版本。
-commercial： 编译Qt的商业版。
-confirm-license： 自动确认许可。
-release： 编译Qt的release版本，关闭调试，[yes]。
-debug： 编译Qt的debug版本，开启调试，[no]。
-debug-and-release： 编译Qt的release和debug两个版本，[yes] (Apple and Windows only)。
-optimize-debug： 在调试构建中启用调试友好的优化，[auto] (Not supported with MSVC or Clang toolchains)。
-optimize-size： 优化发布版本的大小而不是速度，[no]。
-optimized-tools： 构建优化的主机工具，即使在调试构建，[no]。
-force-debug-info： 强制为release构建输出调试信息，[no]。
-separate-debug-info： 将调试信息到一个单独的文件，[no]。
-gdb-index： 将调试信息索引到加速 GDB， [no; auto if -developer-build with debug info]。
-strip： 使用 strip 去除不需要符号的二进制文件，[yes]。
-gc-binaries： 将每个函数或数据项放入各自的分区中，启用未使用分区的链接器垃圾回收，[auto for static builds, otherwise no]。
-force-asserts： 启用 Q_ASSERT 即使在 release 版本中，[no]。
-developer-build： 编译和链接 Qt 用以开发 Qt 本身，(exports for auto-tests, extra checks, etc.) [no]。
*-shared： 构建 Qt 共享库，[yes] (no for UIKit)。
-static： 构建 QT 静态库，[no] (yes for UIKit)。
-framework： 构建 Qt 框架包，[yes] (Apple only)。
-platform <target>： 选择要构建的主机 mkspec，[detected]。
-xplatform <target>： 选择交叉编译时的目标 mkspec，[PLATFORM]
-device <name>： 交叉编译<name>设备。
-device-option <key=value>： 添加选项到设备的 mkspec。
-appstore-compliant： 禁用平台应用程序商店中不允许的代码，对于需要通过 app store 进行分发的平台，这是默认打开的，特别是： Android, iOS, tvOS, watchOS, and Universal Windows Platform，[auto]。
-qtnamespace <name>： 把所有的 Qt 库代码放入namespace{…}中。
-qtlibinfix <infix>： 重命名所有libQt*.so为libQt*<infix>.so。
-qtlibinfix-plugins： 通过-qtlibinfix重命名 Qt 插件，[no]。
-testcocoon： Instrument with the TestCocoon code coverage tool，[no]。
-gcov： Instrument with the GCov code coverage tool，[no]。
-trace [backend]： Enable instrumentation with tracepoints，目前支持的后端有： ‘etw’ (Windows) and ‘lttng’ (Linux), or ‘yes’ for auto-detection，[no]。
-sanitize [address/thread/memory/undefined]： Instrument with the specified compiler sanitizer，请注意，一些 sanitizers 是不能混合使用，例如： -sanitize address不能和-sanitize thread一起使用。
-coverage {trace-pc-guard}： 添加代码覆盖工具， (Clang only)。
-c++std <edition>： 选择 C++ 标准<edition>，[c++2a/c++17/c++14/c++11] (Not supported with MSVC 2015)。
-sse2： 使用 SSE2 指令，[auto]。
-sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512： 启用对特定 x86 指令的使用，启用的仍然会受到运行时检测的影响，[auto]。
-mips_dsp/-mips_dspr2： 使用 MIPS DSP/rev2 指令，[auto]。
-qreal <type>： 将 qreal 类型定义为指定的类型，请注意，这会影响二进制兼容性，[double]。
-R <string>： 向 Qt 库添加显式运行时库路径，支持相对于 LIBDIR 的路径。
-rpath： 链接 Qt 库和可执行文件使用库安装路径作为运行时库路径，相当于-R LIBDIR。在Apple平台上，禁用它意味着对动态库和框架使用绝对安装名称(基于LIBDIR)，[auto]。
-reduce-exports： 减少输出符号的数量，[auto]。
-reduce-relocations： Reduce amount of relocations，[auto] (Unix only)。
-relocatable： 允许重新安装Qt，[auto]。
-plugin-manifests： Embed manifests into plugins，[no] (Windows only)。
-static-runtime： With -static, use static runtime，[no] (Windows only)。
-pch： 使用预编译头文件，[auto]。
-ltcg： 使用链接时代码生成，[no]。
-linker [bfd,gold,lld]： 强制使用 GNU ld，GNU gold or LLVM/LLD 链接器而不是默认值，(GCC only)。
-incredibuild-xge： 使用 IncrediBuild XGE，[no] (Windows only)。
-ccache： 使用 ccache 编译器缓存，[no] (Unix only)。
-make-tool <tool>： 使用<tool>来构建 qmake，[nmake] (Windows only)。
-mp： 使用多个处理器进行编译，(MSVC only)。
-warnings-are-errors： 将警告视为错误，[no; yes if -developer-build]。
-silent： 减少编译输出，以便更容易地看到警告和错误。

4、编译环境

-sysroot <dir>： 将 <dir> 设置为目标 sysroot。
-gcc-sysroot： 使用 -sysroot，将 --sysroot 传给编译器，[yes]。
-pkg-config： 使用 pkg-config，[auto] (Unix only)。
-D <string>： 传递额外的预处理定义。
-I <string>： 传递额外的包含路径。
-L <string>： 传递额外的库路径。
-F <string>： 传递额外的框架路径， (Apple only)。
-sdk <sdk>： 使用 Apple 提供的 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, etc.) [$ANDROID_NDK_HOST]。
-android-abis： 逗号分隔 Android abis，默认有： armeabi-v7a,arm64-v8a,x86,x86_64。
-android-style-assets： 运行时自动从设备提取 style assets，这个选项可以确保正确的 Android style，但也会使得 Android 平台插件与 LGPL2.1 不兼容，[yes]。

5、组件选择

-skip <repo>： 从构建中排除整个存储库。
-make <part>： 在 make 时添加要构建的<part>组件，[libs and examples, also tools if not cross-building, also tests if -developer-build]。
-nomake <part>： 在 make 时排除不构建的<part>组件。
-compile-examples： 构建和安装 examples 源码，[no on WebAssembly，otherwise yes]。
-gui： 构建 Qt GUI 模块和依赖项，[yes]。
-widgets： 构建 Qt Widgets 模块和依赖项，[yes]。
-no-dbus： 不编译 Qt D-Bus 模块，[default on Android and Windows]。
-dbus-linked： 构建 Qt D-Bus 模块并链接到 libdbus-1，[auto]。
-dbus-runtime： 构建 Qt D-Bus 模块并动态加载 libdbus-1，[no]。
-accessibility： 启用可访问性支持（注意：不建议禁用可访问性），[yes]。

Qt 附带了一些第三方库的捆绑拷贝，如果各自系统库的自动检测失败，下面这些会被默认使用。

6、核心选项

-doubleconversion： 选择使用双转换库，no 意味着使用 sscanf_l 和 snprintf_l（不精确），[system/qt/no]。
-glib： 启用对 Glib 支持，[no; auto on Unix]。
-eventfd： 启用对 eventfd 的支持。
-inotify： 启用对 inotify 的支持。
-iconv： 启用对 iconv(3) 的支持，[posix/sun/gnu/no] (Unix only)。
-icu： 启用对 ICU 库的支持，这是 IBM 发布的字符集编码转换库，[auto]。
-pcre： 选择使用 libpcre2，[system/qt/no]。
-pps： 启用对 PPS 的支持，[auto] (QNX only)。
-zlib： 选择使用 zlib，[system/qt]。

后端日志：

-journald： 启用对 journald 的支持，[no] (Unix only)。
-syslog： 启用对 syslog 的支持，[no] (Unix only)。
-slog2： 启用对 slog2 的支持，[auto] (QNX only)。

7、网络选项

-ssl： 启用对任何一种SSL方法的支持，[auto]。
-no-openssl： 不适用 OpenSSL，[default on Apple and WinRT]。
-openssl-linked： 使用 OpenSSL 并链接到 libssl，[no]。
-openssl-runtime： 使用 OpenSSL 并动态加载 libssl，[auto]。
-schannel： 使用安全通道，[no] (Windows only)。
-securetransport： 使用安全传输，[auto] (Apple only)。
-sctp： 启用对 SCTP 的支持，[no]。
-libproxy： 启用对 libproxy 的使用，[no]。
-system-proxies： 默认使用系统网络代理，[yes]。

8、Gui, printing, widget选项

-cups： 启用对 CUPS 的支持，[auto] (Unix only)。
-fontconfig： 启用对 Fontconfig 的支持，[auto] (Unix only)。
-freetype： 选择使用 FreeType，[system/qt/no]。
-harfbuzz： 选择使用 HarfBuzz-NG，[system/qt/no] (Not auto-detected on Apple and Windows)。
-gtk： 启用对 GTK 平台主题的支持，[auto]。
-lgmon： 启用对 lgmon 的支持，[auto] (QNX only)。
-no-opengl： 禁止对 OpenGL 的支持。
-opengl <api>： 启用对 OpenGL 的支持，支持的 APIs： es2 (default on Windows)，desktop (default on Unix)，dynamic (Windows only)。
-opengles3： 启用对 OpenGL ES 3.x 替换 ES 2.x 的支持，[auto]。
-egl： 启用对 EGL 的支持，[auto]。
-angle： 使用绑定的 ANGLE 来支持 OpenGL ES 2.0，[auto] (Windows only)。
-combined-angle-lib： 将 LibEGL 和 LibGLESv2 合并到 LibANGLE 中，(Windows only)。
-qpa <name>： 选择默认的 QPA 后端，用分号分隔的优先级列表，(e.g., xcb, cocoa, windows)。
-xcb-xlib： 启用对 Xcb-Xlib 的支持，[auto]。
Platform backends：
-direct2d： 启用对 Direct2D 的支持，[auto] (Windows only)。
-directfb： 启用对 DirectFB 的支持，[no] (Unix only)。
-eglfs： 启用对 EGLFS 的支持，[auto; no on Android and Windows]。
-gbm： 为 GBM 启用后端，[auto] (Linux only)。
-kms： 为 KMS 启用后端，[auto] (Linux only)。
-linuxfb： 启用 Linux Framebuffer 的支持，[auto] (Linux only)。
-xcb： 启用 X11 的支持，选择使用 xcb-* 库，[system/qt/no] (-qt-xcb still uses system version of libxcb itself)。