1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
This is Qt version %VERSION%.
Qt is a comprehensive cross-platform C++ application framework. With
this pre-release you can make advanced graphical applications and
utilize TCP/IP connections. More specifically, these modules are now
available for S60:
QtCore - http://doc.trolltech.com/4.6-snapshot/qtcore.html
QtGui - http://doc.trolltech.com/4.6-snapshot/qtgui.html
QtNetwork - http://doc.trolltech.com/4.6-snapshot/qtnetwork.html
QtScript - http://doc.trolltech.com/4.6-snapshot/qtscript.html
QtSql - http://doc.trolltech.com/4.6-snapshot/qtsql.html
QtSvg - http://doc.trolltech.com/4.6-snapshot/qtsvg.html
QtTest - http://doc.trolltech.com/4.6-snapshot/qttest.html
QtWebKit - http://doc.trolltech.com/4.6-snapshot/qtwebkit.html
QtXml - http://doc.trolltech.com/4.6-snapshot/qtxml.html
Phonon - http://doc.trolltech.com/4.6-snapshot/phonon-module.html
INSTALLING Qt
Follow the instructions in the INSTALL file.
REFERENCE DOCUMENTATION
The Qt reference documentation is available locally in Qt's doc/html
directory or at http://doc.trolltech.com/4.6-snapshot/index.html
SUPPORTED PLATFORMS
For this release, the following platforms have been tested:
S60 3.1, 3.2 and 5.0
with these compilers:
WINSCW (Emulator, X86)
RVCT (Hardware, ARM)
GCCE (Hardware, ARM)*
The current version of GCCE cannot compile the Qt libraries
themselves as it has issues with global static data in DLLs.
However, we supply precompiled Qt libraries compiled with RVCT
that can be used instead. This makes it possible to write and
compile Qt applications using GCCE by linking to these
precompiled binaries. For more information on this issue see:
http://www3.symbian.com/faq.nsf/0/B8542F039C193CCC802573DA0011DFA7
HOW TO REPORT A BUG
We have set up a special mailinglist for feedback on the S60 port.
Bug-reports, feedback or questions all go to this list.
Please go to http://pepper.troll.no/s60prereleases/
for details on how to subscribe to the list.
Before posting, please consult the FAQ and the list of known issues:
http://labs.trolltech.com/page/QtforS60FAQ
http://labs.trolltech.com/page/QtforS60KnownIssues
Always include the following information in your bug report: the name
and version number of your compiler; the name and version number of
your operating system; the version of Qt you are using, and what
configure options it was compiled with.
If the problem you are reporting is only visible at run-time, try to
create a small test program that shows the problem when run. Often,
such a program can be created with some minor changes to one of the
many example programs in Qt's examples directory.
INSTALLING Qt for S60 Version %VERSION%
1. Install needed IDE and SDKs
Make sure you have the following installed:
- Carbide.c++ v2.0.0 or higher:
http://www.forum.nokia.com/main/resources/tools_and_sdks/carbide_cpp/
Note: It may be necessary to update the Carbide compiler.
See http://pepper.troll.no/s60prereleases/patches/ for instructions
how to check your compiler version and how to patch it, if needed.
- S60 Platform SDK 3rd Edition FP1 or higher:
http://www.forum.nokia.com/main/resources/tools_and_sdks/S60SDK/
- Open C/C++ v1.6.0 or higher. Install this to all S60 SDKs you plan to use Qt with:
http://www.forum.nokia.com/main/resources/technologies/openc_cpp/
- Building Qt tools requires a windows compiler, e.g. MinGW 3.4.5 or higher.
http://www.mingw.org/
- Building Qt libraries for real device requires RVCT 2.2 [build 686] or later:
http://www.arm.com/products/DevTools/RVCT.html
Make sure you have the following packages installed on any device you want to use to
run Qt applications. These packages can be found under nokia_plugin directory in any
S60 SDK where you have installed Open C/C++:
- nokia_plugin\openc\s60opencsis\pips_s60_<version>.sis
- nokia_plugin\openc\s60opencsis\openc_ssl_s60_<version>.sis
- nokia_plugin\opencpp\s60opencppsis\stdcpp_s60_<version>.sis
These instructions assume the above tools are installed and
that the enviroment variables for your compiler are set correctly.
Note: Users of S60 Platform SDK 3rd Edition FP1 also need special updates:
http://pepper.troll.no/s60prereleases/patches/
2. Install Qt
Uncompress the package into the directory you want Qt installed,
e.g. C:\Qt\%VERSION%.
Note: Qt must be installed on the same drive as the S60 SDK you are
using, and the install path must not contain any whitespaces.
3. Environment variables
In order to build and use Qt, the PATH environment variable needs
to be extended:
PATH - to locate qmake, moc and other Qt tools
This is done by adding c:\Qt\%VERSION%\bin to the PATH variable.
On Windows the PATH can be extended by navigating to
"Control Panel->System->Advanced->Environment variables".
In addition, you must configure the environment for use with the S60
emulator. This is done by locating the Carbide.c++ submenu on the Start
menu, and choosing "Configure environment for WINSCW command line".
4. Configure Qt
To configure Qt for S60, do:
cd \Qt\%VERSION%
configure -platform win32-g++ -xplatform symbian-abld
For other options, type "configure -help" to get a list of all available
options.
5. Build Qt
To build Qt for the emulator, type:
make debug-winscw
To build Qt for the device, type:
make release-armv5
Congratulations, Qt is now ready to use.
6. Running Qt demos
We've included a subset of the Qt demos in this package for you to try out.
An excellent starting point is the "fluidlauncher" demo. To run the demo on
a real device, you first have to install the Qt libraries on the device:
cd src\s60installs
createpackage -i Qt_for_S60_template.pkg release-armv5 <certificate file> <certificate key file>
Note: You will need to supply certificate that allows installation of
binaries with "All -Tcb" capability to your device.
Similarly, install fluidlauncher to the device:
cd embedded\fluidlauncher
createpackage -i fluidlauncher_template.pkg release-armv5
This will create a self-signed fluidlauncher_release-armv5.sis and install it to your device.
To run the demos on the emulator simply navigate to the directory of the demo and run:
make run
Or, if you need to supply arguments to the program, navigate to
%EPOCROOT%\Epoc32\release\winscw\udeb\ and start any of the Qt demos located there,
for example:
wiggly.exe -small-screen
We hope you will enjoy using Qt.
|
