Qt5.7.0配置选项(configure非常详细的参数)

时间:2022-06-17 10:48:01

configure是一个命令行工具,用于配置Qt编译到指定平台。configure必须运行于Qt源码根目录。当运行configure时,编译源码使用的是所选工具链中的make工具。

一.源码目录、编译目录和安装目录

源码目录就是包含源码的目录。编译目录是包含Makefiles文件、object文件和其他中间文件的目录。安装目录是二进制文件和库文件安装的目录。

当编译目录和源码目录不一样时,称为影子编译(shadow build),比如说,Qt Creator默认是使用影子编译来编译工程的。这里也可以使用影子编译,方法就是新建一个目录,然后cd到该目录中运行configure,如下所示。

  1. mkdir ~/qt-build
  2. cd ~/qt-build
  3. ~/qt-source/configure

此时,configure时生成的Makefiles文件,以及编译时生成的中间文件都会拷贝到qt-build目录。不仅如此,通过影子编译,可以同时进行多个不同配置选项的编译过程,互不影响。
默认的安装目录和平台相关,但是在configure时,可以通过-prefix选项指定安装目录,比如./configure -prefix /opt/Qt-5.7。这样一来,在执行make install指令时,编译完成的bin、lib或者其他子目录就会拷贝到/opt/Qt-5.7目录中。

二.包含和排除Qt模块

通过configure,可以包含或排除指定的Qt模块。需要注意的是,许多模块依赖于其他的模块,不恰当的配置选项会导致依赖问题。

1.排除Qt模块

使用configure的-skip选项可以排除Qt模块,一般情况下模块名就是源码目录中对应的子目录名。有些子目录会包含多个模块,比如说qtconnectivity目录就包含了Qt NFC模块和Qt Bluetooth模块,排除这两个模块需要将-skip qtconnectivity作为配置参数,如下所示。

  1. ./configure -skip qtconnectivity

2.包含或排除特性
-feature-<feature> 和 -no-feature-<feature>选项用于包含和排除特性。可用的<feature>都被罗列在tbase/src/corelib/global/qfeatures.txt文件中。比如,要禁用accessibility特性,可用使用-no-feature-accessibility选项,如下所示。

  1. ./configure -no-feature-accessibility

三.第三方库

Qt源码中包含了一些第三方库,如果想使用Qt自带的第三方库,可用通过-qt配置;如果想使用系统中的第三方库,可用通过-system配置。下表中列出一些第三方库及其配置选项。

Library Name Bundled in Qt Installed in System
zlib -qt-zlib -system-zlib
libjpeg -qt-libjpeg -system-libjpeg
libpng -qt-libpng -system-libpng
xcb -qt-xcb -system-xcb
xkbcommon -qt-xkbcommon -system-xkbcommon
freetype -qt-freetype -system-freetype
PCRE -qt-pcre -system-pcre
HarfBuzz-NG -qt-harfbuzz -system-harfbuzz

当然,也可以禁用这些第三方库,用-no替换-qt就行,如下所示。

  1. ./configure -no-zlib -qt-libjpeg -qt-libpng -system-xcb

四.编译选项

-platform选项指定了目标平台和编译时使用的编译器,Qt支持的平台和编译器都在qtbase/mkspecs目录中。比如,在Ubuntu Linux系统中,Qt能被多种编译器编译,比如clang和g++,如下所示。

  1. ./configure -platform linux-clang
  2. ./configure -platform linux-g++
  3. ./configure -platform linux-g++-32

对于Windows系统,可以用MinGW或者Visual Studio工具链,如下所示。

  1. configure.bat -platform win32-g++
  2. configure.bat -platform win32-msvc2010

五.交叉编译选项

通用的选项如下所示。

-xplatform:指定目标平台,可用的xplatform与platform类似,也在qtbase/mkspecs目录中。

-device:指定特殊的设备或芯片,configure兼容的device在qtbase/mkspecs/devices目录中。

-device-option:设置额外的qmake参数,比如,-device-option CROSS_COMPILE=<path-to-toolchain>提供了特定设备交叉编译所需的环境变量。
六.Windows中使用OpenGL选项

在Windows中,Qt可以配置使用系统的OpenGL或者自带的ANGLE。默认情况下,Qt会配置使用ANGLE,ANGLE依赖于DirectX SDK。ANGLE使得依赖于OpenGL的Qt应用程序可以在没有安装OpenGL的机器上运行。

-opengl选项可以配置Qt使用目标机器上的OpenGL,如下所示。

  1. configure.bat -opengl desktop

desktop选项告知Qt使用Windows上的OpenGL,当然前提是要求Windows上的OpenGL与Qt兼容。

-opengl选项支持两个版本的OpenGL ES,一个是es2,一个是es1,如下所示。

  1. configure.bat -opengl es2

七.configure -h

configure -h与configure -help功能相同,显示所有配置选项。以下是Windows上Qt5.7.0的配置选项。

Installation options:
These are optional, but you may specify install directories.
    -prefix <dir> ...... The deployment directory, as seen on the target device.(default %CD%)                     
    -extprefix <dir> ... The installation directory, as seen on the host machine.(default SYSROOT/PREFIX)
   -hostprefix [dir] .. The installation directory for build tools running onthe host machine. If [dir] is not  given, 
                                the current builddirectory 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)                     
    -libdir <dir> ...... Libraries will be installed to <dir>.(default PREFIX/lib)                      
    -headerdir <dir> ... Headers will be installed to <dir>. (default PREFIX/include)                    
    -archdatadir <dir> . Architecture-dependent data used by Qt will be installed to <dir>.(default PREFIX)
    -libexecdir <dir> .. Program executables will be installed to <dir>.(default ARCHDATADIR/bin)
    -plugindir <dir> ... Plugins will be installed to <dir>.(default ARCHDATADIR/plugins)                      
    -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> ..... Data used by Qt programs 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)
    -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 Qt libraries, with and without debugging turned on.
    -force-debug-info .. Create symbol files for release builds.
    -separate-debug-info Strip debug information into a separate file.
    -developer-build ... Compile and link Qt with Qt developer options(including auto-tests exporting)                   
    -optimized-tools ... Build optimized host tools even in debug build.
 *  -no-optimized-tools Do not 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.
    -C++std <edition> .. Compile Qt with C++ standard edition (c++11, c++14, c++1z)Default: highest supported. 
                                    This  option is notsupported for MSVC.                                  
    -use-gold-linker ... Link using the GNU gold linker (gcc only).
 *  -no-use-gold-linker Do not link using the GNU gold linker.
    -enable-new-dtags .. Use new DTAGS for RPATH (Linux only).
 *  -disable-new-dtags . Do not use new DTAGS for RPATH.
 *  -shared ............ Create and use shared Qt libraries.
    -static ............ Create and use static Qt libraries.
 *  -static-runtime .... Statically link the C/C++ runtime library.
    -ltcg .............. Use Link Time Code Generation. (Release builds only)
 *  -no-ltcg ........... Do not use Link Time Code Generation.
    -make <part> ....... Add part to the list of parts to be built at make time,list containslibs,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-widgets ........ Disable Qt Widgets module.
    -no-gui ............ Disable Qt GUI module.
    -no-accessibility .. Disable accessibility support.Disabling accessibility is not recommended, as it willbreak 
                                  QStyle and may break other internal parts of Qt.With this switch you create a source 
                                  incompatibleversion of Qt,which is unsupported.        
 *  -accessibility ..... Enable accessibility support.
    -no-sql-<driver> ... Disable SQL <driver> entirely, by default none are turned on.          
    -qt-sql-<driver> ... Enable a SQL <driver> in the Qt Library.
    -plugin-sql-<driver> Enable SQL <driver> as a plugin to be linked to at run time.Available values for <driver>: 
                                    MySQL
                                    psql
                                    oci
                                    odbc
                                    tds
                                    db2
 +                                 sqlite
                                    sqlite2
                                    ibase
                                    (drivers marked with a '+' have been detected asavailable on this system)                      
    -system-sqlite ..... Use sqlite from the operating system.
    -no-opengl ......... Do not support OpenGL.
    -opengl <api> ...... Enable OpenGL support with specified API version.Available values for <api>:
                                  desktop - Enable support for Desktop OpenGL
                                  dynamic - Enable support for dynamically loadedOpenGL (either desktop or ES)
 *                               es2 - Enable support for OpenGL ES 2.0
 *  -no-openvg ......... Disables OpenVG functionality.
    -openvg ............ Enables OpenVG functionality.
    -force-asserts ..... Activate asserts in release mode.
    -platform <spec> ... The operating system and compiler you are building on.(default %QMAKESPEC%)                
    -xplatform <spec> .. The operating system and compiler you are cross compiling to.See the README file for a 
                                     list of supported operatingsystems and compilers.
    -target ............ Set target OS version. Currently the only valid value is 'xp' for targeting Windows XP.MSVC >=2012
                             targets Windows Vista by default.                  
    -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.
    -qconfig <local> ... Use src/corelib/global/qconfig-<local>.h rather than the default 'full'.                    
 *  -no-nis ............ Do not compile NIS support.
    -nis ............... Compile NIS support.
    -no-iconv .......... Do not enable support for iconv(3).
 +  -iconv ............. Enable support for iconv(3).
 +  -sun-iconv ......... Enable support for iconv(3) using sun-iconv.
 +  -gnu-iconv ......... Enable support for iconv(3) using gnu-libiconv.
    -no-evdev .......... Do not enable support for evdev.
 +  -evdev ............. Enable support for evdev.
    -no-mtdev .......... Do not enable support for mtdev.
 +  -mtdev ............. Enable support for mtdev.
 +  -inotify ........... Explicitly enable Qt inotify(7) support.
    -no-inotify ........ Explicitly disable Qt inotify(7) support.
 +  -eventfd ........... Enable eventfd(7) support in the UNIX event loop.
    -no-eventfd ........ Disable eventfd(7) support in the UNIX event loop.
 *  -largefile ......... Enables Qt to access files larger than 4 GB.
    -posix-ipc ......... Enable POSIX IPC.
    -glib .............. Compile Glib support.
    -sysconfdir <dir> .. Settings used by Qt programs will be looked for in <dir>.             
    -system-proxies .... Use system network proxies by default.
 *  -no-system-proxies . Do not use system network proxies by default.
 +  -warnings-are-errors Make warnings be treated as errors.
    -no-warnings-are-errors Make warnings be treated normally.
    -qtnamespace <name> Wraps all Qt library code in 'namespace name {...}'.
    -qtlibinfix <infix> Renames all Qt* libs to Qt*<infix>.
    -D <define> ........ Add an explicit define to the preprocessor.
    -I <includepath> ... Add an explicit include path.
    -L <librarypath> ... Add an explicit library path.
    -l <libraryname> ... Add an explicit library name, residing in a librarypath.                
    -no-pch ............ Do not use precompiled header support.
 *  -pch ............... Use precopmiled header support.
    -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   
    -qt-pcre ........... Use the PCRE library bundled with Qt.
 +  -system-pcre ....... Use the PCRE library from the operating system.See http://pcre.org/   
    -icu ............... Use the ICU library.
 *  -no-icu ............ Do not use the ICU library.See http://site.icu-project.org/
    -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 con version.
    -qt-doubleconversion Use the libdouble-conversion bundled with Qt.
    -system-doubleconversion Use the libdouble-conversion provided by the system.
    -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.
    -fontconfig ........ Build with FontConfig support.
 *  -no-fontconfig ..... Do not build with FontConfig support.
    -no-harfbuzz ....... Do not compile in HarfBuzz-NG support.
 *  -qt-harfbuzz ....... Use HarfBuzz-NG bundled with Qt to do text shaping.It can still be disabled by settingthe 
                                 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 
 +  -angle ............. Use the ANGLE implementation of OpenGL ES 2.0.
    -no-angle .......... Do not use ANGLE.See http://code.google.com/p/angleproject/
                         
Qt for Windows only:
    -no-incredibuild-xge Do not add IncrediBuild XGE distribution commands to custom build steps.           
 +  -incredibuild-xge .. Add IncrediBuild XGE distribution commands to custom build steps. This will distribute MOC
                                   and UIC steps,and other custom buildsteps which are added to theINCREDIBUILD_XGE 
                              variable.(The IncrediBuild distribution commands are only addedto Visual Studio projects)
 *  -no-plugin-manifests Do not embed manifests in plugins.
    -plugin-manifests .. Embed manifests in plugins.
    -no-qmake .......... Do not compile qmake.
 *  -qmake ............. Compile qmake.
    -qreal [double|float] typedef qreal to the specified type. The default is double.Note that changing this flag affects binary compatibility.  
    -no-rtti ........... Do not compile runtime type information.
 *  -rtti .............. Compile runtime type information.
    -no-strip .......... Do not strip libraries and executables of debug info when installing.
 *  -strip ............. Strip libraries and executables of debug info when installing.
    -no-sse2 ........... Do not compile with use of SSE2 instructions.
 +  -sse2 .............. Compile with use of SSE2 instructions.
    -no-sse3 ........... Do not compile with use of SSE3 instructions.
 +  -sse3 .............. Compile with use of SSE3 instructions.
    -no-ssse3 .......... Do not compile with use of SSSE3 instructions.
 +  -ssse3 ............. Compile with use of SSSE3 instructions.
    -no-sse4.1 ......... Do not compile with use of SSE4.1 instructions.
 +  -sse4.1 ............ Compile with use of SSE4.1 instructions.
    -no-sse4.2 ......... Do not compile with use of SSE4.2 instructions.
 +  -sse4.2 ............ Compile with use of SSE4.2 instructions.
    -no-avx ............ Do not compile with use of AVX instructions.
 +  -avx ............... Compile with use of AVX instructions.
    -no-avx2 ........... Do not compile with use of AVX2 instructions.
 +  -avx2 .............. Compile with use of AVX2 instructions.
    -no-avx512 ......... Do not compile with use of AVX512 instructions.
 +  -avx512 ............ Compile with use of AVX512 instructions.
    -no-ssl ............ Do not compile support for SSL.
 +  -ssl ............... Enable run-time SSL support.
    -no-openssl ........ Do not compile support for OpenSSL.
 +  -openssl ........... Enable run-time OpenSSL support.
    -openssl-linked .... Enable linked OpenSSL support.
    -no-libproxy ....... Do not compile in libproxy support.
 +  -libproxy .......... Compile in libproxy support (for cross compilation targets).
    -no-dbus ........... Do not compile in D-Bus support.
    -dbus-linked ....... Compile in D-Bus support and link to libdbus-1.
    -dbus-runtime ...... Compile in D-Bus support and load libdbus-1 dynamically.
    -no-audio-backend .. Do not compile in the platform audio backend into Qt Multimedia.
 +  -audio-backend ..... Compile in the platform audio backend into Qt Qt Multimedia.
 *  -no-wmf-backend .... Do not compile in the windows media foundation backend into Qt Multimedia.
    -wmf-backend ....... Compile in the windows media foundation backend into Qt Multimedia.
    -no-qml-debug ...... Do not build the in-process QML debugging support.
 *  -qml-debug ......... Build the in-process QML debugging support.
    -no-directwrite .... Do not build support for DirectWrite font rendering.
 +  -directwrite ....... Build support for DirectWrite font rendering.
 *  -no-direct2d ....... Do not build the Direct2D platform plugin.
    -direct2d .......... Build the Direct2D platform plugin (experimental,requires Direct2D availability on target systems,
                              e.g. Windows 7 with Platform Update, Windows 8, etc.)
    -no-style-<style> .. Disable <style> entirely.
    -qt-style-<style> .. Enable <style> in the Qt Library.
                                  Available styles:
 *                               windows
 +                              windowsxp
 +                              windowsvista
 *                               fusion
    -no-native-gestures Do not use native gestures on Windows 7.
 *  -native-gestures ... Use native gestures on Windows 7.
 *  -no-mp ............. Do not use multiple processors for compiling with MSVC
    -mp ................ Use multiple processors for compiling with MSVC (-MP).
    -loadconfig <config> Run configure with the parameters from file configure_<config>.cache.                
    -saveconfig <config> Run configure and save the parameters in file configure_<config>.cache.
    -redo .............. Run configure with the same parameters as last time.
    -v, -verbose ....... Run configure tests with verbose output.

http://blog.csdn.net/caoshangpa/article/details/53706801