799be4e489
Change-Id: If9c86c5bf9c6194f1ac282a657f9967f4fa589b3 Reviewed-by: Oswald Buddenhagen <oswald.buddenhagen@theqtcompany.com>
434 lines
21 KiB
Plaintext
434 lines
21 KiB
Plaintext
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.
|
|
-l <string> .......... Add an explicit library.
|
|
|
|
-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-nis .............. Do not compile NIS support.
|
|
* -nis ................. Compile NIS support.
|
|
|
|
-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-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.
|
|
-fw string .......... Add an explicit framework.
|
|
|
|
* -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.
|