refactor the configure help output
- remove the redundantly listed -no-* options and indicate the defaults differently - completely regroup the options into somewhat logical sections Change-Id: Iaa87c2f3749944cd3fc2ec18975767c04892f746 Reviewed-by: Lars Knoll <lars.knoll@qt.io>
This commit is contained in:
parent
c41dd40bff
commit
30cac3ed2d
692
config_help.txt
692
config_help.txt
@ -1,431 +1,265 @@
|
||||
Usage: configure [options]
|
||||
|
||||
Installation options:
|
||||
|
||||
These are optional, but you may specify install directories.
|
||||
|
||||
-prefix <dir> ...... The deployment directory, as seen on the target device.
|
||||
(default /usr/local/Qt-$QT_VERSION, $PWD if -developer-build is active)
|
||||
|
||||
-extprefix <dir> ... The installation directory, as seen on the host machine.
|
||||
(default SYSROOT/PREFIX)
|
||||
|
||||
-hostprefix [dir] .. The installation directory for build tools running on the
|
||||
host machine. If [dir] is not given, the current build
|
||||
directory will be used. (default EXTPREFIX)
|
||||
|
||||
You may use these to change the layout of the install. Note that all directories
|
||||
except -sysconfdir should be located under -prefix/-hostprefix:
|
||||
|
||||
-bindir <dir> ......... User executables will be installed to <dir>
|
||||
(default PREFIX/bin)
|
||||
-headerdir <dir> ...... Headers will be installed to <dir>
|
||||
(default PREFIX/include)
|
||||
-libdir <dir> ......... Libraries will be installed to <dir>
|
||||
(default PREFIX/lib)
|
||||
-archdatadir <dir> .... Arch-dependent data used by Qt will be installed to <dir>
|
||||
(default PREFIX)
|
||||
-plugindir <dir> ...... Plugins will be installed to <dir>
|
||||
(default ARCHDATADIR/plugins)
|
||||
-libexecdir <dir> ..... Program executables will be installed to <dir>
|
||||
(default ARCHDATADIR/libexec, ARCHDATADIR/bin for MinGW)
|
||||
-importdir <dir> ...... Imports for QML1 will be installed to <dir>
|
||||
(default ARCHDATADIR/imports)
|
||||
-qmldir <dir> ......... Imports for QML2 will be installed to <dir>
|
||||
(default ARCHDATADIR/qml)
|
||||
-datadir <dir> ........ Arch-independent data used by Qt will be installed to <dir>
|
||||
(default PREFIX)
|
||||
-docdir <dir> ......... Documentation will be installed to <dir>
|
||||
(default DATADIR/doc)
|
||||
-translationdir <dir> . Translations of Qt programs will be installed to <dir>
|
||||
(default DATADIR/translations)
|
||||
-sysconfdir <dir> ..... Settings used by Qt programs will be looked for in <dir>
|
||||
(default PREFIX/etc/xdg)
|
||||
-examplesdir <dir> .... Examples will be installed to <dir>
|
||||
(default PREFIX/examples)
|
||||
-testsdir <dir> ....... Tests will be installed to <dir>
|
||||
(default PREFIX/tests)
|
||||
|
||||
-hostbindir <dir> ..... Host executables will be installed to <dir>
|
||||
(default HOSTPREFIX/bin)
|
||||
-hostlibdir <dir> ..... Host libraries will be installed to <dir>
|
||||
(default HOSTPREFIX/lib)
|
||||
-hostdatadir <dir> .... Data used by qmake will be installed to <dir>
|
||||
(default HOSTPREFIX)
|
||||
|
||||
Configure options:
|
||||
|
||||
The defaults (*) are usually acceptable. A plus (+) denotes a default value
|
||||
that needs to be evaluated. If the evaluation succeeds, the feature is
|
||||
included. Here is a short explanation of each option:
|
||||
|
||||
* -release ............. Compile and link Qt with debugging turned off.
|
||||
-debug ............... Compile and link Qt with debugging turned on.
|
||||
-debug-and-release ... Compile and link two versions of Qt, with and without
|
||||
debugging turned on (Apple platforms only).
|
||||
|
||||
-force-debug-info .... Create symbol files for release builds.
|
||||
|
||||
-developer-build ..... Compile and link Qt with Qt developer options (including auto-tests exporting)
|
||||
|
||||
* -no-optimized-tools .. Do not build optimized host tools even in debug build.
|
||||
-optimized-tools ..... Build optimized host tools even in debug build.
|
||||
|
||||
-opensource .......... Compile and link the Open-Source Edition of Qt.
|
||||
-commercial .......... Compile and link the Commercial Edition of Qt.
|
||||
|
||||
-confirm-license ..... Automatically acknowledge the license (use with
|
||||
either -opensource or -commercial)
|
||||
|
||||
-c++std <edition> .... Compile Qt with C++ standard edition (c++11, c++14, c++1z)
|
||||
Default: highest supported
|
||||
|
||||
* -shared .............. Create and use shared Qt libraries.
|
||||
-static .............. Create and use static Qt libraries.
|
||||
|
||||
-no-accessibility .... Do not compile Accessibility support.
|
||||
Disabling accessibility is not recommended, as it will break QStyle
|
||||
and may break other internal parts of Qt.
|
||||
With this switch you create a source incompatible version of Qt,
|
||||
which is unsupported.
|
||||
+ -accessibility ....... Compile Accessibility support.
|
||||
|
||||
-no-sql-<driver> ..... Disable SQL <driver>.
|
||||
-sql-<driver> Enable SQL <driver> plugin.
|
||||
|
||||
Possible values for <driver>:
|
||||
[db2, ibase, mysql, oci, odbc, psql, sqlite, sqlite2, tds]
|
||||
|
||||
-system-sqlite ....... Use sqlite from the operating system.
|
||||
|
||||
-no-qml-debug ........ Do not build the in-process QML debugging support.
|
||||
+ -qml-debug ........... Build the QML debugging support.
|
||||
|
||||
-platform target ..... The operating system and compiler you are building
|
||||
on (default detected from host system).
|
||||
|
||||
See the README file for a list of supported
|
||||
operating systems and compilers.
|
||||
|
||||
-no-sse2 ............. Do not compile with use of SSE2 instructions.
|
||||
-no-sse3 ............. Do not compile with use of SSE3 instructions.
|
||||
-no-ssse3 ............ Do not compile with use of SSSE3 instructions.
|
||||
-no-sse4.1 ........... Do not compile with use of SSE4.1 instructions.
|
||||
-no-sse4.2 ........... Do not compile with use of SSE4.2 instructions.
|
||||
-no-avx .............. Do not compile with use of AVX instructions.
|
||||
-no-avx2 ............. Do not compile with use of AVX2 instructions.
|
||||
-no-avx512 ........... Do not compile with use of AVX512 instructions.
|
||||
-no-mips_dsp ......... Do not compile with use of MIPS DSP instructions.
|
||||
-no-mips_dspr2 ....... Do not compile with use of MIPS DSP rev2 instructions.
|
||||
|
||||
-qtnamespace <name> .. Wraps all Qt library code in 'namespace <name> {...}'.
|
||||
-qtlibinfix <infix> .. Renames all libQt*.so to libQt*<infix>.so.
|
||||
|
||||
-testcocoon .......... Instrument Qt with the TestCocoon code coverage tool.
|
||||
-gcov ................ Instrument Qt with the GCov code coverage tool.
|
||||
|
||||
-D <string> .......... Add an explicit define to the preprocessor.
|
||||
-I <string> .......... Add an explicit include path.
|
||||
-L <string> .......... Add an explicit library path.
|
||||
|
||||
+ -pkg-config .......... Use pkg-config to detect include and library paths. By default,
|
||||
configure determines whether to use pkg-config or not with
|
||||
some heuristics such as checking the environment variables.
|
||||
-no-pkg-config ....... Disable use of pkg-config.
|
||||
-force-pkg-config .... Force usage of pkg-config (skips pkg-config usability
|
||||
detection heuristic).
|
||||
|
||||
-help, -h ............ Display this information.
|
||||
|
||||
Third Party Libraries:
|
||||
|
||||
-qt-zlib ............. Use the zlib bundled with Qt.
|
||||
+ -system-zlib ......... Use zlib from the operating system.
|
||||
See http://www.gzip.org/zlib
|
||||
|
||||
-no-mtdev ............ Do not compile mtdev support.
|
||||
+ -mtdev ............... Enable mtdev support.
|
||||
|
||||
+ -no-journald ......... Do not send logging output to journald.
|
||||
-journald ............ Send logging output to journald.
|
||||
|
||||
+ -no-syslog ........... Do not send logging output to syslog.
|
||||
-syslog .............. Send logging output to syslog.
|
||||
|
||||
-no-gif .............. Do not compile GIF reading support.
|
||||
|
||||
-no-libpng ........... Do not compile PNG support.
|
||||
-qt-libpng ........... Use the libpng bundled with Qt.
|
||||
+ -system-libpng ....... Use libpng from the operating system.
|
||||
See http://www.libpng.org/pub/png
|
||||
|
||||
-no-libjpeg .......... Do not compile JPEG support.
|
||||
-qt-libjpeg .......... Use the libjpeg bundled with Qt.
|
||||
+ -system-libjpeg ...... Use libjpeg from the operating system.
|
||||
See http://www.ijg.org
|
||||
|
||||
-no-doubleconversion ..... Use sscanf_l and snprintf_l for (imprecise) double conversion.
|
||||
-qt-doubleconversion ..... Use the libdouble-conversion bundled with Qt.
|
||||
+ -system-doubleconversion . Use the libdouble-conversion provided by the system.
|
||||
See https://github.com/google/double-conversion
|
||||
|
||||
-no-freetype ......... Do not compile in Freetype2 support.
|
||||
-qt-freetype ......... Use the libfreetype bundled with Qt.
|
||||
+ -system-freetype...... Use the libfreetype provided by the system (enabled if -fontconfig is active).
|
||||
See http://www.freetype.org
|
||||
|
||||
-no-harfbuzz ......... Do not compile HarfBuzz-NG support.
|
||||
-qt-harfbuzz ......... Use HarfBuzz-NG bundled with Qt to do text shaping.
|
||||
It can still be disabled by setting
|
||||
the QT_HARFBUZZ environment variable to "old".
|
||||
+ -system-harfbuzz ..... Use HarfBuzz-NG from the operating system
|
||||
to do text shaping. It can still be disabled
|
||||
by setting the QT_HARFBUZZ environment variable to "old".
|
||||
See http://www.harfbuzz.org
|
||||
|
||||
-no-openssl .......... Do not compile support for OpenSSL.
|
||||
+ -openssl ............. Enable run-time OpenSSL support.
|
||||
-openssl-linked ...... Enabled linked OpenSSL support.
|
||||
|
||||
* -no-libproxy ......... Do not compile support for libproxy
|
||||
-libproxy ............ Use libproxy from the operating system.
|
||||
|
||||
-qt-pcre ............. Use the PCRE library bundled with Qt.
|
||||
+ -system-pcre ......... Use the PCRE library from the operating system.
|
||||
|
||||
-qt-xcb .............. Use xcb- libraries bundled with Qt.
|
||||
(libxcb.so will still be used from operating system).
|
||||
+ -system-xcb .......... Use xcb- libraries from the operating system.
|
||||
|
||||
-xkb-config-root ..... Set default XKB config root. This option is used only together with -qt-xkbcommon-x11.
|
||||
-qt-xkbcommon-x11 .... Use the xkbcommon library bundled with Qt in combination with xcb.
|
||||
+ -system-xkbcommon-x11 Use the xkbcommon library from the operating system in combination with xcb.
|
||||
|
||||
-no-xkbcommon-evdev .. Do not use X-less xkbcommon when compiling libinput support.
|
||||
* -xkbcommon-evdev ..... Use X-less xkbcommon when compiling libinput support.
|
||||
|
||||
-no-xinput2 .......... Do not compile XInput2 support.
|
||||
* -xinput2 ............. Compile XInput2 support.
|
||||
|
||||
-no-xcb-xlib.......... Do not compile Xcb-Xlib support.
|
||||
* -xcb-xlib............. Compile Xcb-Xlib support.
|
||||
|
||||
-no-glib ............. Do not compile Glib support.
|
||||
+ -glib ................ Compile Glib support.
|
||||
|
||||
-no-pulseaudio ....... Do not compile PulseAudio support.
|
||||
+ -pulseaudio .......... Compile PulseAudio support.
|
||||
|
||||
-no-alsa ............. Do not compile ALSA support.
|
||||
+ -alsa ................ Compile ALSA support.
|
||||
|
||||
-no-gtk .............. Do not compile GTK platform theme support.
|
||||
+ -gtk ................. Compile GTK platform theme support.
|
||||
|
||||
Additional options:
|
||||
|
||||
-make <part> ......... Add part to the list of parts to be built at make time.
|
||||
(defaults to: libs tools examples)
|
||||
-nomake <part> ....... Exclude part from the list of parts to be built.
|
||||
|
||||
-skip <module> ....... Exclude an entire module from the build.
|
||||
|
||||
-no-compile-examples . Install only the sources of examples.
|
||||
|
||||
-no-gui .............. Don't build the Qt GUI module and dependencies.
|
||||
+ -gui ................. Build the Qt GUI module and dependencies.
|
||||
|
||||
-no-widgets .......... Don't build the Qt Widgets module and dependencies.
|
||||
+ -widgets ............. Build the Qt Widgets module and dependencies.
|
||||
|
||||
-R <string> .......... Add an explicit runtime library path to the Qt
|
||||
libraries.
|
||||
|
||||
-no-rpath ............ Do not use the library install path as a runtime
|
||||
library path. On Apple platforms, this implies using
|
||||
absolute install names (based in -libdir) for dynamic
|
||||
libraries and frameworks.
|
||||
+ -rpath ............... Link Qt libraries and executables using the library
|
||||
install path as a runtime library path. Equivalent
|
||||
to -R install_libpath
|
||||
|
||||
-continue ............ Continue as far as possible if an error occurs.
|
||||
|
||||
-verbose, -v ......... Print verbose information about each step of the
|
||||
configure process.
|
||||
|
||||
-silent .............. Reduce the build output so that warnings and errors
|
||||
can be seen more easily.
|
||||
|
||||
-no-cups ............. Do not compile CUPS support.
|
||||
* -cups ................ Compile CUPS support.
|
||||
Requires cups/cups.h and libcups.so.2.
|
||||
|
||||
-no-iconv ............ Do not compile support for iconv(3).
|
||||
* -iconv ............... Compile support for iconv(3).
|
||||
|
||||
-no-evdev ............ Do not compile support for evdev.
|
||||
* -evdev ............... Compile support for evdev.
|
||||
|
||||
-no-tslib ............ Do not compile support for tslib.
|
||||
* -tslib ............... Compile support for tslib.
|
||||
|
||||
-no-icu .............. Do not compile support for ICU libraries.
|
||||
+ -icu ................. Compile support for ICU libraries.
|
||||
|
||||
-no-fontconfig ....... Do not compile FontConfig support.
|
||||
+ -fontconfig .......... Compile FontConfig support.
|
||||
|
||||
-no-strip ............ Do not strip binaries and libraries of unneeded symbols.
|
||||
* -strip ............... Strip binaries and libraries of unneeded symbols when installing.
|
||||
|
||||
* -no-pch .............. Do not use precompiled header support.
|
||||
-pch ................. Use precompiled header support.
|
||||
|
||||
* -no-ltcg Do not use Link Time Code Generation
|
||||
-ltcg Use Link Time Code Generation.
|
||||
|
||||
-no-dbus ............. Do not compile the Qt D-Bus module.
|
||||
+ -dbus-linked ......... Compile the Qt D-Bus module and link to libdbus-1.
|
||||
-dbus-runtime ........ Compile the Qt D-Bus module and dynamically load libdbus-1.
|
||||
|
||||
-reduce-relocations .. Reduce relocations in the libraries through extra
|
||||
linker optimizations (Qt/X11 and Qt for Embedded Linux only;
|
||||
experimental; needs GNU ld >= 2.18).
|
||||
|
||||
-no-use-gold-linker .. Do not link using the GNU gold linker.
|
||||
+ -use-gold-linker ..... Link using the GNU gold linker if available.
|
||||
|
||||
-force-asserts ....... Force Q_ASSERT to be enabled even in release builds.
|
||||
|
||||
-sanitize [address|thread|memory|undefined] Enables the specified compiler sanitizer.
|
||||
|
||||
-device <name> ............... Cross-compile for device <name> (experimental)
|
||||
-device-option <key=value> ... Add device specific options for the device mkspec
|
||||
(experimental)
|
||||
|
||||
-host-option <key=value> ..... Add host specific options for the host mkspec
|
||||
|
||||
* -no-separate-debug-info ...... Do not store debug information in a separate file.
|
||||
-separate-debug-info ......... Strip debug information into a separate file.
|
||||
|
||||
-no-xcb .............. Do not compile Xcb (X protocol C-language Binding) support.
|
||||
* -xcb ................. Compile Xcb support.
|
||||
|
||||
-no-eglfs ............ Do not compile EGLFS (EGL Full Screen/Single Surface) support.
|
||||
* -eglfs ............... Compile EGLFS support.
|
||||
|
||||
-no-kms .............. Do not compile backends for KMS.
|
||||
* -kms ................. Compile backends for KMS.
|
||||
|
||||
-no-gbm .............. Do not compile backends for GBM.
|
||||
* -gbm ................. Compile backends for GBM.
|
||||
|
||||
* -no-directfb ......... Do not compile DirectFB support.
|
||||
-directfb ............ Compile DirectFB support.
|
||||
|
||||
-no-linuxfb .......... Do not compile Linux Framebuffer support.
|
||||
* -linuxfb ............. Compile Linux Framebuffer support.
|
||||
|
||||
* -no-mirclient......... Do not compile Mir client support.
|
||||
-mirclient............ Compile Mir client support.
|
||||
|
||||
-qpa <name> .......... Sets the default QPA platform (e.g xcb, cocoa, windows).
|
||||
|
||||
-xplatform target .... The target platform when cross-compiling.
|
||||
|
||||
-sysroot <dir> ....... Sets <dir> as the target compiler's and qmake's sysroot and also sets pkg-config paths.
|
||||
-no-gcc-sysroot ...... When using -sysroot, it disables the passing of --sysroot to the compiler
|
||||
|
||||
-external-hostbindir <path> .. Path to Qt tools built for this machine. Use this when -platform
|
||||
does not match the current system, i.e., to make a Canadian Cross Build.
|
||||
|
||||
-no-feature-<feature> Do not compile in <feature>.
|
||||
-feature-<feature> ... Compile in <feature>. The available features
|
||||
are described in src/corelib/global/qfeatures.txt
|
||||
|
||||
-qreal [double|float] typedef qreal to the specified type. The default is double.
|
||||
Note that changing this flag affects binary compatibility.
|
||||
|
||||
-no-opengl ........... Do not support OpenGL.
|
||||
-opengl <api> ........ Enable OpenGL support
|
||||
With no parameter, this will attempt to auto-detect
|
||||
OpenGL ES 2.0 and higher, or regular desktop OpenGL.
|
||||
Use es2 for <api> to override auto-detection.
|
||||
|
||||
-no-libinput ......... Do not support libinput.
|
||||
* -libinput ............ Enable libinput support.
|
||||
|
||||
-no-gstreamer ........ Do not support GStreamer.
|
||||
+ -gstreamer <version> . Enable GStreamer support
|
||||
With no parameter, this will attempt to auto-detect GStreamer 0.10 and
|
||||
1.0. GStreamer 1.0 is used by default when available.
|
||||
Use 0.10 or 1.0 for <version> to override auto-detection.
|
||||
|
||||
-no-system-proxies ... Do not use system network proxies by default.
|
||||
* -system-proxies ...... Use system network proxies by default.
|
||||
|
||||
* -no-sctp ............. Do not compile SCTP network protocol support.
|
||||
-sctp ................ Compile SCTP support.
|
||||
|
||||
-no-warnings-are-errors Make warnings be treated normally
|
||||
-warnings-are-errors Make warnings be treated as errors
|
||||
(enabled if -developer-build is active)
|
||||
|
||||
QNX options:
|
||||
|
||||
-no-slog2 ........... Do not compile with slog2 support.
|
||||
-slog2 .............. Compile with slog2 support.
|
||||
|
||||
-no-pps ............. Do not compile with pps support.
|
||||
-pps ................ Compile with pps support.
|
||||
|
||||
-no-imf ............. Do not compile with imf support.
|
||||
-imf ................ Compile with imf support.
|
||||
|
||||
-no-lgmon ........... Do not compile with lgmon support.
|
||||
-lgmon .............. Compile with lgmon support.
|
||||
|
||||
Apple platform options:
|
||||
|
||||
-Fstring ............ Add an explicit framework path.
|
||||
|
||||
* -framework .......... Build Qt as a series of frameworks and
|
||||
link tools against those frameworks.
|
||||
-no-framework ....... Do not build Qt as a series of frameworks.
|
||||
|
||||
* -securetransport .... Use SecureTransport instead of OpenSSL
|
||||
|
||||
-no-securetransport . Do not use SecureTransport, either use OpenSSL or do not use any SSL backend
|
||||
at all (if combined with -no-openssl).
|
||||
|
||||
-sdk <sdk> .......... Build Qt using Apple provided SDK <sdk>. The argument should be
|
||||
one of the available SDKs as listed by 'xcodebuild -showsdks'.
|
||||
Note that the argument applies only to Qt libraries and applications built
|
||||
using the target mkspec - not host tools such as qmake, moc, rcc, etc.
|
||||
|
||||
Android options:
|
||||
|
||||
-android-sdk path .............. The Android SDK root path.
|
||||
(default $ANDROID_SDK_ROOT)
|
||||
|
||||
-android-ndk path .............. The Android NDK root path.
|
||||
(default $ANDROID_NDK_ROOT)
|
||||
|
||||
-android-ndk-platform .......... Sets the android platform
|
||||
|
||||
-android-ndk-host .............. Sets the android NDK host (linux-x86, linux-x86_64, etc.)
|
||||
(default $ANDROID_NDK_HOST)
|
||||
|
||||
-android-arch .................. Sets the android architecture (armeabi, armeabi-v7a, x86, mips,
|
||||
arm64-v8a, x86_64, mips64)
|
||||
|
||||
-android-toolchain-version ..... Sets the android toolchain version
|
||||
|
||||
-no-android-style-assets ....... Do not compile in the code which automatically extracts
|
||||
style assets from the run-time device. Setting this will
|
||||
make the Android style behave incorrectly, but will enable
|
||||
compatibility with the LGPL2.1 license.
|
||||
* -android-style-assets .......... Compile the code which automatically extracts style assets
|
||||
from the run-time device. This option will make the
|
||||
Android platform plugin incompatible with the LGPL2.1.
|
||||
Top-level installation directories:
|
||||
-prefix <dir> ...... The deployment directory, as seen on the target device.
|
||||
[/usr/local/Qt-$QT_VERSION, $PWD if -developer-build]
|
||||
-extprefix <dir> ... The installation directory, as seen on the host machine.
|
||||
[SYSROOT/PREFIX]
|
||||
-hostprefix [dir] .. The installation directory for build tools running on
|
||||
the host machine. If [dir] is not given, the current
|
||||
build directory will be used. [EXTPREFIX]
|
||||
-external-hostbindir <path> ... Path to Qt tools built for this machine.
|
||||
Use this when -platform does not match the current
|
||||
system, i.e., to make a Canadian Cross Build.
|
||||
|
||||
Fine tuning of installation directory layout. Note that all directories
|
||||
except -sysconfdir should be located under -prefix/-hostprefix:
|
||||
|
||||
-bindir <dir> ......... Executables [PREFIX/bin]
|
||||
-headerdir <dir> ...... Header files [PREFIX/include]
|
||||
-libdir <dir> ......... Libraries [PREFIX/lib]
|
||||
-archdatadir <dir> .... Arch-dependent data [PREFIX]
|
||||
-plugindir <dir> ...... Plugins [ARCHDATADIR/plugins]
|
||||
-libexecdir <dir> ..... Helper programs [ARCHDATADIR/bin on Windows,
|
||||
ARCHDATADIR/libexec otherwise]
|
||||
-importdir <dir> ...... QML1 imports [ARCHDATADIR/imports]
|
||||
-qmldir <dir> ......... QML2 imports [ARCHDATADIR/qml]
|
||||
-datadir <dir> ........ Arch-independent data [PREFIX]
|
||||
-docdir <dir> ......... Documentation [DATADIR/doc]
|
||||
-translationdir <dir> . Translations [DATADIR/translations]
|
||||
-sysconfdir <dir> ..... Settings used by Qt programs [PREFIX/etc/xdg]
|
||||
-examplesdir <dir> .... Examples [PREFIX/examples]
|
||||
-testsdir <dir> ....... Tests [PREFIX/tests]
|
||||
|
||||
-hostbindir <dir> ..... Host executables [HOSTPREFIX/bin]
|
||||
-hostlibdir <dir> ..... Host libraries [HOSTPREFIX/lib]
|
||||
-hostdatadir <dir> .... Data used by qmake [HOSTPREFIX]
|
||||
|
||||
Conventions for the remaining options: When an option's description is
|
||||
followed by a list of values in brackets, the interpretation is as follows:
|
||||
'yes' represents the bare option; all other values are possible prefixes to
|
||||
the option, e.g., -no-gui. Alternatively, the value can be assigned, e.g.,
|
||||
-gui=yes. Values are listed in the order they are tried if not specified;
|
||||
'auto' is a shorthand for 'yes/no'. Solitary 'yes' and 'no' represent binary
|
||||
options without auto-detection.
|
||||
|
||||
Configure meta:
|
||||
|
||||
-help, -h ............ Display this help screen
|
||||
-verbose, -v ......... Print verbose messages during configuration
|
||||
-continue ............ Continue configure despite errors
|
||||
|
||||
Build options:
|
||||
|
||||
-opensource .......... Build the Open-Source Edition of Qt
|
||||
-commercial .......... Build the Commercial Edition of Qt
|
||||
-confirm-license ..... Automatically acknowledge the license
|
||||
|
||||
-release ............. Build Qt with debugging turned off [yes]
|
||||
-debug ............... Build Qt with debugging turned on [no]
|
||||
-debug-and-release ... Build two versions of Qt, with and without
|
||||
debugging turned on [yes] (Apple and Windows only)
|
||||
-optimized-tools ..... Build optimized host tools even in debug build [no]
|
||||
-force-debug-info .... Create symbol files for release builds [no]
|
||||
-separate-debug-info . Split off debug information to separate files [no]
|
||||
-strip ............... Strip release binaries of unneeded symbols [yes]
|
||||
-force-asserts ....... Enable Q_ASSERT even in release builds [no]
|
||||
-developer-build ..... Compile and link Qt for developing Qt itself
|
||||
(exports for auto-tests, extra checks, etc.) [no]
|
||||
|
||||
-shared .............. Build shared Qt libraries [yes] (no for UIKit)
|
||||
-static .............. Build static Qt libraries [no] (yes for UIKit)
|
||||
-framework ........... Build Qt framework bundles [yes] (Apple only)
|
||||
|
||||
-platform <target> ... Select host mkspec [detected]
|
||||
-host-option <key=value> ..... Add option for the host mkspec
|
||||
-xplatform <target> .. Select target mkspec when cross-compiling [PLATFORM]
|
||||
-device <name> ....... Cross-compile for device <name>
|
||||
-device-option <key=value> ... Add option for the device mkspec
|
||||
|
||||
-qtnamespace <name> .. Wrap all Qt library code in 'namespace <name> {...}'.
|
||||
-qtlibinfix <infix> .. Rename all libQt5*.so to libQt5*<infix>.so.
|
||||
|
||||
-testcocoon .......... Instrument with the TestCocoon code coverage tool [no]
|
||||
-gcov ................ Instrument with the GCov code coverage tool [no]
|
||||
-sanitize {address|thread|memory|undefined}
|
||||
Instrument with the specified compiler sanitizer.
|
||||
|
||||
-c++std <edition> .... Select C++ standard <edition> [c++1z/c++14/c++11]
|
||||
|
||||
-sse2 ................ Use SSE2 instructions [auto]
|
||||
-sse3/-ssse3/-sse4.1/-sse4.2/-avx/-avx2/-avx512
|
||||
Enable use of particular x86 instructions [auto]
|
||||
Enabled ones are still subject to runtime detection.
|
||||
-mips_dsp/-mips_dspr2 Use MIPS DSP/rev2 instructions [auto]
|
||||
|
||||
-qreal <type> ........ typedef qreal to the specified type. [double]
|
||||
Note: this affects binary compatibility.
|
||||
|
||||
-R <string> .......... Add an explicit runtime library path to the Qt
|
||||
libraries. Supports paths relative to LIBDIR.
|
||||
-rpath ............... Link Qt libraries and executables using the library
|
||||
install path as a runtime library path. Similar to
|
||||
-R LIBDIR. On Apple platforms, disabling this implies
|
||||
using absolute install names (based in LIBDIR) for
|
||||
dynamic libraries and frameworks. [auto]
|
||||
|
||||
-reduce-exports ...... Reduce amount of exported symbols [auto]
|
||||
-reduce-relocations .. Reduce amount of relocations [auto]
|
||||
|
||||
-pch ................. Use precompiled headers [auto]
|
||||
-ltcg ................ Use Link Time Code Generation [no]
|
||||
-use-gold-linker ..... Use the GNU gold linker [auto]
|
||||
|
||||
-warnings-are-errors . Treat warnings as errors [no; yes if -developer-build]
|
||||
-silent .............. Reduce the build output so that warnings and errors
|
||||
can be seen more easily
|
||||
|
||||
Build environment:
|
||||
|
||||
-sysroot <dir> ....... Set <dir> as the target sysroot
|
||||
-gcc-sysroot ......... With -sysroot, pass --sysroot to the compiler [yes]
|
||||
|
||||
-pkg-config .......... Use pkg-config [auto]
|
||||
|
||||
-D <string> .......... Pass additional preprocessor define
|
||||
-I <string> .......... Pass additional include path
|
||||
-L <string> .......... Pass additional library path
|
||||
-F <string> .......... Pass additional framework path (Apple only)
|
||||
|
||||
-sdk <sdk> ........... Build Qt using Apple provided SDK <sdk>. The argument
|
||||
should be one of the available SDKs as listed by
|
||||
'xcodebuild -showsdks'.
|
||||
Note that the argument applies only to Qt libraries
|
||||
and applications built using the target mkspec - not
|
||||
host tools such as qmake, moc, rcc, etc.
|
||||
|
||||
-android-sdk path .... Set Android SDK root path [$ANDROID_SDK_ROOT]
|
||||
-android-ndk path .... Set Android NDK root path [$ANDROID_NDK_ROOT]
|
||||
-android-ndk-platform Set Android platform
|
||||
-android-ndk-host .... Set Android NDK host (linux-x86, linux-x86_64, etc.)
|
||||
[$ANDROID_NDK_HOST]
|
||||
-android-arch ........ Set Android architecture (armeabi, armeabi-v7a,
|
||||
arm64-v8a, x86, x86_64, mips, mips64)
|
||||
-android-toolchain-version ... Set Android toolchain version
|
||||
-android-style-assets Automatically extract style assets from the device at
|
||||
run time. This option makes the Android style behave
|
||||
correctly, but also makes the Android platform plugin
|
||||
incompatible with the LGPL2.1. [yes]
|
||||
|
||||
Component selection:
|
||||
|
||||
-skip <repo> ......... Exclude an entire repository from the build.
|
||||
-make <part> ......... Add <part> to the list of parts to be built.
|
||||
Specifying this option clears the default list first.
|
||||
[libs and examples, also tools if not cross-building,
|
||||
also tests if -developer-build]
|
||||
-nomake <part> ....... Exclude <part> from the list of parts to be built.
|
||||
-compile-examples .... When unset, install only the sources of examples [yes]
|
||||
-gui ................. Build the Qt GUI module and dependencies [yes]
|
||||
-widgets ............. Build the Qt Widgets module and dependencies [yes]
|
||||
-no-dbus ............. Do not build the Qt D-Bus module [default on Android]
|
||||
-dbus-linked ......... Build Qt D-Bus and link to libdbus-1 [auto]
|
||||
-dbus-runtime ........ Build Qt D-Bus and dynamically load libdbus-1 [no]
|
||||
-feature-<feature> ... Enable <feature>. The available features are described
|
||||
in src/corelib/global/qfeatures.txt. [all enabled]
|
||||
-accessibility ....... Enable accessibility support [yes]
|
||||
Note: Disabling accessibility is not recommended.
|
||||
-qml-debug ........... Enable QML debugging support [yes]
|
||||
|
||||
Qt comes with bundled copies of some 3rd party libraries. These are used
|
||||
by default if auto-detection of the respective system library fails.
|
||||
|
||||
Core options:
|
||||
|
||||
-doubleconversion .... Select used double conversion library [system/qt/no]
|
||||
No implies use of sscanf_l and snprintf_l (imprecise).
|
||||
-glib ................ Enable Glib support [auto]
|
||||
-iconv ............... Enable iconv(3) support [auto]
|
||||
-icu ................. Enable ICU support [auto]
|
||||
-pps ................. Enable PPS support [auto] (QNX only)
|
||||
-pcre ................ Select used libpcre3 [system/qt]
|
||||
-zlib ................ Select used zlib [system/qt]
|
||||
|
||||
Logging backends:
|
||||
-journald .......... Enable journald support [no]
|
||||
-syslog ............ Enable syslog support [no]
|
||||
-slog2 ............. Enable slog2 support [auto] (QNX only)
|
||||
|
||||
Network options:
|
||||
|
||||
-ssl ................. Enable either SSL support method [auto]
|
||||
-no-openssl .......... Do not use OpenSSL [default on Apple]
|
||||
-openssl-linked ...... Use OpenSSL and link to libssl [no]
|
||||
-openssl-runtime ..... Use OpenSSL and dynamically load libssl [auto]
|
||||
-securetransport ..... Use SecureTransport [auto] (Apple only)
|
||||
|
||||
-sctp ................ Enable SCTP support [no]
|
||||
|
||||
-libproxy ............ Enable use of libproxy [no]
|
||||
-system-proxies ...... Use system network proxies by default [yes]
|
||||
|
||||
Gui, printing, widget options:
|
||||
|
||||
-cups ................ Enable CUPS support [auto]
|
||||
|
||||
-fontconfig .......... Enable Fontconfig support [auto]
|
||||
-freetype ............ Select used FreeType [system/qt/no]
|
||||
-harfbuzz ............ Select used HarfBuzz-NG [system/qt/no]
|
||||
(Not auto-detected on Apple and Windows)
|
||||
|
||||
-gtk ................. Enable GTK platform theme support [auto]
|
||||
|
||||
-lgmon ............... Enable lgmon support [auto] (QNX only)
|
||||
|
||||
-no-opengl ........... Disable OpenGL support
|
||||
-opengl <api> ........ Enable OpenGL support. Supported APIs:
|
||||
es2 (default on Windows), desktop (default on Unix)
|
||||
-opengles3 ........... Enable OpenGL ES 3.x support instead of ES 2.x [auto]
|
||||
|
||||
-qpa <name> .......... Select default QPA backend (e.g., xcb, cocoa, windows)
|
||||
-xcb-xlib............. Enable Xcb-Xlib support [auto]
|
||||
|
||||
Platform backends:
|
||||
-directfb .......... Enable DirectFB support [no] (Unix only)
|
||||
-eglfs ............. Enable EGLFS support [auto; no on Android]
|
||||
-gbm ............... Enable backends for GBM [auto] (Linux only)
|
||||
-kms ............... Enable backends for KMS [auto] (Linux only)
|
||||
-linuxfb ........... Enable Linux Framebuffer support [auto] (Linux only)
|
||||
-mirclient ......... Enable Mir client support [no] (Linux only)
|
||||
-xcb ............... Select used xcb-* libraries [system/qt/no]
|
||||
(-qt-xcb still uses system version of libxcb itself)
|
||||
|
||||
Input backends:
|
||||
-evdev ............. Enable evdev support [auto]
|
||||
-imf ............... Enable IMF support [auto] (QNX only)
|
||||
-libinput .......... Enable libinput support [auto]
|
||||
-mtdev ............. Enable mtdev support [auto]
|
||||
-tslib ............. Enable tslib support [auto]
|
||||
-xinput2 ........... Enable XInput2 support [auto]
|
||||
-xkbcommon-x11 ..... Select xkbcommon used in combination with xcb
|
||||
[system/qt/no]
|
||||
-xkb-config-root <dir> ... With -qt-xkbcommon-x11, set default XKB config
|
||||
root <dir> [detect]
|
||||
-xkbcommon-evdev ... Enable X-less xkbcommon in combination with libinput
|
||||
[auto]
|
||||
|
||||
Image formats:
|
||||
-gif ............... Enable reading support for GIF [auto]
|
||||
-libpng ............ Select used libpng [system/qt/no]
|
||||
-libjpeg ........... Select used libjpeg [system/qt/no]
|
||||
|
||||
Database options:
|
||||
|
||||
-sql-<driver> ........ Enable SQL <driver> plugin. Supported drivers:
|
||||
db2 ibase mysql oci odbc psql sqlite2 sqlite tds
|
||||
[all auto]
|
||||
-sqlite .............. Select used sqlite3 [system/qt]
|
||||
|
||||
Multimedia options:
|
||||
|
||||
-pulseaudio .......... Enable PulseAudio support [auto]
|
||||
-alsa ................ Enable ALSA support [auto]
|
||||
-no-gstreamer ........ Disable support for GStreamer
|
||||
-gstreamer [version] . Enable GStreamer support [auto]
|
||||
With no parameter, 1.0 is tried first, then 0.10.
|
||||
|
Loading…
Reference in New Issue
Block a user