qt 笔记四（裁剪）

Usage  configure [-h] [-prefix dir] [-prefix-install] [-bindir dir] [-libdir dir]

        [-docdir dir] [-headerdir dir] [-plugindir dir ] [-datadir dir]

        [-translationdir dir] [-sysconfdir dir] [-examplesdir dir]

        [-demosdir dir] [-buildkey key]

        这些是基本参数

        [-release] [-debug][-debug-and-release] [-developer-build]

        [-shared] [-static] [-no-fast] [-fast] [-no-largefile]

        [-largefile] [-no-exceptions] [-exceptions] [-no-accessibility]

        [-accessibility] [-no-stl] [-stl] [-no-sql-driver] [-sql-driver]

        [-plugin-sql-driver] [-system-sqlite] [-no-qt3support] [-qt3support]

        [-platform] [-D string] [-I string] [-L string] [-help]

        这些是对QT所支持模块等设置的参数

        [-qt-zlib] [-system-zlib] [-no-gif] [-qt-gif] [-no-libtiff] [-qt-libtiff] [-system-libtiff]

        [-no-libpng] [-qt-libpng] [-system-libpng] [-no-libmng] [-qt-libmng]

        [-system-libmng] [-no-libjpeg] [-qt-libjpeg] [-system-libjpeg] [-make part]

        [-no-make part] [-R string]  [-l string] [-no-rpath]  [-rpath] [-continue]

        [-verbose] [-v] [-silent] [-no-nis] [-nis] [-no-cups] [-cups] [-no-iconv]

        [-iconv] [-no-pch] [-pch] [-no-dbus] [-dbus] [-dbus-linked]

        [-no-separate-debug-info]

        这些是第三方库的支持参数

        [-no-mmx] [-no-3dnow] [-no-sse] [-no-sse2]

        [-qtnamespace namespace] [-qtlibinfix infix] [-separate-debug-info] 

        [-armfpa][-no-optimized-qmake] [-optimized-qmake] [-no-xmlpatterns]

        [-xmlpatterns][-no-phonon] [-phonon] [-no-phonon-backend] 

        [-phonon-backend][-no-openssl] [-openssl] [-openssl-linked]

        [-no-gtkstyle] [-gtkstyle] [-no-svg] [-svg] [-no-webkit] [-webkit]

        [-no-scripttools] [-scripttools]

       专属嵌入式QTE编译的模块选择参数 

安装选项：

以下选项都是可选，通过他们指定安装目录，不指定则用默认目录。选项前标记的则为系统默认，+则为添加才有效那种

    -prefix dir ......... 指定安装目录默认在 usrlocalTrolltechQtEmbedded-4.X.X

    -hostprefix [dir] ..... 指定可扩展的工具库安装路径，默认当前目录

   -prefix-install ........ 指定QT的本地安装. 至

                                 usrlocalTrolltechQtEmbedded-4.X.X, 此选项优先于-PREFIX.

以下选项用来指定分开安装不同部分，比如希望将可执行的放在usrbin 将库文件放在lib下等等

    -bindir dir ......... 指定可执行文件路径 dir(默认 PREFIXbin下)

    -libdir dir .......... 指定库文件路径 dir(默认 PREFIXlib)

    -docdir dir ........ 指定文档路径 dir(默认 PREFIXdoc)

    -headerdir dir .... 指定头文件路径 dir(默认 PREFIXinclude)

    -plugindir dir ...... 指定插件路径 dir (默认 PREFIXplugins)

    -datadir dir ........ 指定QT要使用到的一些数据文件所在路径 dir (默认 PREFIX)

    -translationdir dir . 指定QT程序的翻译文件路径 dir(默认 PREFIXtranslations)

    -sysconfdir dir ..... 指定QT的设置文件路径 dir(默认 PREFIXetcsettings)

    -examplesdir dir .... 指定实例文件， dir(默认 PREFIXexamples)

    -demosdir dir ....... 指定demos的安装路径 dir (默认 PREFIXdemos)

可以用这些选项去匹配自己所想要的插件

    - buildkey key ...... 通过指定的key生成QT库和插件。

配置选项

默认的选项(),可选添加选项(+)

  -release ........... 此选项在编译过程QT会对程序进行优化，在发布软件的时候应该用此选项，是默认选项

    -debug ............. 加上此选项编译程序QT不会做出优化，往往在开发过程使用此选项

    -debug-and-release . 编译两个版本

    -developer-build.... 编译Qt的开发商和连接选项（包括自动测试出口的Qt） 

    -opensource......... 以开源版本发布程序

    -commercial......... 以商业版本发布程序

  -shared ............ 创建和使用共享Qt库。

    -static ............ 创建和使用静态的Qt库。

  -no-fast ........... 使用通常的Makefile来编译，是默认选项

    -fast .............. 快速编译，除了封装必要的库，部分步骤省略或者用快速的方法处理

    -no-largefile ...... 禁用大文件支持。

+  -largefile ......... 支持访问大于4GB的文件

  -no-exceptions ..... 禁用编译器本身对异常的处理

    -exceptions ........ 启用编译器本身对异常的处理

    -no-accessibility .. 

  -accessibility .....   禁用启用无障碍支持

    -no-stl ............ 

  -stl ...............   禁用启用STL支持

    -no-sql-driver ... 禁用SQL

    -qt-sql-driver ... 根据需求启用SQL插件（默认全部关闭）

    -plugin-sql-driver 禁用启用启用插件 对SQL的支持

    -system-sqlite ..... 启用支持sqlite也可用-qt-sqlite

    -no-qt3support ..... 

  -qt3support ........ 禁用启用qt3支持模块

    -no-xmlpatterns .... 

+  -xmlpatterns ....... 禁用启用xmlpatterns模块

    -no-phonon ......... 

+  -phonon ............ 禁用启用Phonon模块（可以理解为声音控制模块）

    -no-phonon-backend.. 

+  -phonon-backend..... 禁用启用phonon-backend模块

    -no-svg ............ 

+  -svg ............... 禁用启用svg模块

    -no-webkit ......... 

+  -webkit ............ 禁用启用webkit模块（访问网络模块）

    -no-scripttools .... 

+  -scripttools ....... 禁用启用scripttools模块

    -platform target ... x86平台指定模块 (qwslinux-x86-g++).

    -no-mmx ............ 我不知道这四个是什么，貌似是几个指令系统？

    -no-3dnow .......... 

    -no-sse ............ 

    -no-sse2 ........... 

    -qtnamespace name  指定所有库代码路径.

    -qtlibinfix infix  重命名所有.so库文件到指定路径

    -D string ........ 添加一个预处理器

    -I string ........ 添加一个明确的头文件路径

    -L string ........ 添加一个明确的库文件路径

    -help, -h .......... 显示帮助信息

第三方库选项

（以下是第三方库，往往编译过程中需要依赖的都要加上，也没什么好说的，缺什么就加什么）

     -qt-zlib ........... 

+  -system-zlib .......      zlib依赖包 详询 httpwww.gzip.orgzlib

     -no-gif ............ 

  -qt-gif ............         gif图片支持包

                                See also srcpluginsimageformatsgifqgifhandler.h

     -no-libtiff ........ 

     -qt-libtiff ........         tiff支持插件

+  -system-libtiff ....     默认是-system调用系统的，出错的话可以尝试用-qt，qt的在编译过程不容易出错

                                  详询 httpwww.libtiff.org

     -no-libpng ......... 

     -qt-libpng .........        png图片支持插件

+  -system-libpng ..... 

                                    详询 httpwww.libpng.orgpubpng

     -no-libmng ......... 

     -qt-libmng .........       mng支持插件

+  -system-libmng ..... 

                                    详询 httpwww.libmng.com

     -no-libjpeg ........ 

     -qt-libjpeg ........         jpeg图片支持插件

+  -system-libjpeg .... 

                                     详询 httpwww.ijg.org

     -no-openssl ........ 

+  -openssl ...........        openssl支持插件

     -openssl-linked .... 

     -ptmalloc ..........        系统内存分配器

其他选项：

(扩展选项，模块的选择等，使编译更加人性化)

    -make part .......    选择是否编译某些无关紧要的子模块

    -nomake part ..... （例如不想编译系统自导的demos则可使用-nomake demos）

    -R string ........      添加一个动态库

    -l string ........       添加一个静态库

    -no-rpath .......... 

+  -rpath .............        是否将生成的库安装在软件的安装目录，默认是在安装目录，否则自己指定路径

    -continue ..........        忽略错误一路前奔的编译，因为一般情况是按照模块逐个编译的，

                                  碰到错误就停止。加上此参数是全部编译最后处理

    -verbose, -v .......      显示每个步骤的详细信息

    -silent ............        安静的编译省略信息回显

  -no-optimized-qmake ... 

    -optimized-qmake ......  禁用开启qmake的优化作用

    -no-nis ............ 

  -nis ...............         禁用开启NIS的支持

    -no-cups ........... 

  -cups ..............       禁用开启对CUPS的支持

                                 需要 cupscups.h and libcups.so.2.

    -no-iconv .......... 

  -iconv .............      禁用开启对iconv的支持.

    -no-pch ............ 

  -pch ...............      禁用开启是否使用预处理器头文件

    -no-dbus ........... 

+  -dbus ..............     禁用开启对QTdbus模块的编译

    -dbus-linked ....... 

    -reduce-relocations ..... 减少因为链接优化而导致的而外的库文件重置

    -no-separate-debug-info . 不将调试信息放在一个文件内

  -separate-debug-info .... 将调试信息放在一个文件内

以下参数仅限于嵌入式QTE编译使用：

    -xplatform target ...      交叉编译过程指定目标平台

    -no-feature-feature   不编译feature.

    -feature-feature ..    编译feature. 可选feature在srccorelibglobalqfeatures.txt文件内可查寻

    -embedded arch ....   指定嵌入式平台的类型例如：arm mips x86 generic

    -armfpa ............. 

    -no-armfpa ..........       禁用启用armfpa浮点格式支持

    -little-endian ......         指定字节顺序为小字节序、低字节序

    -big-endian .........        指定字节顺序为大字节序、高字节序

    -host-little-endian .       指定主机平台字节顺序为小字节序、低字节序

    -host-big-endian ....     指定主机平台字节顺序为大字节序、高字节序

                                    注：只需指定目标平台的字节顺序，否则将会选用主机的字节顺序

                                   arm的编译过程这项得加

    -no-freetype ........ 

    -qt-freetype ........      禁用启用对freetype 模块的支持

  -system-freetype .... 

                                   详询 httpwww.freetype.org

    -qconfig local ......      在不指定此配置的情况下系统使用

                                    srccorelibglobalqconfig-local.h 

    -depths list ......     支持显示设备的位深度。有1, 4, 8, 12, 15, 16, 18, 24, 32 and 'all'.

    -qt-decoration-style ....指定编译后的界面风格默认是windows

    -plugin-decoration-style 指定插件风格默认windows

    -no-decoration-style ....不知定风格采用默认选项

    -no-opengl .......... 

    -opengl api .......      禁用开启对opengl的支持

                                      不指定型号则系统会自动检测

                                     注意：使用此选项的前提条件是硬件支持且可以驱动

    -qt-gfx-driver ...      指定显示设备驱动库

                                   参考选项为：[ linuxfb transformed qvfb vnc multiscreen ]

    -plugin-gfx-driver 指定显示插件驱动库

                                    参考选项为：[  ahi directfb hybrid linuxfb powervr qvfb transformed vnc ]

    -no-gfx-driver ... 不加载显示设备

                                     参考选项为 [ linuxfb transformed qvfb vnc multiscreen ]

    -qt-kbd-driver ... 指定图形界面下的键盘驱动库

                                参考选项为 [ tty usb sl5000 yopy vr41xx qvfb ]

    -plugin-kbd-driver E指定图形界面下键盘插件驱动库

                         参考选项为 [  linuxis sl5000 usb vr41xx yopy ]

    -no-kbd-driver ... 不加载指定驱动

                         参考选项为 [ tty usb sl5000 yopy vr41xx qvfb ]

    -qt-mouse-driver ... 指定图形界面下鼠标驱动库

                           参考选项为 [ pc bus linuxtp yopy vr41xx tslib(触摸屏选这个) qvfb ]

    -plugin-mouse-driver 鼠标插件驱动库

                           参考选项为 [  bus linuxis linuxtp pc tslib vr41xx yopy ]

    -no-mouse-driver ... 指定不加载的鼠标驱动库模块

                           参考选项为 [ pc bus linuxtp yopy vr41xx tslib qvfb ]

    -iwmmxt ............ 编译使用iwmmxt指令集，方便对某些XScale CPUs的支持

    -no-glib ........... 

+  -glib .............. 禁用启用对glib的支持

编译一次Qt要耗费太多的时间，常常是越着急用它，编起来越慢。其实通过很简单的几招可以帮你节省编译的时间。下面就一一道来：

第一招，编译之前确定哪些功能是不必要的，对编译树进行简单裁剪。

比如最常见的，像demos， examples，虽然很有参考价值，但完全可以放在后面用到的时候再单独编译小工程，这样可以节省不少时间。经过实践，最简单的方法是修改configure文件，在该文件中有个指定编译目录的字段：

QT_DEFAULT_BUILD_PARTS=”libs tools examples demos docs translations”

可以把examples、demos和docs从这里去掉，但要注意，别的可不能随便去掉。

如果在后面的使用中发现有些小工程需要编译了，可以采用一般编译Qt程序的方法，即用Qt安装目录bin下的qmake来生成Makefile，同样可以编译和测试例子代码，一点也不影响使用。

第二招，裁剪Qt模块。

Qt 从4版本开始采用了模块化的形式，将独立的功能封装在独立的库里，所以可以很简单的去掉一些不需要的库，这样也能节省编译时间和对硬盘空间的占用。 Qt的configure配置提供了一些设置模块的方法，如它支持-no-svg和-no-webkit，通过configure的时候加这些选项就可以 去掉这部分支持。相应的还有很多小的功能可以通过configure参数的形式配置，具体的参考configure –help的输出。在查看configure帮助的时候特别要注意加号的内容，也就是Qt默认的configure选项，有的时候默认选项可不一定是讨 人喜欢的哦。

Qt桌面版本默认会尽量多的编译feature进去，这样有一定的好处，就是用户可以用到所有的Qt功能，但坏处也很明显，那就是编 译出来的Qt超级大，特别是编译debug版本，基本上要占1到2G的空间，所以个人感觉研究一下configure的选项还是很有必要的。另外， 默认状况下有些插件是不会编译的，比如数据库插件，往往需要用户自己根据需要编译，这一点也要注意。

第三招，针对嵌入式版本的配置。

Qt 的嵌入式版本本身就支持feature裁剪，我们可以充分利用这一特性让Qt库尽量变小。具体的做法是要做一个自己的 qconfig-[myconfig].h特性文件，该文件中定义你要去掉Qt中的哪些feature。在configure的时候加“-qconfig myconfig” 选项， Qt就会根据你给出的配置文件来编译，以达到裁剪的目的。这里要强调一下，这种裁剪方式只适用于嵌入式版本。这里的myconfig可以用任何你喜欢的名 字来代替。

在qt的代码中已经给出了一些qconfig头文件的例子，默认编译采用full config也就是

不裁剪任何 feature。所有Qt预定义好的qconfig文件，可以在srccorelibglobal下找到，包括qconfig- minimal.h, qconfig-small.h, qconfig.medium.h,qconfig-large.h和qconfig-dist.h，也就是从裁剪量由多到少都有据可依。如果要添加你自 己的配置文件，要在srccorelibglobal下建立一个形如qconfig-xxx.h的文件，这个xxx也就是你要在configure的 时候传入的qconfig参数。笔者测试使用的Qt版本是4.4.1，这个版本的build system有个小毛病，就是如果你指定的qconfig参数实际上没有qconfig-xxx.h文件对应， build不会停止，它只会给出一个不起眼的提示，编译过程会继续， 这一点挺让人费解的。而且这种情况下Qt编译使用的配置基本上和fullconfig相同，鉴于它的让人迷惑的举动，个人觉得有必要提醒大家一下，使用自 定义qconfig的时候一定要确定配置文件放对了位置，而且qconfig参数给的正确。

一般我们的建议是在桌面上测试阶段编译一个full的 版本，再根据你的项目使用Qt feature的情况总结哪些可去掉的feature。 feature之间有千丝万缕的依赖关系，这个问题也是困扰很多人的难点所在。具体的依赖可以查阅srccorelibglobal qfeatures.h和srccorelibglobalqfeatures.txt（描述依赖关系的文档）。另外，Qt里还提供了一个可视化 的配置依赖的工具，叫做qconfig，在QTDIRtoolsqconfig目录。该工具需要基于Qt桌面版本编译。如在我的linux系统下可以 用下面的命令来编译：

$ cd qt-embedded-linux-commercial-4.4.1toolsqconfig

$ usrlocalTrolltechQt-4.4.3binqmake

$ make

编 译成功后运行.qconfig，初始要打开qfeatures.txt. Qconfig读取该文件生成一个树状图，该图很清楚的显示出feature之间的依赖关系。如下图所示，如果你去掉了LINEEDIT这个 feature，用到该控件的combobox也就不能继续使用了。有了这个工具裁剪Qt变得简洁直观，方便了很多。

选定了你要去掉的 feature后点击菜单File-Save As..会弹出保存文件的页面，文件名字应该定义成qconfig-xxx.h的形式，这样你在configure的时候就可以传入相应的qconfig 参数了。你还可以通过选择File-Open打开现有的qconfig-xxx.h文件，通过修改已经有的文件更快的编辑配置。

根据笔者测试，未经裁剪的qte4.4.1编译出来为：

libQtCore.so是2.6M

libQtGui.so是9.5M

如果用small来编译，就能缩小为：

libQtCore.so是2.0M

libQtGui.so是5.7M