首页 > 代码库 > 记录下 QT Linux 静态编译遇到的坑

记录下 QT 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
 
在 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 -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 的实现,发现它也是使用了以上两者,但是可以在字符界面下运行。
检查它的项目wiki http://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  -S mesa 装个图形库就好了。
 
=================== 华丽的分割线 ==================
 
大概十分钟左右就自动把显示器给黑了,比较蛋疼。而且按任意键,屏幕需要好长时间才亮,这个不速度让我不能忍受。
 
执行下面的命令就可以解决这个问题。
 
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 的高优先级替换掉页面字体设置。

 

http://qbaok.blog.163.com/blog/static/1012926520119219573294/

记录下 QT Linux 静态编译遇到的坑