Neverendingo (Talk | contribs) m (Text replace - "</code>" to "</syntaxhighlight>") |
|||
| Line 1: | Line 1: | ||
| − | |||
==简介== | ==简介== | ||
Contents |
本教程帮助开发人员将 Qt3/KDE3的程序移植到Qt4/KDE4。这并不是个很困难的过程。现在已经有了很多脚本，代码和文档；可以提供很多帮助。
本教程中使用以下短语:
与KDE3不同, KDE4借助于 CMake来构建整个项目。The easiest way to port your autotools system to CMake is with the help of the am2cmake script which can be found in the cmake/scripts directory of the kdesdk module. 这会根据你原有的联编文件创建一系列CMakeLists.txt文件。
例如,在/path/to/src 有源代码，那么:
% cd /path/to/src % $SVN/trunk/KDE/kdesdk/cmake/scripts/am2cmake --kde4
运行 am2cmake --help，检查你是否需要有--kde4标志。
有个工具可以检查产生的 CMakeList.txt文件，以期避免一些潜在的问题。这个工具叫做 cmakelint.pl，在$SVN/trunk/kde/kdesdk/scripts可以找到。用法如下：
% cd /path/to/src % $SVN/trunk/KDE/kdesdk/scripts/cmakelint.pl CMakeLists.txt
或者，在你整个代码树目录下运行：
% cd /path/to/src % find . -name CMakeLists.txt | \ xargs $SVN/trunk/KDE/kdesdk/scripts/cmakelint.pl
An overview of the Qt3 to Qt4 transition is provided in Trolltech's "Moving from Qt 3 to Qt 4" paper. This document provides an excellent overview into the major functionality changes with Qt4 and is highly recommended.
The follow-on "Porting to Qt 4" page gives an amazingly detailed description of the porting process, along with a list of the changes in the classes and functions.
These documents describe a tool provided by Trolltech called qt3to4 that can help port the Qt parts of your code from Qt3 to Qt4, using compatibility functions. Run qt3to4 as follows:
% $SVN/trunk/qt-copy/bin/qt3to4 [options] <Infile>, [Infile], ...
Infile can be a source file or a project file. If you specify a project file, ending with '.pro' or '.pri', qt3to4 will port all files specified in that project.
For more information, run qt3to4 with the "--help" option or visit the "qt3to4-The Qt 3 to 4 Porting Tool" page.
Additionally, there is a program called remove-qt3-support.pl in the kdesdk module that will search and replace lots of deprecated Qt3 stuff for you. Simply run this program without any options in the source directory.
% $SVN/trunk/KDE/kdesdk/scripts/qt4/remove-qt3-support.pl
Chances are that some Qt3 classes will still remain in the code, so make sure your top-level CMakeLists.txt file defines the QT3_SUPPORT and QT3_SUPPORT_WARNINGS macros for the Qt headers, like so:
add_definitions (-DQT3_SUPPORT -DQT3_SUPPORT_WARNINGS)
Much of the porting effort consists of simply renaming class names and header files. Since it would be rather tedious to change all these by hand, there is a handy script in the scripts/qt4 directory of kdesdk called adapt-to-kde4-api.pl. This will update all your files and output a diff so you can see what changes were made.
Once that simple code substitution has been done, you will still have to go through your code to port to, for example, the new KAction API. Documentation about all API changes is kept in the KDE4PORTING.html file in the kdelibs module.
Qt designer ".ui" files created using Qt3 must be converted to the new Qt4 format. This can be done using the uic3 program available from your Qt4 installation.
% $SVN/trunk/qt-copy/bin/uic3 -convert file.ui > foo.ui % mv foo.ui file.ui
Or, if you prefer a graphical tool, you can use Qt4's designer program
% $SVN/trunk/qt-copy/bin/designer file.ui (you can save file.ui over top itself, or save to a new file)
| Warning |
|---|
| Beware, the conversion process loses any custom slots, table columns, etc. So, you may need to put some stuff back by hand. |
You should also run the fixuifiles program from the kdesdk module, it performs cleanups and sanity checks:
% $SVN/trunk/KDE/kdesdk/scripts/fixuifiles
与KDE3的DCOP不同，KDE4使用D-Bus来完成进程间通讯。从DCOP向D-Bus移植是个大标题，在 D-Bus移植教程有关于他的详细内容。 更多信息，请见D-Bus教程.
KDE4 uses the freedesktop.org icon naming specification as the basis for icon names. This means that both the icons that ship with KDE4 (Oxygen) as well as components in kdelibs that use icons follow this specification.
Porting your app from the icon names used in KDE3 to the ones used in KDE4 is as easy as running the adapt-to-icon-spec.py script from the root directory of your project and follow the instructions on screen.
The script automatically converts confirmable positives (e.g. uses of KIcon or KIconLoader), skips confirmable negatives and prompts for what to do with possible positives. It shows the latter with additonal context if desired and makes it a simple matter of pressing 'y' or 'n' for the possible hits to complete the porting.
To create your ".pot" file, copy the commands from the 'messages' rule in your projects Makefile.am to a shell script called Messages.sh. You may assume the same variables ($PREPARETIPS, $XGETTEXT, $podir, etc.) still exist, but keep in mind the differences between Makefile and shell script syntax.
Also be careful that if you use the -k parameter with $XGETTEXT, you will need to explicitly list all variants that you use.
例如, 消息（'messages'）的创建规则：
KDE TechBase messages: rc.cpp
rm -f tips.cpp
$(PREPARETIPS) > tips.cpp
$(XGETTEXT) -ktranslate *.cpp *.h -o $(podir)/kmail.pot
rm -f tips.cpp会有Messages.sh脚本:
#! /usr/bin/env bash $PREPARETIPS > tips.cpp $XGETTEXT -ktranslate:1,1t -ktranslate:1c,2,2t *.cpp *.h -o $podir/kmail.pot rm -f tips.cpp
