开篇－QT完全手册

嵌入式工具Qt的安装与使用

摘要
　　Qt是Trolltech公司的一个产品。Trolltech是挪威的一家软件公司，主要开 发两种产品：一种是跨平台应用程序界面框架；另外一种就是提供给做嵌入式Linux开发的应用程序平台，能够应用到PDA和各种移动设备上。Qt和 Qtopia分别是其中具有代表性的两个。(2004-05-05 10:52:14)

--------------------------------------------------------------------------------
By lanf, 出处：http://tech.ccidnet.com/pub/article/c310_a71173_p1.html

作者：胡利民 本文选自：开放系统世界

　 　Qt是Trolltech公司的一个产品。Trolltech是挪威的一家软件公司，主要开发两种产品：一种是跨平台应用程序界面框架；另外一种就是提 供给做嵌入式Linux开发的应用程序平台，能够应用到PDA和各种移动设备上。Qt和Qtopia分别是其中具有代表性的两个。 

Qt是一个多平台的C++图形用户界面应用程序框架，它能给用户提供精美的图形用户界面所需要的所有元素，而且它是基于一种面向对象的思想，所以用户对其对象的扩展是相当容易的，并且它还支持真正的组件编程。 

Qt是Linux桌面环境KDE的基础。笔者认为，可以说Qt与Windows下的Mfc的实质是一样的，所以Qt最大的优点在于其跨平台性，可以支持现有的多种操作系统平台，主要有： 

◆ MS/Windows 95、Windows 98、WindowsNT 4.0、Windows 2000、Windows XP； 

◆ Unix/X11 Linux、Sun Solaris、HP-UX、Compaq True64Unix、IBM AIX、SGI IRIX和很多其它X11平台； 

◆ Macintoshi Mac OSX； 

◆ Embedded—带FramBuffer的Linux平台。 

下面简单介绍一下Qt/Embedded和Qtopia在Linux上的安装和使用，还有在开发过程中可能碰到的一些问题。 

Qt 和Qtopia的安装

如果需要安装一个带FramBuffer的Qtopia平台，需要有以下软件（所列举软件以笔者使用的为例）： 

◆ Qtopia 1.6.0； 

◆ Tmake 1.11； 

◆ Qt/Embedded 2.3.4（Qtopia 1.6.0是基于该开发平台上开发的）； 

◆ Qt/Embedded 2.3.2 for X11； 

◆ Qt 3.1.2 for X11。 

在Trolltech公司的网站上可以下载该公司所提供的Qt/Embedded的免费版本。 

Qtopia平台安装分为以下几个步骤： 

1. 解包Qtopia 

在Linux命令模式下运行以下命令： 

tar xfz qtopia-source-1.6.0 （解包）
cd qtopia-source-1.6.0
export QPEDIR=$PWD （设置环境变量）
cd..



2. 安装Tmake 

在Linux命令模式下运行以下命令：

tar xfz tmake-1.11.tar.gz
export TMAKEDIR=$PWD/tmake-1.11
export TMAKEPATH=$TMAKEDIR/lib/qws/linux-x86-g++
export PATH=$TMAKEDIR/bin:$PATH




3. 安装Qt/Embedded2.3.4 

在Linux命令模式下运行以下命令：


tar xfz qt-embedded-2.3.4-commercial.tar.gz
cd qt-2.3.4
export QTDIR=$PWD
export QTEDIR=$QTDIR
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
cp $QPEDIR/src/qt/qconfig-qpe.h src/tools/
. /configure -qconfig qpe -qvfb -depths 4,8,16,32
make sub-src
cd ..




也可以在configure的参数中添加－system－jpeg和gif，使Qtopia平台能支持jpeg、gif格式的图形。 

4. 安装Qt/X11 2.3.2 

在Linux命令模式下运行以下命令：


tar xfz qt-x11-2.3.2-commercial.tar.gz
cd qt-2.3.2
export QTDIR=$PWD
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
. /configure -no-opengl
make
make -C tools/qvfb
mv tools/qvfb/qvfb bin
cp bin/uic $QTEDIR/bin
cd ..




根据开发者本身的开发环境，也可以在configure的参数中添加别的参数，比如-no-opengl或-no-xfs，可以键入./configure -help来获得一些帮助信息。 

5. 安装Qt/X11 3.1.2 

在Linux命令模式下运行以下命令： 


tar xfz qt-x11-commercial-3.1.x.tar.gz
cd qt-x11-commercial-3.1.x
export QTDIR=$PWD
export QT3DIR=$QTDIR
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
./configure -thread
make
cd ..




6. 安装Qtopia 

在Linux命令模式下运行以下命令： 


cd qtopia-source-1.6.x
export QTDIR=$QTEDIR
export QPEDIR=$PWD
export PATH=$QPEDIR/bin:$PATH
cd src
./configure
make
cd ../..




7. 安装Qtopia桌面 


cd qtopia-source-1.6.x/src
export QTDIR=$QT3DIR
./configure -qtopiadesktop
make
mv qtopiadesktop/bin/qtopiadesktop ../bin
cd ..





Qt和Qt Designer的使用 

根据上面的步骤安装完成了Qt/Embedded和Qtopia之后，就可以运行这些程序了。 

运行Qt的虚拟仿真窗口：在Linux的图形模式下运行命令qvfb&；Qtopia只是一个用Qt/Embedded开发的程序，运行Qtopia，在图形模式下运行命令： 


export QTDIR=$QTEDIR,
qpe &；




这样Qtopia的程序就运行在QVFB上，即Qt的虚拟仿真窗口。 

Qt/Embedded是针对嵌入式Linux而开发的一种开发工具，Qt封装了一些常用的类，而且这些类的名字都以Q字开头命名，如QString、QDialog等。这里主要介绍一下如何利用Qt Designer来设计组件，并生成相应的代码。 

在Qt中，把组件分为复合体、原始体和配件。而在Qt中，组件是由一些抽象类、复杂的组件类、管理组件几何特性的类等组成。 

Qt中有三个主要的基类：QObject、Qapplication和QWidget。 

在Qt 中编程，利用Signal和Slot进行对象之间的通信是Qt的主要特征。它与Windows中的消息机制非常类似，但是Signal和Slot机制真正 实现了一种消息的封装。当对象的状态改变时，发出Signal，通知所有的Slot接受Signal，尽管它不知道哪些函数是Slot，Slot一开始也 不知道哪些Signal可以接收。Signal和Slot之间不是一一对应的关系，一个Signal可以发给多个Slot， Slot也可以接收多个Signal。Slot除了可以接收Signal以外，与其它的成员函数没有区别。这种机制比使用回调函数要灵活，但是会减慢程序 的运行速度。不过在现在高速CPU的面前，这种损失是无足轻重的，而且它还能保证程序的简明性和灵活性，非常便利。 

在Qt的组件中，不仅定义了常用的成员变量和成员函数，还定义了所有与该组件相关的Signal和Slot。 

要将组件组合起来，最简单的方法就是使用Qt Designer。首先要启动Qt Designer，在Linux命令模式下，键入以下命令(假设Qt安装在/usr/local下)： 


cd qt-2.3.2/bin
./designer




这样就可以启动一个与Windows下的Delphi相类似的如图1的界面。 


然 后新建一个QFrame，将自己需要的组件直接拖拉到这个Frame中，相信很多人都有过这样的经历，此处就不再详细描述了。完成之后存盘时，会将这个新 的组件保存为一个扩展名为.ui的文件。假设所存的文件名为test.ui，用vi test.ui来查看这个文件，发现这是一个用xml语言写的一个文本。下面用这个test.ui生成相应的test.h和test.cpp。同样还是在 这个目录下，可以看到一个uic的工具，这个是Qt专门用来将ui文件生成.h和.cpp文件的，在终端模式下键入以下命令： 


./uic -o test.h test.ui
./uic -o test.h -i test.cpp test.ui





此 时就能看到生成了相应test.h和test.cpp，这是一个类。当然这只是一些表面的东西，还需要在这些代码中添加相应的Signal和Slot，完 成所需要的操作。值得注意的是，相应版本生成的ui最好用相应版本的uic来生成代码。如果用Qt 3.1.2的Designer生成的ui，用Qt 2.3.2的uic来生成代码，生成的代码都会是一些空函数。 

在一般的开发过程中，首先通过这个ui生成的一个类，在Qt中通常叫做 Base，如上面的例子，叫做testBase；然后再新建一个类，来继承这个Base。通常叫做实现类Impl，如testImpl。在这个实现类里面 定义所需要的成员函数、Signal和Slot，因为ui可能是经常需要改动的。如果这样做，每次只需要在Designer中修改ui，而不用去理会这些 成员函数、Signal和Slot了。 

编译一个Qt程序必然需要Makefile，在Qt中提供了一个专门生成Makefile的工具，就是tmake。用tmake需要根据编写的程序写一个.pro文件。.pro文件非常简单，有固定的格式，下面是一个例子： 


TEMPLATE = app
CONFIG = qtopia warn_on release
MOC_DIR =tmp
OBJECTS_DIR =tmp
HEADERS =fcrs.h\ 
structs.h globalfunc.h globalvars.h \ 
testimpl.h
SOURCES = main.cpp globalfunc.cppglobalvars.cpp \ 
testimpl.cpp
INTERFACES = test.ui TARGET = fcrs




生成这个.pro文件之后，在终端中键入下面的命令： 


tmake -o Makefile test.pro




就自动生成了一个Makefile，使用这个Makefile编译所编写的程序就可以了。



Qt/Embedded开发环境建立的过程 

--------------------------------------------------------------------------------


Qt/Embedded开发环境建立的过程：
（这些软件可以免费从trolltech的WEB或FTP服务器上下载）
◆ tmake 1.11 或更高版本； （生成Qt/Embedded应用工程的Makefile文件）
◆ Qt/Embedded 2.3.7 （Qt/Embedded 安装包）
◆ Qt 2.3.2 for X11； （Qt的X11版的安装包, 它将产生x11开发环境所需要的两个工具）
1、安装tmake
在Linux 命令模式下运行以下命令：
tar xfz tmake-1.11.tar.gz
export TMAKEDIR=$PWD/tmake-1.11
export TMAKEPATH=$TMAKEDIR/lib/qws/linux-x86-g++
export PATH=$TMAKEDIR/bin:$PATH
2. 安装Qt/Embedded 2.3.7
在Linux 命令模式下运行以下命令：
tar xfz qt-embedded-2.3.7.tar.gz
cd qt-2.3.7
export QTDIR=$PWD
export QTEDIR=$QTDIR
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
./configure -qconfig -qvfb -depths 4,8,16,32
make sub-src
cd ..
上述命令 ./configure -qconfig -qvfb -depths 4,8,16,32 指定Qt 嵌入式开发包生
成虚拟缓冲帧工具qvfb，并支持4，8，16，32 位的显示颜色深度。另外我们也可以在
configure 的参数中添加－system－jpeg 和gif，使Qt/Embedded 平台能支持jpeg、gif
格式的图形。
上述命令 make sub-src 指定按精简方式编译开发包，也就是说有些Qt 类未被编
译。Qt 嵌入式开发包有5 种编译范围的选项，使用这些选项，可控制Qt 生成的库文件的大
小，但是您的应用所使用到的一些Qt 类将可能因此在Qt 的库中找不到链接。编译选项的具
体用法可运行./configure －help 命令查看。
3. 安装Qt/X11 2.3.2
在Linux 命令模式下运行以下命令：
tar xfz qt-x11-2.3.2.tar.gz
cd qt-2.3.2
export QTDIR=$PWD
export PATH=$QTDIR/bin:$PATH
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
./configure -no-opengl
make
make -C tools/qvfb
mv tools/qvfb/qvfb bin
cp bin/uic $QTEDIR/bin
cd ..
根据开发者本身的开发环境，也可以在configure 的参数中添加别的参数，比如
-no-opengl 或-no-xfs，可以键入./configure -help 来获得一些帮助信息。
如果Qt/Embedded 的应用是在UNIX 平台下开发的话，那么它就可以在开发的机器
上以一个独立的控制台或者虚拟缓冲帧的方式来运行，对于后者来说，其实是有一个X11
的应用程序虚拟了一个缓冲帧。通过指定显示设备的宽度，高度和颜色深度，虚拟出来
的缓冲帧将和物理的显示设备在每个像素上保持一致。这样每次调试应用时开发人员就
不用总是刷新嵌入式设备的FLASH 存储空间，从而加速了应用的编译、链接和运行周期。
运行Qt 的虚拟缓冲帧工具的方法是：在Linux 的图形模式下运行命令：
qvfb (回车)
当Qt 嵌入式的应用程序要把显示结果输出到虚拟缓冲帧时，我们在命令行运行这
个程序时，在程序名后加上-qws 的选项。例如： $> hello -qws 


一，QT/E的安装。
在本机中安装了包括QT4.0.1（WINDOWS版本）以及QT/E2。3。7（LINUX版本）。
QT/E我安装在我的虚拟机中。因为QT/E2.3.7的版本问题，其适宜在REDHAT9。0版本（或更低版本）下安装，否则安装不成功。
QT/E安装过程复杂，具体细节可以参考下面这篇文章。《Qt/Embedded开发环境建立的过程》
此文在网上可搜索到。

本机下虚拟机中QT/E安装路径为：/home/wangxl/QTE/qt-2.3.7
QT/X11安装路径为：/home/wangxl/QTE/qt-2.3.2
Tmake安装路径为：/home/wangxl/QTE/Tmake-1.8

QT/E下载地址为：ftp://ftp.rediris.es/mirror/Qt/source/
Tmake下载地址为：ftp://ftp.trolltech.com/freebies/tmake/

二．QT与QT/E以及QT3与QT4之间的区别
相对来说QT与QT/E的语法一样，所不同之处在库类大小或者库类函数大小不同而已。QT/E相对于QT来说，不具有少数类或者少数函数的支持。具体QT/E是否包含某个类或者包含某个类中的函数，我的方法是在QT/E安装目录下的include文件夹中去查找。
QT3和QT4有很多不同点，主要不同也是在于库类以及支持函数有所变化，比如，有些QT3中的函数，在QT4中被其他函数名所代替，因此很多QT4程序在QT3环境下无法执行。QT/E2.3.7与QT3基本相同，除了我前面提到的QT与QT/E的差别。

三．QT/E编译与执行。
1．在QT/E编译与执行前要先设置TMAKE与QT/E LIB环境，具体方法如下：
[root@localhost tmake-1.8]# export TMAKEDIR=$PWD
[root@localhost tmake-1.8]# export TMAKEPATH=$TMAKEDIR/lib/qws/linux-x86-g++
[root@localhost tmake-1.8]# export PATH=$TMAKEDIR/bin:$PATH
[root@localhost qt-2.3.7]# export QTDIR=$PWD
[root@localhost qt-2.3.7]#export QTEDIR=$QTDIR
[root@localhost qt-2.3.7]#export PATH=$QTDIR/bin:$PATH
[root@localhost qt-2.3.7]#export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

2．如果你是用DESIGNER工具设计的界面（后面有讲），则要将*.ui文件转换成*.h文件和*.cpp文件。转换方法如下： 
uic –o test.h test.ui
uic –o test.cpp –i test.h test.ui

3．编写一个*.pro文件（用来生成Makefile文件用），该文件格式比较固定。
如test.pro文件基本格式如下（以test.cpp ,test.h main.cpp为例子）：
EMPLATE = app
CONFIG += qt warn_on release
HEADERS = test.h
SOURCES = test.cpp main.cpp
TARGET = hello
DEPENDPATH=/home/wangxl/QTE/qt-2.3.7/include
REQUIRES=

4．生成Makefile文件
方法为：tmake –o Makefile test.pro
5 编译生成可执行文件
make

6 打开QVFB
进入安装QT/X11所在目录， 在BIN目录下执行程序qvfb。
有时候需要修改qvfb执行时的deptb参数才能够执行QT/E程序。可以直接在QVFB打开窗口的Configure彩单项中选择，也可以用如下命令执行QVFB。
./qvfb –width ** -height ** -depth **
7.执行QT/E程序
如 。/TEST 
在QVFB程序打开的窗口中将出现TEST程序的显示 。

四．Qt/e与QT/X11
安装QT/E的同时还需要安装QT/X11与Tmake,Tmake 是用来帮助生成Makefile文件的。安装QT/X11主要是向QT/E提供designer工具和qvfb工具的。
Designer可以用来设计图形界面，最后生成.ui文件，可通过UIC命令转换为相应的C++文件。
QVFB模拟帧缓冲，提供QT/E程序的显示平台。

五．QT/E 程序ARM 板上执行
在我虚拟机上可以执行的QT/E程序不能在ARM板上执行，需要对QT/E进行重新编译，并需要设置响对于ARM板系统的编译环境，具体方法可以参考我另外的一文《QT/E开发记录》

六．QT/E支持中文显示问题
QT/E需要字体转换才能显示中文。具体方法可以参考我另外的一文《QT/E开发记录》
但是由于缺少UNICODE的QPF文件的字体，中文字大小不均匀问题尚没解决。

七 QT/E的一些参考资料：
http://www.qtcn.org/bbs/index.php QT中文论坛
http://www.qiliang.net/qt/ （关于QT3的类，以及类函数可以在这寻找）
提供QT3编程最好书籍的电子版本《C++ GUI Programming with QT 3》(本机)
关于QT4可以参考QT ASSISTNAT（本机中），另外QT ASSISTNAT中也可以查找QT3的类及库等。



设置Qtopia的build环境
1、环境变量
在目标系统上build Qtopia必须设定必要的环境变量，如QTDIR， 如果依赖多个版本的Qt，则需要用环境变量指向用到的库配置。
一种方法是将环境变量的设定写入文件，通过运行source命令应用文件的内容。

举例说明：
Linux/bash下建立环境变量设定文件qtopia.sh， 内容如下：
export QPEDIR=/opt/Qtopia
export QTDIR=/opt/Qtopia
export PATH=$QTDIR/bin:$PATH
export TMAKEPATH=/opt/Qtopia/tmake/lib/qws/linux-generic-g++
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

需要时运行 source qtopia.sh即可应用以上环境变量。

另外也可以通过在.bashrc文件中设定别名来应用这些环境变量。 假设环境变量设置文件存放在home目录的bin下， 则可在.bashrc中加入：
alias qtopia=‘source ~/bin/qtopia.sh‘

2、创建自定义的配置文件

整个Qtopia系统在build过程中需要三个独立的配置系统：
1) Qt/Embedded 配置文件
2) tmake - 用于build Qtopia 1.x和一些第三方软件
3) qmake - 用于build Qtopia 2及以上版本

在build Qtopia以前，先要完成以上三项的配置。

下面是创建一个“myarm”配置的例子：
cp -r $TMAKEDIR/lib/qws/linux-arm-g++ $TMAKEDIR/lib/qws/linux-myarm-g++
cp -r $QTEDIR/configs/linux-arm-g++-shared $QTEDIR/configs/linux-myarm-g++-shared
cp -r $QPEDIR/mkspecs/qws/linux-arm-g++ $QPEDIR/mkspecs/qws/linux-myarm-g++
Qt/Embedded
编辑$QTEDIR/configs/linux-myarm-g++-shared， 修改其中的utilities和flags成适合系统的内容， 如： 
可能需要修改SYSCONF_CXX, SYSCONF_CC 和SYSCONF_LINK， 指定正确的编译器. 可能需要增加编译选项-DMYARM，在代码中增加宏#ifdef MYARM（用以增加设备相关的代码）
tmake
编辑$TMAKEDIR/lib/qws/linux-myarm-g++/tmake.conf，修改用到的utilites和flags： 
可能需要修改TMAKE_CC, TMAKE_CXX 和TMAKE_LINK
可能需要增加-DMYARM选项
qmake

修改$QPEDIR/mkspecs/qws/linux-myarm-g++/qmake.conf： 

QMAKE_CC, QMAKE_CXX 和QMAKE_LINK 
-DMYARM
注意：qmake.conf的最后一行必须是：
exists($$(QPEDIR)/src/config.pri):include($$(QPEDIR)/src/config.pri)


可用于目录名的字符

正则表达式字符

Qtopia 1.9.x和Qtopia 2.0.0 - 2.1.0对字符有以下的要求：

Qtopia build系统访问到的任何目录都不能包含正则表达式字符
任何能被QRegExp识别的特殊字符和字符序列都可能引起问题
‘.‘字符只匹配自身
不要将正则表达式字符用于目录名，包括（但不仅限于）: + . ? * \ () [] ^ $ {} 
注：Qtopia 2.1.0和2.1.1及以上版本可以通过应用patch解除以上的限制

空格

Qtopia build系统不支持目录名中包含空格。

必须保证：

build系统访问到的目录不包含空格
访问目录的各层上级目录也不包含空格

Qtopia的依赖和必要条件

简介
为了使Qtopia正确运行， 必须满足以下的必要条件：
安装适当的编译/交叉编译工具
Qt/Embedded-2.3.11
Linux kernel提供共享内存、mmap和socket支持
Linux支持frame buffer
Linux支持OSS声音或支持与OSS兼容的ALSA声音。 进一步的信息参考 The Qtopia A/V & Appearance FAQ 
还需要以下的库：

Video4Linux
zlib
libuuid(aka luuid)
libjpeg
xorg 或X11
注：Freetype不是必须的但建议支持 http://freetype.sourceforge.net/index2.html 


支持的编译器和交叉编译器 

gcc-2.95.2 
gcc 3.2.4 
gcc-3.3.0, gcc-3.3.3, gcc-3.3.4 
gcc-3.4.1 


声音

Qtopia需要/dev/dsp可写，并支持以下的ioctl操作：


SNDCTL_DSP_SETFRAGMENT - Qtopia将这个值设置为0x4000c. 
SNDCTL_DSP_SETFM - Qtopia设置为AFMT_S16_LE 
SNDCTL_DSP_STEREO - Qtopia 设置为 1/true. 
SNDCTL_DSP_SPEED - Qtopia设置为44100. 
SNDCTL_DSP_GETOSPACE 
Qtopia 还需要/dev/dsp可以以阻塞方式和非阻塞方式打开。 以上的设定是Qtopia需要的设定，但可以容许少许的偏差，但如果不设定成Qtopia需要的值则不能保证音频能平滑播放。 假如您的设备只支持22500的播放速率，则在调用SNDCTL_DSP_SPEED时要报告此速率，以免造成音频质量的缺损。 不过，如果系统不支持GETOSPACE，非阻塞写入或 SNDCTL_DSP_SET_FRAGMENT， 几乎可以肯定必然会损失音频质量。


Video4Linux

Camera应用程序需要支持Video4Linux v1的内核， Qtopia没有提供该支持。

请参考官方的 Video for Linux 资源站点，参看API的详细内容。


zlib

zlib可以从 http://www.gzip.org/zlib/ 下载


libuuid(aka luuid)

Qtopia不提供uuid支持。 这个库可以从 http://e2fsprogs.sourceforge.net/ 站点下载

另外， 如果你有SuSE Linux的发行版， e2fsprogs-devel这个包可以提供uuid支持； 在Debian中对应的包是uuid-dev. 这个库应该放在标准路经下/usr/lib/libuuid.so


请用包管理工具来查看该包是否已经安装：

rpm -qa | grep e2fsprogs

如果尚未安装，请从安装盘或镜像站安装这个包。

需要注意的是，如果没有安装e2fsprogs-devel，在链接时会发生下面的错误：

/usr/lib/gcc-lib/i586-suse-Linux/3.3.3/../../../../i586-suse-linux/bin/ld:
cannot find -luuid
如果安装了该库仍遇到上述错误，则检查Qtopia的configure脚本的-L和-R参数， 以确定脚本包含了库的实际路径。 关于交叉编译的信息可参考 System Integrator‘s Guide. 


libjpeg

Qtopia不提供jpeg库。 Qtopia需要Qt/Embedded配置为支持jpeg。

libjpeg库可从 http://www.ijg.org/ 下载

此外，如果你有SuSE发行版， libjpeg这个包可提供该库。 这个库应该安装在标准路经/usr/lib/libjpeg.so

检查libjpeg包是否已经安装：

rpm -qa | grep libjpeg

如果未安装，请从安装盘或镜像站安装。

关于libjpeg交叉编译的信息， 可参考System Integrator‘s Guide. 


xorg或X11

开发包括有从以下站点下载： 

http://www.xfree86.org/ 
http://xorg.freedesktop.org 
相关讨论

决定开始Qtopia需要的步骤， 参考： Getting started 

将Qtopia集成到特定设备上的重点步骤， 参考： System Integrator‘s guide 

Qtopia的FAQs，参看： Qtopia index page 


系统是完全安装RedHat9.0（里面带QT3.1），板子是X-Hyper250B的，Toolchain用的是开发板带的hybus-arm-linux-R1.1 

交叉编译所用到的文件： 
qt-embedded-2.3.10-free.tar.gz 
qt-x11-2.3.2.tar.gz 
qtopia-free-source-2.1.1.tar.gz 
tmake-1.13.tar.gz 
e2fsprogs-1.35.tar.gz 

主机x86的编译步骤： 
tar xfz qt-embedded-2.3.10-free.tar.gz(解压后qt-2.3.10改名为qt-2.3.10-host) 
export QTEDIR=$PWD/qt-2.3.10-host 
tar xfz qt-x11-2.3.2.tar.gz(解压后qt-2.3.2) 
export QT2DIR=$PWD/qt-2.3.2 
tar xfz qtopia-free-source-2.1.1.tar.gz(解压后qtopia-free-2.1.1改名为qtopia-2.1.1-host) 
export QPEDIR=$PWD/qtopia-2.1.1-host 
tar xfz tmake-1.13.tar.gz(解压后tmake-1.13) 
export TMAKEDIR=$PWD/tmake-1.13 
export TMAKEPATH=$PWD/tmake-1.13/lib/qws/linux-x86-g++ 
export PATH=$TMAKEDIR/bin:$PATH 

cd qt-2.3.2 
export QTDIR=$QT2DIR 
export PATH=$QTDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
./configure -no-xft 
make 
make -C tools/qvfb 
cd .. 

cd qt-2.3.10-host 
export QTDIR=$PWD 
export PATH=$QTDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
mkdir bin (因为解压后的qt-2.3.10没有bin文件夹) 
cp $QT2DIR/bin/uic bin 
cp $QT2DIR/tools/qvfb/qvfb bin 
cp $QPEDIR/src/qt/qconfig-qpe.h src/tools/ 
./configure -qconfig qpe -qvfb -thread -system-jpeg -gif -depths 4,8,16,32 
make 
cd .. 

tar xzf e2fsprogs-1.35.tar.gz 
cd e2fsprogs-1.35 
./configure -enable-elf-shlibs 
make install lib/uuid/ 
注：这是编译x86的libuuid库 
cd .. 

cd qtopia-2.1.1-host 
export PATH=$QPEDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QPEDIR/lib:$LD_LIBRARY_PATH 
./configure 
make 

编译例子： 
$qmake -project ==>>我都是这样创建.pro文件的 
$tmake -o Makefile hello.pro 
$make 
$qvfb & 
$./hello -qws 或者$qpe 
还没怎么仔细研究过。 


目标机arm-linux的编译步骤： 
tar xfz qt-embedded-2.3.10-free.tar.gz(解压后qt-2.3.10改名为qt-2.3.10-target) 
export QTEDIR=$PWD/qt-2.3.10-target 
tar xfz qt-x11-2.3.2.tar.gz 
export QT2DIR=$PWD/qt-2.3.2 
tar xfz qtopia-free-source-2.1.1.tar.gz(解压后qtopia-free-2.1.1改名为qtopia-2.1.1-target) 
export QPEDIR=$PWD/qtopia-2.1.1-target 
tar xfz tmake-1.13.tar.gz 
export TMAKEDIR=$PWD/tmake-1.13 
export TMAKEPATH=$PWD/tmake-1.13/lib/qws/linux-arm-g++ 
export PATH=$TMAKEDIR/bin:$PATH 

cd qt-2.3.2 
export QTDIR=$QT2DIR 
export PATH=$QTDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
./configure -no-xft 
make 
make -C tools/qvfb 
cd .. 

cd qt-2.3.10-target 
export QTDIR=$PWD 
export PATH=$QTDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH 
mkdir bin 
cp $QT2DIR/bin/uic bin 
cp $QT2DIR/tools/qvfb/qvfb bin 
cp $QPEDIR/src/qt/qconfig-qpe.h src/tools/ 
./configure -xplatform linux-arm-g++ -qconfig qpe -qvfb -thread -system-jpeg -gif -depths 4,8,16,32 
make 
cd .. 
注：这里需要arm版本的libjpeg.so.62，hybus-arm-linux-R1.1里面包含这个库；如没有可以上网下载。 

tar xzf e2fsprogs-1.35.tar.gz 
cd e2fsprogs-1.35 
./configure -host=arm-linux -with-cc=arm-linux-gcc -with-linker=arm-linux-ld -enable-elf-shlibs -prefix=/usr/local/hybus-arm-linux-R1.1/arm-linux 
make install lib/uuid/ ===>>>这步安装到hybus-arm-linux-R1.1/lib上的libuuid.so.1.2版本不对, 
要cp lib/libuuid.so.1.2 ../hybus-arm-linux-R1.1/lib 
注：这步是交叉编译arm的libuuid库，配置详情见./configure --help 
（还要多谢 http://panjet.wleda.com/?p=20 这里面的大哥呀，好不容易才在网上找到的） 
cd .. 

cd qtopia-2.1.1-host 
export PATH=$QPEDIR/bin:$PATH 
export LD_LIBRARY_PATH=$QPEDIR/lib:$LD_LIBRARY_PATH 
cp src/libraries/qtopia/custom-linux-ipaq-g++.cpp src/libraries/qtopia/custom-linux-arm-g++.cpp 
cp src/libraries/qtopia/custom-linux-ipaq-g++.h src/libraries/qtopia/custom-linux-arm-g++.h 
./configure -xplatform linux-arm-g++ 
make 
注：这里需要libstdc++.so和libgcc_s.so库


develop环境下qt中文化程序设计 

原文出处：Linux公社 
原文作者：yfy001 


kdevelop是一款在linux平台下可以同windows环境下的vc相媲美的集成开发环境,qt则是一款支持包括windows和linux平台 
的GUI库,可以说它是linux下的MFC.在显示上,qt使用Unicode作为内部编码,可以支持多种编码.如何使用qt进行国际化编程 
在网上可以找到很多资料的,但都是针对较早版本的qt进行介绍的.qt3.0.5中对这些作了些改动,这些方法就相应的要做些改动. 
而且在kdevelop中开发qt应用程序,将会事半功倍.我的开发环境为redhat8.0(需安装kde开发工具包). 
首先在linux中打开kdevelop集成开发环境,用它的应用程序向导新建一个qt的SDI的应用程序框架.这个同windows下vc很类似.它 
将会为你自动生成版本号,作者,e-mail等信息的单文档对话框的应用程序框架.我们首先对它自动生成的程序进行汉化(qt1是 
我的项目名称). 
1.汉化自动生成的程序 
添加翻译文件 
在"项目"菜单中选择"添加新的翻译文件",语言选择"zh_CN.Gb2312".将会创建一个zh_CN.GB2312字符编码的翻译文件.扩展名 
为".ts".在qt3.0.5环境下,打开"*.ts"翻译文件的工具是linguist.你可以在"工具"菜单中选择"QT 
linguist"来打开,在linguist菜单中选择"file"->"open"打开所要翻译的翻译文件.此时可以在linguist窗口中的source text中 
的文本就是你所要翻译的文本,选择所要翻译的文本,在下方有一个类似一页纸一样的地方,在translate下输入翻译后的文本. 
所示. 
翻译完这些文件后,编译运行,在我们的程序里并不能显示中文,还是英文,我们还需要做的就是用lrelease命令将翻译后的文件转换 
成".qm"文件才可以使用.在控制台下进入你用kdevelop所生成的应用程序目录. 
>lrelease Makefile.am 
qt3.0.5用这个两个程序取代了以前版本的findtr和msg2qm命令.在kdevelop集成环境中打开main.cpp主函数, 
...... 
QApplication a(argc, argv); 
a.setFont(QFont("helvetica", 10)); 
QTranslator tor( 0 ); 
tor.load( QString("qt1.") + QTextCodec::locale(), "." ); 
// tor.load( QString("qt1.zh_CN.GB2312"), "." ); 
a.installTranslator( &tor ); 
/* uncomment the following line, if you want a Windows 95 
look*/ 
// a.setStyle(WindowsStyle); 

Qt1App *qt1=new Qt1App(); 
//Form1 *qt1=new Form1(); 
a.setMainWidget(qt1); 
...... 
此处: 
tor.load( QString("qt1.") + QTextCodec::locale(), "." ); 
是根据客户环境的locale来载入当前目录下相应的翻译文件的.redhat中文环境默认的locale为gb18030, 
此处要么把翻译文件名由qt1.zh_CN.GB2312.qm改为qt1.zh_CN.GB18030.qm,要么将这句改为 
tor.load( QString("qt1.zh_CN.GB2312"), "." ); 
不过为了国际化编程的需要,建议采用第一种方法.更改后编译运行,你会发现你的程序已经是中文界面的了. 

2.汉化自己的对话框 
大多数情况下我们都需要自己来设计对话框,qt为我们提供了非常好的对话框编辑器QtDesigner,可以很方便的设计我们的对话框,qt 
的信号和槽等,关于QtDesigner的使用,限于篇幅,不再赘述.以前面的程序为基础.在kdevelop中选择"文件"->"新建",选择Qt 
Designer文件(*.ui).在文件名一栏中填写"mydialog",最后点击确定按钮,即会启动QtDesigner,此处只拖了一个Label,写了一 
些英文字符.对话框的name属性为Form1.将对话框mydialog.ui保存. 
在控制台下进入你用kdevelop所生成的应用程序目录. 
>lupdate Makefile.am 
同样用"QT 
linguist"来翻译qt1.zh_CN.GB2312.tr文件.此时linguist的context中会多出Form1的选项,这里面就是我们新建的对话框要翻译的 
选项.依据前面的方法进行汉化. 
>lrelease Makefile.am 
生成qt1.zh_CN.GB2312.qm文件. 
编译将会生成mydialog.cpp mydialog.h mydialog.moc文件.然后将main.cpp中的 
Qt1App *qt1=new Qt1App();改为 
Form1 *qt1=new Form1(); 
并将"mydialog.h" #include 
进去.依据前面的方法更改tor.load中加载的翻译文件.编译运行,你的对话框也是中文的了. 

3.其它的一些说明 
由于qt返回的是Unicode编码,譬如你在LineEdit中直接输入中文,返回的就是??,qt中可以直接使用QTextCodec来转换字符串的编码. 
QString string; 
string=LineEdit1->text(); //取得LineEdit1返回的文字 
QTextCodec *codec=QTextCodec::codecForName("GBK"); 
//转换编码 
QCString 
chinese_string=codec->fromUnicode(string);//用QCString来存储返回的多字节编码 
当然,你在头文件中就必需加入 
#include <qtextcodec.h> 
#include <qstring.h> 
#include <qcstring.h> 

4.QTextStream对中文的支持 
QTextCodec* codec = QTextCodec::codecForName("GBK"); /* 当前编码为"GBK" */ 
QTextStream mystream(&file); 
mystream.setCodec(codec); 

5. QCString&QString 
QCString中不以unicode编码 
QString以unicode为编码. 
qt内部使用unicode为编码,所以如果要在qt的部件如multilineedit中显示中文,则需要将非unicode的字符转换成unicode字符. 
QCString locallyEncoded = "中国人不是东亚病夫"; // text to convert 
QTextCodec *codec = QTextCodec::codecForName("GBK"); // get the codec for GBK 
QString unicodeString = codec->toUnicode( locallyEncoded );

http://www-128.ibm.com/developerworks/cn/l...oolkit/qt/i18n/

Qt 国际化编程 




内容： 

1. Qt 的文本显示 

2. Qt 的文本输入 

3. Qt 的打印 

对本文的评价 



订阅: 

developerWorks 时事通讯 






于明俭
　
2002 年 1 月 09 日

本篇讨论 Qt 库对国际化的支持，将介绍 Qt 对文本显示，输入和打印的支持，和如何 使用Qt 开发国际化的软件。
Qt 目前的版本(2.2.4)对国际化的支持已经相当完善。 在文本显示上，Qt 使用了Unicode 作为内部编码，可以同时支持多种编码。 为 Qt 增加一种编码的支持也比较方便，只要 增加该编码和Unicode的转换编码便可以了。 Qt 目前支持ISO标准编码ISO 8859-1， ISO 8859-2，ISO 8859-3，ISO 8859-4，ISO 8859-5，ISO 8859-7，ISO 8859-9，和 ISO 8859-15(对于阿拉伯语和希伯来语的支持正在开发之中)，中文GBK/Big5，日文 eucJP/JIS/ShiftJIS，韩文eucKR，俄文KOI8-R。 当然也可以直接使用UTF8编码。

Qt 使用了自己定义的Locale机制，在编码支持和信息文件(Message File)的翻译上弥补了目前Unix上所普遍采用Locale和gettext的不足之处。 Qt 的这种机制可以使 Qt 的同一组件(QWidget)上同时显示不同编码的文本。 比如，Qt 的标签上可以同时使用中文简体 和中文繁体文本。

在文本输入上， Qt 采用了XIM(X Input Method)标准协议，可以直接使用XIM输入服务器。 由于目前的绝大多数输入服务器都是针对单一语言的，所以在 Qt 的标准输入组件( QLineEdit，QMultiLineEdit)中的输入受到单一编码的限制，Qt 还不支持动态切换编码输入的支持，这是它的不足之处。

1. Qt 的文本显示
像 普通的国际化过程一样，Qt 使用了类似GNU gettext一样的函数 QObject::tr()，它 用于从Qt的信息文件 .qm 中取出信息，这些信息是经过 Qt 的工具处理的。 Qt在处理 编码时还使用了 QTranslator 类，可用于指定整个应用软件的 的信息文件。

使 用 Qt 编写国际化的程序，最好不要在程序中直接使用特殊编码的文本。 比如要 编写一中文界面的 Qt 程序，应该在程序中使用英文，程序编写完成后，把文本提取 出来翻译。 这样，程序还可以根据Locale的不同，支持多种语言。 下面介绍如何在 Qt 程序中标注字符串，如何提取并翻译文本。 
下面是一段使用了 QObject::tr()的代码，它建立了一个弹出菜单，菜单项是"Quit"， 它被放置在菜单条上，在菜单条上显示的是标签"File"。



QPopupMenu* popup;
popup = new QPopupMenu( this );
popup->insertItem( tr("&Quit")，qApp，SLOT(quit()) );
menubar->insertItem( tr("&File")，popup );



对 于绝大多数情况，可以用上述方法处理。不过有时在定义某些变量中使用的字符 串，不能使用上述方法，但是为了让Qt提取并翻译该字符串，必须用某种方法标志出 来。Qt 定义了 QT_TR_NOOP() 和 QT_TRANSLATE_NOOP() 来标志它们。前者用于单个字符串，后者用于多个字符串。比如，



static const char* strings[] = {
QT_TR_NOOP( "Hello" )，
QT_TR_NOOP( "World" )
};



有时需要使用printf/sprintf之类的函数动态生成字符串，比如，



QStings s;
s.sprintf( "Button %d"，i );
but->setText( s );


对这种使用方式的国际化是使用 arg() 函数。



QString s = tr( "Button %1" ).arg(i);
but->setText( s );



提取上述信息的方法是使用 Qt 提供的工具 findtr 命令:



findtr [filename].cpp > i18n.po


它类似于GNU的 xgettext，上述文件的提取信息文件内包含，



....
"Content-Type: text/plain; charset=iso-8859-1\n"

#: i18n.cpp:34
msgid "ExampleWidget::&File"
msgstr ""
...



接 下来是文本翻译过程。 在Qt中翻译信息文件时应该注意以下事项: (1) 提取的信息文件的编码是iso-8859-1，在翻译成某种语言(编码)时应该 注意改动它的 字符集，比如对中文GB2312和Big5编码，应该是， "Content-Type: text/plain; charset=gb2312\n"或者"Content-Type: text/plain; charset=big5\n"。 (2) 提取的信息有一个范围，比如上面的文件指定的范围是 ExampleWidget， 在翻译 前应该把它去掉，变成 msgid "::&File"。(3) 被翻译的字符串可能含有加速键符号，如 "&File"中的"F"，如果翻译成中文最好保留该信息，它可以翻译成 "文件(&F)"。

对于翻译后的文件(比如上面的翻译文件存为 i18n_gb.po)，必须使用 Qt 提供的 工具 msg2qm 把它转换为 .qm 文件才能使用，



> msg2qm i18n_gb.po i18n_gb.qm



它类似于GNU的 msgfmt 命令。翻译后的文件可以用Qt程序直接调用。



QTranslator *translator = new QTranslator(0);
translator->load("i18n_gb.qm"，".");
qApp->installTranslator(translator);



此外，Qt 还提供了类似于 msgmerge 的工具 mergetr，它用于把新提取的信息 文件和已经翻译过的信息文件融合起来，在此不再赘述。

在 Qt 中也可以直接使用 QTextCodec 来转换字符串的编码，这为在Qt下开发纯 中文软件带来了便利条件，不过这种方法不符和国际化/本地化的习惯，



char *string = "中文和English混和字符串!"
QTextCodec* gbk_codec = QTextCodec::codecByName("GBK");
QString gbk_string = codec->toUnicode(string);
QLabel *label = new QLabel(gbk_string);



如果使程序只支持一种编码，也可以直接把整个应用程序的编码设置为GBK编码， 然后在字符串之前 加tr(QObject::tr)，



qApp->setDefaultCodec( QTextCodec::codecForName("GBK") );
QLabel *label = new QLabel( tr("中文标签") );



如果使Qt根据Locale的环境变量取得字符集，可以使用 QString::fromLocal8Bit(str)。 

本节的例子请参见 qt-i18n-example.tar.gz 

2. Qt 的文本输入
在 输入方面，Qt 的输入条(QLineEdit)和编辑区(QMultiLineEdit)都支持 XIM，只要配合相应的输入服务器，便可以输入中文/日文/韩文。目前有许多支持XIM的软件，比如 中文: Chinput/xcin/rfinput/q9，日文: kinput2/skkinput，韩文: ami/hanIM。

Qt程序的缺省输入风格是OverTheSpot风格，它也支持 OffTheSpot风格和 Root风格。 用户可以在起动程序时在命令行指定输入风格，比如对程序app，



./app -inputstyle overthespot #缺省风格，光标跟随
./app -inputstyle offthespot
./app -inputstyle root



经过 MiziLinux 补丁的Qt-2.2.0 支持 OnTheSpot 输入风格，并且把它作为 缺省的输 入风格。请参见 http://www.mizi.com/ko/kde/doc/onthespot/onthespot.html。

Qt 中的任何一个 Widget 都可以接受输入，只要它可以有键盘聚焦(Keyboard Focus)。所以对特殊 Widget 的输入处理只需要截获键盘输入，获取从XIM服务器 来的字符串。 对于OverTheSport风格的支持，刷新XIM输入服务器的位置即可。

3. Qt 的打印


在打印方面，XWindow下的 Qt 生成PostScript并使用lpr打印。 它含有QPrinter类， 可以方便地支持输出页面的控制。 对于中文打印，必须修正PostScript文件的输出 部分。 

TOpia中文化

一：字符集介绍

我 国已经颁布了多种中文信息编码标准，常用的有：GB2312-1980、GB12345、GB13000（GBK）以及最新标准GB18030，其中 GB13000是对GB2312的扩展，又常被成为GBK，GB18030向下兼容GB2312和GBK，中文WINDOW98、中文WIN2000操作 系统采用的中文字符集是GB2312。

GB2312字库仅覆盖双字节部分，存储位置索引是编码中每字节的第8bit置0得来的，如A1A1编码汉字在字库中的索引是2121，而非A1A1。以下是它的编码规则：

单字节：00~7F

双字节：A1~F7 A1~FE

GBK的编码规则是：

单字节：00~7F

双字节：81~FE 40~7E

80~FE

GB18030是最新的汉字编码标准，其编码为一、二、四变长编码：

单字节：00~7F

双字节：81~FE 40~7E

80~FE

四字节：81~FE 30~39 81~FE 30~39

Unicode编码采用等长编码，二个字节表示一个字符编码，对于ASCII码也采用双字节来表示，unicode使用二维空间来描述编码空间，平面分为256行、256列，对应于编码的高低字节。



二：Qt 国际化编程

在 文本显示上，Qt 使用了Unicode 作为内部编码，为了程序的国际化，通常我们在文本显示的地方不直接输入本地字符，用英文代替，比如要编写一中文界面的 Qt 程序，应该在程序中使用英文，程序编写完成后，把文本提取出来翻译。对于需要翻译的地方，首先是在该文本处用tr（）函数标识，同时制作出.qm信息文 件，并在程序中加入QTranslator即可。比如我们在某一程序中有如下语句：

setCaption(tr(“main window”));

为了能显示中文，有两种方法：

方法一：

l 修改工程文件，加上TRANSLATIONS = xxx.ts

l lupdate 工程文件名

l 用linguist编辑刚生成的xxx.ts文件并保存

l lrelease 工程文件名 xxx.qm

l 在main.cpp中加入QFont font1(“unifont”,16,50,FALSE,QFont::Unicode);

qApp->setFont(font1);

QTranslator *translator = new QTranslator(0);
translator->load("xxx.qm"，".");
qApp->installTranslator(translator);
方法二：

l findtr 文件名（通常为CPP文件） > xxx.po

l 编辑po文件，其中charset需由iso-8859-1改为GB2312，然后将“main window”翻译成“主窗口”

l msg2qm –scope zh_CN.GB2312 xxx.po xxx.qm

l 在main.cpp中加入QFont font1(“unifont”,16,50,FALSE,QFont::Unicode);

qApp->setFont(font1);

QTranslator *translator = new QTranslator(0);
translator->load("xxx.qm"，".");
qApp->installTranslator(translator);

方法三：

有时我们只是提供给本地用户使用，无需国际化，QT提供这一支持，在QT中有许多本地字符集同unicode的转换引擎，他们皆为QTextCodec的派生类,如QGbkCodec、QJisCodec, QHebrewCodec等。如：

QFont font1(“unifont”,16,50,FALSE,QFont::Unicode);

qApp->setFont(font1);

QString caption=“主窗口“；

QTextCodec *gk_codec=QTextCodec::codecForName(“GBK”);

setCaption(gk_codec->toUnicode(caption));

从上面可以看出，使用转换引擎可以轻松实现中文显示，简要步骤如下：

1：修改main.cpp文件，将字体改为unifont

QFont font1(“unifont”,16,50,FALSE,QFont::Unicode);

qApp->setFont(font1);

2：在想汉化的内的头文件中加入QTextCodec指针变量和转换函数QString mytr(char *)

#include <qtextcodec.h>

QTextCodec* gbk;

QString mytr(const char *);

3：在想汉化的类的实现文件中，修改类构造函数，加入：

gbk=QTextCodec::codecForName(“GBK”);

4：在想汉化的类的实现文件中，添加mytr函数代码

QString Form1::mytr(const char* chars)

{

return gbk->toUnicode(chars,strlen(chars));

}

5：在想汉化的类的实现文件中，用“mytr”替换“tr”

2004-12-2 测试了上面的方法三，编译通过,如果将codec成员变量改成QTextCodec派生类变量，编译将通不过，比如将QTextCodec* gbk;改成QGbkCodec* gbk;编译将报告此处有语法错误。下面是相似的用法：

1：修改***.cpp文件，在顶部加入codec头文件

#include <qgbkcodec.h>

2：在***.h文件中，加入mytr()函数声明

QString mytr(char* buffer,int size);

3：在***.cpp文件中，加入mytr（）定义

QString mytr(char* buffer,int size)

{

QGbkCodec* gbk=QTextCodec::codeForName(“GBK”);

return gbk->toUnicode(buffer,size);

}

4：在需要显示中文的地方，使用mytr函数即可

5：修改main.cpp文件，将字体改为unifont

QFont font1(“unifont”,16,50,FALSE,QFont::Unicode);

qApp->setFont(font1);

备注：在翻译或转换之前必须将Unicode字体调入，否则显示不出中文，网上相关文章并未提及这一点，如果不显式装载该字体，系统默认的是Latin1,于是汉字显不出来。

备注2：在编译qt/embedded之前，必须修改qconfig-qpe.h配置文件的内容，将与TextCodec相关的宏定义给去掉，否则QTextCodec::codecForName(“GBK”)将返回NULL指针。

备注3：使用findtr命令时可同时查找多个文件的tr（），并将查找结果都放入一个文件内，源文件以空格隔开即可，另外，生成的.po和.qm文件的文件名最好与工程文件名相同！

备 注4：如果要显示繁体中文，则需要使用QTextCodec::codecForName(“big5”)。获取本地的使用语言，用 QTextCodec::locale()，它返回Qstring变量，通常如果是中文本地的话，通常其值为zh_CN.GB2312和 zh_TW.Big5,根据这个返回字符串，可以加载相应的codec。如果程序只支持一种编码，也可以直接把整个应用程序的编码设置为一个默认的编码标 准，比如系统只需要显示中文和英文，则可以直接设置应用程序的默认编码标准是GBK，如下使用方法：

qApp->setDefaultCodec( QTextCodec::codecForName("GBK") );

QLabel *label = new QLabel( tr("中文标签") );

备注5：如果使用本地的字符转换器，可以使用Qstring的静态函数Qstring::fromLocal8Bit(char* buffer,int size)，将本地字符串转换成UNICODE字符串，不过要设置好LANGUAGE环境变量。



三：QTOpia中文化

l findtr 文件名 > xxx.po

l 编辑xxx.po文件

l msg2qm –scope zh_CN.GB2312 xxx.po xxx.qm

l 拷贝可执行文件到QPEDIR/bin目录

l 拷贝xxx.po和xxx.qm文件到QPEDIR/i18n/zh_CN目录

l 进入QPEDIR/apps/Applications目录创建一新.desktop文件

l iconv –f utf8 –t GB18030 xxx.desktop > xxx1.desktop

l 编辑xxx1.desktop文件，主要是修改Exec、Icon、Name和Name[zh_CN]四项

l iconv –f GB18030 –t utf8 xxx1.desktop > xxx.desktop

l rm –f xxx1.desktop

l qvfb –depth 16 &

l cd $QPEDIR/bin

l ./qpe

备注：如果你的系统中有多个qtopia版本，要特别注意QTDIR、QPEDIR、LD_LIBRARY_PATH环境变量

备注2：可按照此方法汉化qtopia自带的应用程序

备 注3：po文件是中间文件，程序真正需要的是qm文件。iconv是系统自带的内码转换工具，它能将utf8编码的文件转换成gb18030编码的文件， 反之也能，转换这一步必不可少，因为desktop文件缺省是utf8编码的，而我们的redhat linux 7。3中文操作系统用的却是gb18030，所以在编辑器打开前需转换。



四：汉化qtopia-1.5.0 for Arm

首 先按照“三”的方法对要汉化的程序提取*.qm文件和*.desktop桌面配置文件，在做完这一步后，将*.qm文件down到目标机的 /opt/qtopia-free-1.5.0.arm/i18n/zh_CN目录下，同时将*.desktop文件覆盖/opt/qtopia- free-1.5.0.arm/apps目录下的相应文件，目标机的环境变量配置如下：

export QTDIR=/opt/qt-2.3.3.arm

export QPEDIR=/opt/qtopia-free-1.5.0.arm

export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

export PATH=$QPEDIR/bin:$PATH

export LANG=zh_CN

开 机启动，由于设置的语言为简体中文，qpe会自动为每个应用加载Unifont字体，以及简体中文目录下的翻译文件，因而显示出中文，翻译文件是一个方 面，但更关键的是要显示中文必须有中文字体来支持，Unifont字体包含中文字，因而能显示中文，没有相应字体的支持，光有翻译文件是显示不出中文的！

在经过以上的步骤后，有的应用在显示上依然会显示方框，这多半是由于该窗体相关的字体可能不是支持中文的字体，这需要直接修改源代码，以下是在汉化qtopia-free-1.5.0.arm的过程中的相关记录：

1. 在编译qtopia的过程中，可能会报告找不到SetButtonGroupID()函数，编译通不过。这是由于库中并没有该函数，一般情况下将该语句隐 藏掉，原代码的原意是设置Button按钮在ButtonGroup组的序号，隐藏该语句对应用无影响。出现这个问题，主要在 /netsetup/dialup/dialupbase.cpp文件和/taskbar/shutdown.cpp文件，shutdown.cpp文件 的相应行号是：96、149、201、253行。

2. 修改mpegplayer/playlistwidget.cpp文件的143行和166行，将字体设置改为Unifont，如下：Qfont(“unifont”,16,50,FALSE,QFont::Unicode)或者去掉该语句

3. 修改snake/interface.cpp的87行和186行，将字体设置改为Unifont，如下：Qfont(“unifont”,16,50,FALSE,QFont::Unicode)或者去掉该语句

4. 修改qasteroids/view.cpp的104行和qasteroids/toplevel.cpp的109行和165行，将字体设置改为 Unifont，如下：Qfont(“unifont”,16,50,FALSE,QFont::Unicode)或者去掉该语句

5. 修改sysinfo/versioninfo.cpp文件，将61行的builder改为作者本人，将50行的v改为tr(“corpname”)，重新建立po文件，并翻译corpname为国营789北京开发部，使用msg2qm生成qm文件

6. 修改桌面，位于taskbar目录下，生成libqpe.po和libqpe.qm文件，并将libqpe.qm文件拷贝到i18n/zh_CN目录下



五：qtopia目录结构

apps/Applications：应用程序桌面配置文件

apps/Games：游戏桌面配置文件

apps/Settings：系统设置桌面配置文件

bin：二进制可执行文件

configs：编译配置文件目录

doc和docs：qtopia的参考文档

etc：应用配置文件目录

i18n：国际化目录

i18n/zh_CN：简体中文目录

include/qpe：与qtopia相关的头文件目录

inputmethods：输入法

library：qtopia部分源代码目录

pics：与应用相关的图片存放目录

plugins：各种插件目录，如mpeg3解码插件、输入法插件等

sounds：音频文件存放目录

taskbar：桌面程序的源代码（qpe的源代码）





文件修改记录：

1：创建于2003/6/9

2：于2003/8/21添加实现中文显示的第三种方法部分

3：于2004-1-18添加文章的“四”内容，一个汉化qtopia for arm的实例，以及“五”。