http://qbaok.blog.163.com/blog/static/1012926520119219573294/
记录下 QT Linux 静态编译遇到的坑
2011-10-21 21:57:32|分类：
Linux
|标签：
|字号大中小订阅
Qt下静态编译Qt，根据我的经验，如果按照Windows下那种直接拿官方sdk安装之后的文件来编译是行不通的，需要直接下载Qt的source包，目前诺基亚的源码叫做qt-everywhere-opensource-src的tar包，到网上一查，乖乖，大部分人编译这个包居然花费了12～13个小时！但是，根据我在Windows下静态编译Qt的经验，其实这之中很多东西都是可以不用编译的，最终我大约用了40分钟编译完成了全部内容。如果你直接使用官方的sdk安装，那么你就已经有了一个动态库，现在你又通过源码包编译，那么只要编译出静态库，因为你已经有动态库，你甚至只需要编译静态release库就足够了，谁会在平时编译的时候就要用那种浪费时间的静态编译？等到产品要部署到别的机器的时候，Qt需要用的时候连接上就可以了，这样其它的内容，如动态库的demo，examples都依旧可用，安装两个版本又不会花太多时间，岂不两全其美？长话短说，现在说安装步骤。
1. 到网上下载qt-everywhere源码包,
如果你只要库，那么你也可以到下面的网址找到你需要的版本。
http://www.qtcn.org/bbs/read.php?tid=1075
2. 解压缩到你的目标目录
3. 通过configure选择要编译的部分。
你可以通过直接修改configure文件中的QT_DEFAULT_BUILD_PARTS="libs tools examples demos docs translations"，把examples,docs,demos都去掉（我只去掉了这三个，理论上如果安装了动态版本，tools和translations(这个是linguist要用的）也是可以去掉的。你也可以通过在最终的configure指令中加入 –no-make ***(这里就是刚才提到的PARTS名字），而无需修改configure文件
还有一些选项是默认的，你也可以指定选项。这些默认选项在大部分情况下都是没问题的，可是如果你的程序要部署到某些不确定的linux系统上，譬如有的系统连jpg,png的库都没有（这些在configure默认选项中使用的是系统库，如果系统没有这些库，岂不悲剧），那么你可以加入 –qt-gif -qt-libpng –qt-libmng –qt-libjpeg几个选项。
如果你决定只用静态库来做最终产品发布，那么你没有必要编译debug库，只需要编译release即可。
4. 使用configure生成makefile
因为你不但想用自己编译的静态库，你还想能够用sdk自动安装的动态库以及那些demos，examples，为了能让两个Qt库共存，configure时必须为静态库制定一个与动态库所在位置不同的文件夹，例如我的sdk安装到 /opt/qtsdk-2010.05/下，那么我就在/opt下建立了一个叫qtstatic的文件夹来存放静态库，然后使用的configure命令：
./configure –prefix /opt/qtstatic –static –release。当然，我不喜欢看到满屏乱七八糟的输出，以及因为一个小错误突然终止了编译，所以又指定了以下选项：
-continue 当发生错误时，尽可能继续编译
-silent 进行make时只会显示警告和错误等，不会把编译指令也输出到屏幕上
当然，如果你最初没有通过修改configure文件的方式来删减编译模块，不要忘记加上-nomake选项，譬如你不想编译examples，就可以加上：
-nomake examples ，依次类推
因为工程比较大，所以这个步骤可能会花费几分钟的时间。如果你指定编译的内容不是很多，应该可以很快完成。
Qt 4.7.4 sample:
./configure -static -release -qt-zlib -qt-gif-qt-libpng -qt-libmng -qt-libjpeg -nomake demos -nomake examples -nomake docs -qt-sql-sqlite -webkit -script -silent
./configure -static -release -qt-zlib -qt-gif-qt-libpng -qt-libmng -qt-libjpeg -nomake demos -nomake examples -nomake docs -qt-sql-sqlite -webkit -script -silent
在 64 位的 arch 中貌似加上 -phonon -javascript-jit -scripttools 项目编译就报错，不知道为啥。
使用 qt 4.8 后 如上静态编译配置会提示 WARNING: Using static linking will disable the WebKit module.。编译后没有 webkit 静态包。 在 configure 文件中存在如下判断：
if [ "$CFG_SHARED" = "no" ]; then
echo "WARNING: Using static linking will disable the WebKit module."
canBuildWebKit="no"
fi
加入 -shared 配置项就可编译webkit 模块，但是编译后仍然是动态的。看来暂时无法在 Qt 4.8.0 中静态编译带有 webkit 的项目。
此外-qt-gif配置项已经不存在了，需要去除 或 替换为-qt-libtiff 如果你需要生成 tiff 格式图片的话。
Qt 4.8 sample:
./configure -static -release -qt-zlib-qt-libtiff-qt-libpng -qt-libmng -qt-libjpeg -nomake demos -nomake examples -nomake docs -qt-sql-sqlite -webkit -script -silent-shared
./configure -static -release -qt-zlib-qt-libtiff-qt-libpng -qt-libmng -qt-libjpeg -nomake demos -nomake examples -nomake docs -qt-sql-sqlite -webkit -script -silent-shared
5. 编译和安装
最后当然就是make和make install了，不过不要忘了make还有多线程编译的功能哟！如果你的机器这段时间不打算做别的事情的话，完全可以加入以下选项：
-k 当发生错误时，尽可能继续编译
-j N 同时进行N项编译，建议N的值为你的CPU核数X1.5。当然，我选的值略微狠了点，我的电脑是奔腾双核T4300，make指令为： make –k –j 4 ，然后我就看到系统监视器里CPU直接飙到100%了。
编译完成，make install就可以。当然，作为linux系统，需要注意文件夹的权限问题……呃，如果你不了解这个问题，我想你需要在linux上多下点儿功夫。
加入 -script -webkit 后出现问题：
/usr/bin/ld: cannot find -ljscore$ cd /c/Qt/4.7.4/src/3rdparty/webkit/JavaScriptCore/release
$ cp libjscore.a /c/Qt/4.7.4/lib/
$ cp libjscore.prl /c/Qt/4.7.4/lib/
将 libjscore.a 和 libjscore.prl 从源目录下copy到lib目录中再执行 make。
make install 后，具体工程文件的静态编译也会报这个问题。同样将这两个文件复制到静态编译Qt的lib目录中就可解决。
6. 如何静态编译一个程序
在pro文件中，加入
CONFIG +=static或者
CONFIG +=staticlib，这个具体取决于你的工程类型了。
这样Qt就会让编译器尽量寻找静态库来连接（包括Qt库之外的那些库），当然，这不排除Qt会静态连接一些会导致兼容性问题的库。这个在Qt Centre中有人提出了一个解法，如有需要可以查阅：
http://www.qtcentre.org/wiki/index.php?title=Building_static_applications
7. 动态/静态两个版本共存问题
通常，你是不需要在系统变量中加入Qt库的位置的。Qt Creator可以自动扫描到系统中存在的Qt库版本，如果扫描不到，你可以通过Creator的 Tool->Options->Qt4中添加静态库的路径。而QDevelop虽然没有那么智能，你也可以手动指定INCLUDE和LIB的位置。或许，这根本就不是一个问题。如果你怀念动态库，或者在产品发布之前并不想体验静态编译那种蜗牛爬一般的速度，你可以在pro文件中指定CONFIG += shared，而且，要记得在Project中选择相应的版本。
8. 静态版本过大的问题
首先，静态编译的Qt程序一个debug版程序150M左右，一个release版本10M左右，这样你知道为什么我不会编译静态debug库了吧？因为没有必要。你可以使用strip，UPX（Windows）等工具来压缩你生成的庞大程序。空间与速度从来都是一对冤家，Windows下静态编译出的程序，经过UPX压缩可以减少到原来的一般体积，但是启动速度也随之严重下降。当然，论程序启动速度，自己的设计和实现才是关键所在，最后发布的程序要不要压缩，那需要根据实际情况而定。
祝你与Qt相处愉快！
PS. configure阶段出现 “Basic XLib functionality test failed“的解决办法：
编译qt-x11-opensource-src-4.5.3是出现“Basic XLib functionality test failed“
解决方法：
此完整出错信息是在./configure阶段
Basic XLib functionality test failed!
You might need to modify the include and library search paths by editing
QMAKE_INCDIR_X11 and QMAKE_LIBDIR_X11 in /home/zhu/Qt/qt-x11-opensource-src-4.5.2/mkspecs/linux-g++
进config.test/x11/xlib 执行make命令，看出错信息
g++ -Wl,-O1 -o xlib xlib.o -L/usr/X11R6/lib -lXext -lX11 -lm
/usr/bin/ld: cannot find -lXext
可以看到，g++在/usr/X11R6/lib下，找不到libXext.so
其原因就在于需要安装libX11的开发包，根据自己的系统特点，安装 libX11-dev libXext-dev libXtst-dev
对于Ubuntu，直接 sudo apt-get install libx11-dev libxext-dev libxtst-dev
对于其他：
yum install libx11-devel libxext-devel libxtst-devel
问题解决！
=================== 华丽的分割线 ==================
为了在 linux 64 位系统下编译，偶无耻的跟 PW 哥要了个 Archlinux 64.
PW 哥给装好后，偶就开始了痛苦之旅。原来它真的毛都木有……
pacman -Syu 更系统
pacman -S curl
pacman -S openssh
pacman -S gcc 安装 G++ 需要他来编译源码
pacman -S libx11 libxext libxtst libxrender 安装依赖包
开始编译。
安装目录/qmake 你的工程文件.pro
make
如果出错，记得下次make前执行 make clean 清理上次的编译过程文件。
否则可能会出现 collect2: ld returned 1 exit status 错误提示。
=================== 华丽的分割线 ==================
编译之后运行出现的问题：
如果使用了QApplication 或者 QWebPage 依赖 X server，就是说不给整个 X window 就没法跑。
在柠檬大大的提醒下，查了phantomjs 的实现，发现它也是使用了以上两者，但是可以在字符界面下运行。
检查它的项目wikihttp://code.google.com/p/phantomjs/wiki/XvfbSetup
发现搞上 Xvfb 就可以不依赖 X 了（它是内存虚拟 X server）。
yum install xorg-x11-server-Xvfbxorg-x11-server-Xorgxorg-x11-fonts* 这三依赖包
archlinux 中使用 pacman -Sy xorg-server-xvfb 来解决
*另外 据说 QT 4.8 或者 QT5 会使用Lighthouse 来解决 X 依赖，可以看如下文章：
http://blog.csdn.net/dbzhang800/article/details/6526535
暂时还不是稳定版，不打算重搞，先试试 Xvfb 得了。
然后 按如下方式建立 配置文件
（关于 /etc/init.d 和 /etc/rc.d 的关系看这篇文章http://left-uestc.appspot.com/2011/01/16/init.d-rc.d-runlevel.html）
After that, create an Xvfb init file in /etc/init.d/Xvfb containing the following:
--------------------------------------------------------------
#! /bin/sh
### BEGIN INIT INFO
# Provides: Xvfb
# Required-Start: $local_fs $remote_fs
# Required-Stop:
# X-Start-Before:
# Default-Start: 2 3 4 5
# Default-Stop:
### END INIT INFO
# N= /etc/rc.d/Xvfb
N=/etc/init.d/Xvfb
set -e
case "$1" in
start)
Xvfb :0 -screen 0 1024x768x24 &
;;
stop|reload|restart|force-reload)
;;
*)
echo "Usage: $N {start|stop|restart|force-reload}" >&2exit 1
;;
esac
exit 0
--------------------------------------------------------------
After starting Xvfb, specify the DISPLAY to use in the command line to console app:
DISPLAY=:0 你的目录/执行文件 <arguments>
=================== 华丽的分割线 ==================
此时运行可能会出现提示
IGLX error: dlopen of /usr/lib/xorg/modules/dri/swrast_dri.so failed (/usr/lib/xorg/modules/dri/swrast_dri.so: undefined
和
什么 /usr/share/fonts/type1 /usr/share/fonts/OTF 啥字体目录找不到的。
解决方法是
使用 pacman -Ss 关键字 | more 命令查询 archlinux 的远程库。看看有啥字体可以装的。
比如 装上font-misc-meltho 和 xorg-fonts-type1 来补全字体。
swrast_dri.so神马的运行 pacman -Smesa 装个图形库就好了。
=================== 华丽的分割线 ==================
大概十分钟左右就自动把显示器给黑了，比较蛋疼。而且按任意键，屏幕需要好长时间才亮，这个不速度让我不能忍受。
执行下面的命令就可以解决这个问题。
setterm -blank 0
经过测试重启后此命令会失效，所以需要装这个命令加入到启动脚本中，每次开机后自动启动。
archlinux 在/etc/bash.bashrc文件中加入:
setterm -blank 0
centos 5.4则是在/etc/bashrc加入:
setterm -blank 0
=================== 华丽的分割线 ==================
QT 静态编译后中文可能会出现乱码。
这是因为处理文字编码的libqcncodecs 库是以 plugin 形式存放在 QT 静态编译目录/plugs/codecs/libqcncodecs.a 文件中。
文字乱码，需要加入入字体插件在 main.cpp 文件内：
#include <QtPlugin>
Q_IMPORT_PLUGIN(qcncodecs)
然后在工程 pro文件中加入库：
QTPLUGIN += qjpeg qcncodecs
或者
LIBS += QT 静态编译目录/plugs/codecs/plugins/codecs/libqcncodecs.a
注意，在动态编译时，要注释掉，否则编译不通过。
=================== 华丽的分割线 ==================
QT 静态编译后，Webkit 显示的中文字体可能效果很差。
这是因为一般页面样式表使用的字体在静态编译的QT中无法自动找到替代字体（动态编译的则无问题，这个很奇怪）。
解决方法是在替换页面中的 font-family 设置。
我用的替换方法为：
在页面触发 LoadFinished 信号时，调用槽函数，执行evaluateJavaScript 方法使用JS建立个style标记
<style>
*{font-family:你的替换字体 !improtant;}
</style>
将它 appentChild 到 head 标记中，利用!improtant 的高优先级替换掉页面字体设置。
Ubuntu下Qt-4.7.1的静态编译(试过可行)
2011-09-23 12:41
|
最近在学习Qt的静态编译，相比较来说windows的Qt静态编译比较容易，相反对于linux编译网上的文章实践下来都有这样那样的错误，这里简要小结一下自己的编译成果。 一、实验环境 1、Ubuntu10.04 2、qt-x11-opensource-4.7.1.tar.gz 二、前期准备 在安装好Ubuntu10.04后默认是没有安装程序编译软件包的，所以我们首先是要配置ubuntu。 配置方法：（推荐全程root用户模式） 1、首先调整网络设置使得机器可以上网（具体做法因人而异，这边就忽略不计） 2、需要配置的安装包 ：输入命令：apt-get install build-essential libpcap0.8-dev libx11-dev libfreetype6-dev libavahi-gobject-dev libSM-dev libXrender-dev libfontconfig-dev libXext-dev 三、静态编译Qt 1、下载 qt-x11-opensource-4.7.1.tar.gz 2、解压缩qt-x11-opensource-4.7.1.tar.gz 3、配置path 输入命令：export PATH="$PATH:/usr/local/Trolltech/Qt-4.7.1/bin" 4、进入qt解压目录，配置configure命令：./configure -static -nomake demos -nomake examples -nomake tools -no-exceptions 5、分别输入“o”和“y”以后进入编译阶段 6、make 7、make install 慢慢等吧…… 四、静态编译Qt程序 1、建立文件夹，然后写程序文件XX.cpp 2、qmake -project |