Qt-5.3.2 在友善Smart210开发板的移植记录

kenson

1   平台说明
主机平台： Ubuntu 14.04

' r3 `" p  c7 ~4 R7 i6 J. P交叉工具链： FrendlyARM的 arm-Linux-gcc-4.5.1-v6-vfp-20120301.tgz
目标平台：FrendlyARM的Smart210开发板。（Soc是三星的S5PV210，内核是cortex-a8，下面的移植方法是普适的，不是此平台的也可参考下面的移植步骤）
$ U1 g  o$ E( q8 z+ l* [) o
Qt版本： Qt-5.3.2

4 U0 }4 m8 F  |, x" n, k- O& M0 W2   Qt5.3.2在ARM-Linux平台（Mini210开发板）的移植
进入Qt5.3.2的源码顶级目录，按照linux系统中自编译软件通用的三个步骤依次执行 ./configure 、make 、make install 即可完成Qt5的编译安装。在执行之前，首先看一下configure的帮助，了解一下各个配置项的作用。
* N; G% l. S1 ^! r. c6 E
* Z/ _; q8 c: W* ^1 L# [. R4 a$ ./configure --help >help.txt ; vi help.txt

9 Y" F+ x8 [6 z$ o
0 h9 z* ~3 `% [2 t! s, j2 N2 J9 Z配置时需要注意的几点是：

如果是交叉编译，需要配置 xplatform选项，比如要在arm-linux平台上移植Qt的话，就在配置项中加上 -xplatform linux-arm-gnueabi-g++ ，Qt5支持的交叉平台都可在源码顶层目录中的 /qtbase/mkspecs/ 下找到，每个子目录名代表一个交叉平台的名字，移植Qt时应根据自己的实际情况修改平台对应的子目录下的qmake.conf文件，它定义了一些与平台相关的环境变量，如交叉编译器等；
  z  v  J" p7 v+ v7 S. p
最好不要在编译Qt时使能 C++11，一方面你的编译器可能不支持，另一方面使能这一项后可能出现一部分编译错误；

% U/ H7 J( ^' m# Q  U, V( E7 h如果需要openGL，就需要用 -opengl选项指定opengl的api，对于嵌入式平台，一般使用 opengl ES2，配置选项中加入" -opengl es2 " 。不过想使用openGL可能会比较麻烦，因为openGL一般在有硬件图形加速的条件下才能高效运行，而这需要显卡或Soc厂家提供openGL的支持库，但并不是所有Soc都能找到对应的支持库，比如三星就没有提供S5PV210的openGL库，所以我这里编译的Qt也是没有opengl的。(openGL的替代方案：如果没有厂家提供的硬件图形库，可以考虑使用纯软件实现的opengl，这样的软件库有很多是开源的，如mesa3D库等，不过纯软件实现的opengl在效率方面肯定要比带硬件加速的低很多，而且要想在嵌入式平台上使用，必须将opengl的软件库也交叉编译出来，我在交叉编译mesa3D时遇到了些问题，所以目前还没能在开发板上用上openGL)；

2 [" J+ N9 @' |2 N: p如果想让Qt程序支持多点触摸，在配置时可能需要加上 -mtdev 和 -xinput2 选项，在help中可以找到这两个选项。mtdev包含了应用程序对多点触摸协议的支持，xinput2实现了Linux的输入子系统对多点触摸的支持。在我这里加上这两个选项的话配置会出错，可能还缺乏一些库，所以最后我没有使用这两个选项；
& `. Q4 S- W0 I- m- S5 T- x8 \
8 J& ?( i* ^) S: V  m: l" |另外，Qt5默认的qreal类型是64bit的double，如果希望用float类型定义qreal，则在配置选项中加入"-qreal float"。

我的编译过程如下：
1 }; @$ u: b, F- c
' @8 |# _0 Y% p. U7 L* H首先修改 qtbase/mkspecs/linux-arm-gnueabi-g++/qmake.conf，内容如下：
& g. V6 j4 o6 y; u
[html] view plain copy
#  
# qmake configuration for building with arm-linux-gnueabi-g++  
#  
  
MAKEFILE_GENERATOR      = UNIX  
1 |0 J# W6 X( |( D2 r( wCONFIG                 += incrementar gdb_dwarf_index  
1 R+ P. B* F( n" |+ ~QMAKE_INCREMENTAL_STYLE = sublib  
/ @( B) g: O* z' {3 AQT_QPA_DEFAULT_PLATFORM = linux #eglfs  
) n7 w7 l( G, ]% W1 t$ ]* q* O6 kQMAKE_CFLAGS_RELEASE   += -O2 -march=armv7-a   
! Y3 T2 k3 D% ]- |) dQMAKE_CXXFLAGS_RELEASE += -O2 -march=armv7-a   
  
include(../common/linux.conf)  
include(../common/gcc-base-unix.conf)  
$ o4 I( M4 _  g# n; D! ^include(../common/g++-unix.conf)  
  
$ y% a! D4 D0 C# modifications to g++.conf  
QMAKE_CC                = arm-none-linux-gnueabi-gcc  
QMAKE_CXX               = arm-none-linux-gnueabi-g++  
$ ^$ Z8 \" D, b. eQMAKE_LINK              = arm-none-linux-gnueabi-g++  
; y+ m! K$ a- _/ s' G3 r+ k1 cQMAKE_LINK_SHLIB        = arm-none-linux-gnueabi-g++  
  
# modifications to linux.conf  
QMAKE_AR                = arm-none-linux-gnueabi-ar cqs  
QMAKE_OBJCOPY           = arm-none-linux-gnueabi-objcopy  
QMAKE_NM                = arm-none-linux-gnueabi-nm -P  
/ n/ Y. e3 T" M/ ?" lQMAKE_STRIP             = arm-none-linux-gnueabi-strip  
load(qt_config)  


* ]9 e" u# r3 e$ v" N9 k( ]9 u然后执行：
* v( A. P8 m. }$ O& ?$ l* l[html] view plain copy
& l0 g7 y5 J  C8 l, A$ ./configure -release -opensource -xplatform linux-arm-gnueabi-g++ -prefix /opt/Qt-5.3.2/armv7-a -no-c++11 -qreal float  
: Q  v$ n3 S0 @# @配置结果为：
! `6 Q) \3 w" `. N
[html] view plain copy
   Configure summary  
  
' ^% B; `( Y2 {Building on:   linux-g++ (i386, CPU features:)  
) X  _  F6 e/ X: f/ e& hBuilding for:  linux-arm-gnueabi-g++ (arm, CPU features:)  
Platform notes:  
! {$ w2 j! T  x) Z& Z  
            - Also available for Linux: linux-kcc linux-icc linux-cxx  
         
1 C8 `" G: r, v# BBuild options:  
  Configuration .......... accessibility alsa audio-backend clock-gettime clock-monotonic compile_examples concurrent cross_compile evdev eventfd freetype full-config getaddrinfo getifaddrs iconv inotify ipv6ifname large-config largefile linuxfb medium-config minimal-config mremap nis no-harfbuzz no-pkg-config openssl pcre png posix_fallocate precompile_header qpa qpa reduce_exports release rpath shared small-config system-jpeg system-png system-zlib   
  Build parts ............ libs examples  
1 [4 Y; N7 L9 e7 b* I" w  Mode ................... release  
  Using C++11 ............ no  
  Using PCH .............. yes  
+ k2 w. g; [! ^% ?1 Z  Target compiler supports:  
    iWMMXt/Neon .......... no/auto  
' J6 t; m/ |- x9 q# R  
Qt modules and options:  
  Qt D-Bus ............... no  
  Qt Concurrent .......... yes  
  Qt GUI ................. yes  
; u( k8 x$ R' }1 \# j2 L  Qt Widgets ............. yes  
# Z1 |5 P9 U" k* Q  Large File ............. yes  
# @) u8 m2 B' @  QML debugging .......... yes  
  Use system proxies ..... no  
4 j4 q, L1 _% Z4 E4 I) o  
Support enabled for:  
5 P8 h3 q# T! x6 q5 L7 _  Accessibility .......... yes  
  ALSA ................... yes  
. a  b1 ^3 {% V$ e  CUPS ................... no  
" w7 H. E2 F7 `$ W, g  Evdev .................. yes  
  FontConfig ............. no  
  FreeType ............... yes (bundled copy)  
2 ^2 L7 [: t. X' m1 j, [  Glib ................... no  
  GTK theme .............. no  
  HarfBuzz ............... no  
  Iconv .................. yes  
  ICU .................... no  
( S5 p1 Q1 a# S# F0 ?" G; m+ `  Image formats:   
7 b% K/ |& G7 k# i. d/ D    GIF .................. yes (plugin, using bundled copy)  
    JPEG ................. yes (plugin, using system library)  
4 F# I& D. ~4 i    PNG .................. yes (in QtGui, using system library)  
  journald ............... no  
  mtdev .................. no  
  V. o% ]! `% j- r" K6 H  Networking:   
2 |( U2 F2 U. L/ [( F. ^    getaddrinfo .......... yes  
# R6 ?  ?  Z' s    getifaddrs ........... yes  
    IPv6 ifname .......... yes  
, t( u$ p+ E+ V3 u, g2 d6 b    OpenSSL .............. yes (loading libraries at run-time)  
  NIS .................... yes  
2 j- l) G4 c% I) r) J- [  OpenGL / OpenVG:   
    EGL .................. no  
    OpenGL ............... no  
% S) e: X$ r/ ^2 x. X1 l2 E    OpenVG ............... no  
* d0 k/ g# j; {6 |  PCRE ................... yes (bundled copy)  
  pkg-config ............. no   
  PulseAudio ............. no  
  QPA backends:   
    DirectFB ............. no  
* Y4 a- p8 e; P2 @2 m; u. c    EGLFS ................ no  
& k" E, G/ e5 U    KMS .................. no  
    LinuxFB .............. yes  
" L- _. L/ w, @1 Y7 |% i6 x9 w( H    XCB .................. no  
- \$ U5 G( U2 l! c: {% ^3 k3 b  Session management ..... yes  
  SQL drivers:   
    DB2 .................. no  
! p$ k  |$ q; Z0 q. A4 R% W    InterBase ............ no  
' N6 T- w, v2 X/ q% r    MySQL ................ no  
/ }9 i: @: @* W+ t+ l    OCI .................. no  
* d. a9 Z4 ?2 i5 I' u! r8 H2 \    ODBC ................. no  
7 i; R! S6 J7 c: `# ]  W. u  }    PostgreSQL ........... no  
    SQLite 2 ............. no  
' n) [5 ^2 r5 W1 m( R    SQLite ............... yes (plugin, using bundled copy)  
    TDS .................. no  
  udev ................... no  
  xkbcommon .............. no  
$ C9 Y' P1 R) f/ _4 d  zlib ................... yes (system library)  
; L: L2 ^9 H1 P) S% J/ M2 W3 V
! g  Y5 i! W( r8 E2 E8 x
配置完成后执行：
[html] view plain copy
$ make -j4  
$ sudo make install -j4  

3   添加 tslib 支持
为了使单点触摸屏可用，还需要编译Qt的tslib插件，这需要首先交叉编译好tslib，tslib的编译过程参见：
& j' c# K8 ~4 F
( ]" T( g' B8 o$ S# F; yhttp://blog.csdn.net/newthinker_wei/article/details/8639276
友善之臂的板子使用了 touchscreen-1wire，这需要按照上文中的步骤对tslib的源码打上补丁（在tslib的源码中添加了一个一线触摸屏的插件）。非友善之臂的板子一般不用打补丁。

另一个有用的链接在这儿，这是友善专门为tslib做的一线触摸屏的插件，有源码，上面那篇文章应该也是参考这个源码的：
# g- |8 }0 F+ V" a3 V8 X
http://www.arm9home.net/read.php?tid-16105.html

: |1 d. a) K( |9 p& H/ V注意，对于友善之臂的开发板，如果使用的是单点电阻触摸屏，使用上面的方式移植tslib就可以了。但是对于多点的电容触摸屏，上面的两个网址给出的源码都不适用了，友善的多点触摸屏使用的是goodix公司出的触摸屏，goodix驱动的接口跟友善之前用的触摸屏不一样。因此如果想使用tslib，需要再单独为goodix写个TSLIB插件。tslib源码的plugins目录中就是各个插件的代码，可以参考一下他们，都很简单（主要是实现一个read函数）。但要自己写电容屏的插件貌似比较困难，因为要对驱动程序中多点触摸的数据协议有所了解，这样才能从电容屏的数据中提取出单点数据。友善提供了friendlyarm-ts-mtinput.so 文件（但并没有源码），该文件就在友善自带的tslib中，默认目录为/usr/lib/ts/friendlyarm-ts-mtinput.so。把这个库拷贝到自己编译的tslib插件目录中，再修改配置文件ts.conf，即可使tslib工作。
, I/ z- Y$ u0 Q. X1 r# m; Q将编译出来的tslib拷贝到库开发板后，还需要在板子上设置TSLIB的环境变量，主要的几个变量如下：

: M# f1 e8 i6 f" D& c7 w" o[html] view plain copy
2 R- E3 o' ~: a+ M' n6 U' M5 f$ ?#! /bin/sh  
5 s3 X/ |+ ~- M! z  F# "source" this file when wanna run a Qt application on the ARM Board.  
: Z" q5 s. |+ @  
, Y$ W' ~" ^. U###############  the below lines are for stardard TSLIB ##################  
export TSLIB_ROOT=/opt/tslib  
export TSLIB_CALIBFILE=$TSLIB_ROOT/etc/pointercal  
% v$ U2 z% e6 t$ E0 o; kexport TSLIB_CONFFILE=$TSLIB_ROOT/etc/ts.conf  
export TSLIB_PLUGINDIR=$TSLIB_ROOT/lib/ts  
export TSLIB_TSDEVICE=/dev/touchscreen-1wire  
& `6 V0 a* }# \" a#export TSLIB_TSDEVICE=/dev/input/event2  
  
################  the below lines are optional ##############  
5 u; Z* C8 v; _# t, q#export TSLIB_FBDEVICE=/dev/fb0  
#export TSLIB_CONSOLEDEVICE=none  

9 P0 U9 e9 [! X此外还要修改 ts.conf文件：
[html] view plain copy
, l: T8 @7 S+ O6 I  i#module_raw one_wire_ts_input  
% a* [) G4 I6 Omodule_raw friendlyarm-ts-mtinput #使用友善提供的电容屏TSLIB插件。需要先将friendlyarm-ts-mtinput.so拷贝到TSLIB_PLUGINDIR目录中  
* k% X5 F: q1 K! k+ _: z  
( Z+ o2 C  M$ p+ ]module pthres pmin=1  
module variance delta=30  
, c% r4 e5 s. N1 [# M3 Smodule dejitter delta=100  
module linear  
6 `, Q- t7 ~  h: S. M# S到此为止 tslib 就基本能用了，首次使用时应先运行 ts_calibrate 进行触摸屏校准。我用的这个版本的tslib自带的ts_calibrate程序不太好用，所以我依然使用友善提供的ts_calibrate进行校准。
有了tslib后，进入Qt源码目录中的 "qtbase/src/plugins/generic/tslib/"，运行 qmake 生成 Makefile，并在Makefile中将tslib的头文件和库文件路径添加到编译链接选项中（-I /...tslib/include  -L/.../tslib/lib）；然后运行 make 和 make install即可。这时，Qt5安装目录的 "plugins/generic/"目录下就出现"libqtslibplugin.so"这个库文件了。

( d" J7 j4 _4 b0 L9 r1 w3 {- r$ {4   运行Qt程序
需要说明的是，Qt5.0开始，Qt自身不再单独实现窗口系统，QWS不复存在，取而代之的新机制是QPA（Qt平台抽象），QPA使得Qt对不同平台的支持变得更加灵活，当需要支持一个新平台时，只需为该平台编写一个QPA插件。
' l1 y+ @$ t# Q: Y1 c
/ C0 T, `  D6 s- l& AWith the release of Qt 5.0, Qt no longer contains its own window system implementation: QWS is no longer a supported platform. For single-process use cases, theQt Platform Abstraction is a superior solution......参考 http://qt-project.org/doc/qt-5/embedded-linux.html

% D$ R9 c9 Q6 }# c" a% B$ k! j9 k编译完Qt后，只需将生成的lib和plugins文件夹拷贝到开发板，另外，当在嵌入式Linux平台上运行应用程序前，应根据自己平台的实际情况提前设置好下面几个环境变量：
2 K4 g& Q8 l; p, q% D- N% J0 z  |; E* Y
' C( t+ R, P  C2 R[html] view plain copy
/ U1 P6 `$ r! M3 J" @export QT_QPA_PLATFORM_PLUGIN_PATH=/opt/Qt-5.3.2/armv7-a/plugins/platforms  
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0  
export QT_QPA_FONTDIR=/opt/Qt-5.3.2/armv7-a/lib/fonts  
export QT_QPA_GENERIC_PLUGINS=tslib:/dev/touchscreen-1wire  #使用tslib插件  
8 I) z( U+ Z& f5 {
然后就可以运行Qt程序了
$ a. A$ t- e9 G4 n
6 m3 b7 N9 ?3 l+ v: }2 q' i以前Qt4的程序在嵌入式Linux平台运行时，需要在命令行输入-qws选项以启动Qt窗口系统服务，如" ./HelloWorld -qws"；而使用Qt5后，不再需要-qws，而需要通过-platform来指定要使用的QPA插件，如" ./HelloWorld -platform linuxfb"，如果不指定，则用默认的QPA插件，默认的QPA插件通过上面的QT_QPA_PLATFORM变量指定。

附： 在Ubuntu 14.04上编译Qt ---（请注意，本小节编译的是PC版Qt，不是ARM版，ARM版Qt的编译过程请参考本文第2节）
0 d$ B) I! z0 `2 g# E+ j3 W' a在Ubuntu 14.04上编译Qt就简单多了，缺少的组件可以很容易下载到。

0 G7 R# y5 t! `) W) i) i首先安装opengl支持（mesa3d），
) _8 q, r  M% P# F, \; I$ Y+ v3 z
9 a" P6 G+ _  S: R3 x: P[html] view plain copy
: T4 n( ?: _; c6 Esudo apt-get install mesa-common-dev  libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev  
& x4 u* d, U2 Y如果需要，再安装Qt D-Bus的支持。
4 n0 l/ |/ ]. O: z6 ~
然后configure，configure过程中可能出现一些错误，基本都是缺少某个库引起的，配置过程中根据错误提示，用apt-get install或Ubuntu Software Center搜索安装缺少的组件。
: Z0 C7 q0 G, J1 @: \; q1 k( V
[html] view plain copy
./configure -release -opensource -prefix /opt/Qt-5.3.2/x86 -no-c++11 -qreal float -opengl  
配置结果为：
: [8 l0 c5 V  L7 h5 K
& c0 V9 l8 N% j* M% f[html] view plain copy
   Configure summary  
  
Build type:    linux-g++ (i386, CPU features:)  
Platform notes:  
6 T' z$ {3 \: j  
            - Also available for Linux: linux-kcc linux-icc linux-cxx  
         
3 y* v; W8 D& ~$ S7 V7 z- \Build options:  
  Configuration .......... accessibility accessibility-atspi-bridge audio-backend avx avx2 clock-gettime clock-monotonic compile_examples concurrent dbus evdev eventfd fontconfig full-config getaddrinfo getifaddrs glib iconv inotify ipv6ifname large-config largefile libudev linuxfb medium-config minimal-config mremap nis no-harfbuzz opengl pcre png posix_fallocate precompile_header qpa qpa reduce_exports reduce_relocations release rpath shared small-config sse2 sse3 sse4_1 sse4_2 ssse3 system-freetype system-jpeg system-png system-zlib xcb xcb-glx xcb-plugin xcb-render xcb-sm xcb-xlib xinput2 xkbcommon-qt xlib xrender   
  Build parts ............ libs tools examples  
/ z) j5 V/ d# R% {9 f0 Q0 V3 q  Mode ................... release  
  Using C++11 ............ no  
  Using PCH .............. yes  
  Target compiler supports:  
' g. o' F* Y. S& u    SSE2/SSE3/SSSE3 ...... yes/yes/yes  
    SSE4.1/SSE4.2 ........ yes/yes  
    AVX/AVX2 ............. yes/yes  
  
Qt modules and options:  
- _. x) I1 W8 j# J  Qt D-Bus ............... yes (loading dbus-1 at runtime)  
  Qt Concurrent .......... yes  
8 v4 ]8 f: c# Q; `, m. A3 u8 S  Qt GUI ................. yes  
  E) r: j0 P5 [( k* r  Qt Widgets ............. yes  
$ y+ j0 M1 j! T/ {5 K) N0 F  Large File ............. yes  
  QML debugging .......... yes  
7 r& f+ r1 J$ ]6 \  Use system proxies ..... no  
" J4 E9 y) }+ _6 v, t& h  
Support enabled for:  
" }9 L: y& H5 q4 j  M6 m  Accessibility .......... yes  
  ALSA ................... no  
  CUPS ................... no  
  Evdev .................. yes  
  FontConfig ............. yes  
  Q: s- c- p! s, R8 O+ m8 d6 _# f, B  FreeType ............... yes (system library)  
8 q7 b+ K6 M9 H  Glib ................... yes  
  GTK theme .............. no  
  HarfBuzz ............... no  
# d9 K' T* c7 o5 [5 f# D( F  Iconv .................. yes  
( [" B' }5 m# [% @- u0 W  ICU .................... no  
6 h3 P  P2 M2 ?$ H  Image formats:   
    GIF .................. yes (plugin, using bundled copy)  
    JPEG ................. yes (plugin, using system library)  
    PNG .................. yes (in QtGui, using system library)  
9 e0 Q" F) p, }" P3 ?  journald ............... no  
  mtdev .................. no  
  Networking:   
) F" k1 r; @8 |! X# w6 i    getaddrinfo .......... yes  
    getifaddrs ........... yes  
    IPv6 ifname .......... yes  
    OpenSSL .............. no  
  NIS .................... yes  
  OpenGL / OpenVG:   
* L- Q( n7 H1 z8 j    EGL .................. no  
& C" H+ ?' c$ E/ A" `/ w    OpenGL ............... desktop  
, d) O6 L9 t' c/ X" d, p: ~& ^. C    OpenVG ............... no  
  PCRE ................... yes (bundled copy)  
" H% j0 G7 o- V+ g& o8 A+ \( P7 C9 U  pkg-config ............. yes   
; d: X2 g; M/ }9 E6 P  PulseAudio ............. no  
  QPA backends:   
    DirectFB ............. no  
    EGLFS ................ no  
    KMS .................. no  
+ L' K8 h9 K4 M3 J  A5 |    LinuxFB .............. yes  
" c9 k1 X  [: j6 x    XCB .................. yes (system library)  
      EGL on X ........... no  
      GLX ................ yes  
      MIT-SHM ............ yes  
: E! N; ?$ S" v* H      Xcb-Xlib ........... yes  
      Xcursor ............ yes (loaded at runtime)  
      Xfixes ............. yes (loaded at runtime)  
      Xi ................. no  
      Xi2 ................ yes  
# N3 p/ i! g& J2 R! b      Xinerama ........... yes (loaded at runtime)  
      Xrandr ............. yes (loaded at runtime)  
      Xrender ............ yes  
      XKB ................ no  
      XShape ............. yes  
# ~9 H& U# I+ r5 L8 c$ q1 M0 L5 j      XSync .............. yes  
      XVideo ............. yes  
& y2 l8 }( n0 ?# D: ]" R1 u: x5 _" @  Session management ..... yes  
  SQL drivers:   
    DB2 .................. no  
    InterBase ............ no  
& |' V3 g4 n' C" j% |8 X6 [) h    MySQL ................ no  
    OCI .................. no  
. l& y* ]" n  d8 K. J- A# U7 i    ODBC ................. no  
+ c% h* m0 I2 @' ?4 K8 _1 b    PostgreSQL ........... no  
    SQLite 2 ............. no  
    SQLite ............... yes (plugin, using bundled copy)  
    TDS .................. no  
' S/ o; j( T. {( x  udev ................... yes  
% Z' k7 E6 L6 O) [& s9 j/ G9 g  xkbcommon .............. yes (bundled copy, XKB config root: /usr/share/X11/xkb)  
  zlib ................... yes (system library)  
  
NOTE: libxkbcommon and libxkbcommon-x11 0.4.1 or higher not found on the system, will use   
; h! e* `. x8 \2 h# l' g5 hthe bundled version from 3rd party directory.  
  C! W5 A  W- w  @
$ z& W: \9 B/ A' W1 u最后make和make install即可。
& y9 `7 b- Q" v: x
4 s* l7 t* n% `$ l
& p3 X# m/ z# {* F3 Q另外，编译完Qt5.3.2后，发现Qt assistant打开之后内容是空的，查询不到任何东西。需要打开assistant，点击Edit->preference菜单，选择Documents选项卡，点击add向assistant添加文档，文档类型为 *.qch 。但Qt5中似乎文档并不是现成的，需要在编译完Qt后再去编译他的文档。步骤为：

3 i$ l8 e% {4 c; b, d+ F: N进入已经编译过的Qt源码顶层目录，输入
[html] view plain copy
$ make docs  
* r% `& }# F9 e这条指令会生成Qt各个模块的文档，但这些文档分散于不同的子源码目录中，最好将他们集中拷贝出来放到Qt的安装目录中，我的做法如下，当执行完make docs后，在源码顶层目录输入：(/opt/Qt-5.3.2是我的安装目录)
[html] view plain copy
; h- E/ g! H# D  y. r+ n- q$ sudo mkdir /opt/Qt-5.3.2/docs_for_assistant  
$ sudo cp `find ./ -name *.qch` /opt/Qt-5.3.2/docs_for_assistant  
然后打开assistant，将 /opt/Qt-5.3.2/docs_for_assistant 目录中的*.qch文件全部add进去。