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
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
|
/****************************************************************************
**
** This file is part of Qt Creator
**
** Copyright (c) 2011 Nokia Corporation and/or its subsidiary(-ies).
**
** Contact: Nokia Corporation (info@qt.nokia.com)
**
**
** GNU Free Documentation License
**
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
****************************************************************************/
/*!
\contentspage index.html
\if defined(qcmanual)
\previouspage creator-developing-maemo.html
\else
\previouspage sdk-gs.html
\endif
\page creator-developing-symbian.html
\if defined(qcmanual)
\nextpage creator-project-managing-sessions.html
\else
\nextpage creator-developing-maemo.html
\endif
\title Setting Up Development Environment for Symbian
When you install \QSDK, the build and run settings for Symbian devices
are set up automatically. You only need to connect the devices to the
development PC.
Connect the device to the development PC with an USB cable in
PC Suite Mode. If you have not previously used the device with Ovi Suite
or PC Suite, all the necessary drivers are installed automatically.
This takes approximately one minute.
To run Qt applications on Symbian devices, you must install the software
that Qt applications require, typically Qt, Qt Mobility, QtWebkit, and Open C.
The \QSDK installation program creates shortcuts for installing
the required applications on Symbian devices. You can also use any of
the standard methods for installing applications.
To debug applications on Symbian devices by using the Qt Creator \gui Debug
mode, you must install an on-device debugging agent on the device. You have
a choice between App TRK and CODA debugging agents. For more information,
see
\if defined(qcmanual)
\l{Using On-device Debugging Agents}.
\else
\e \l{http://doc.qt.nokia.com/qtcreator-latest/creator-developing-symbian.html}{Using On-device Debugging Agents}.
\endif
The tool chain for building applications locally on the development PC for
the \gui {Symbian Device} target is only supported on Windows.
If you develop on Linux or Mac OS, you must use the Remote Compiler
interface to a compilation service at Forum Nokia.
For more information about developing applications for the Symbian
platform, select \gui {Help > Index} and look for \gui {Platform Notes},
or see
\l{http://doc.qt.nokia.com/4.7/platform-notes-symbian.html}{Platform Notes - Symbian}.
\section1 Hardware and Software Requirements
For deploying and running applications on the device, you need the
following:
\list
\o The Nokia USB drivers that come with \e{PC Suite} or \e{Ovi Suite}
\o An on-device debugging agent, \e {App TRK} or \e CODA, installed on
the device
\o \e Qt installed on the device
\o \e {Qt Mobility APIs} installed on the device, if you use them in
applications
\o \e {QtWebKit} installed on the device, if you use web functionality
in applications
\endlist
In addition, you can install example applications, demos, and utility
applications, such as Nokia Energy Profiler and Nokia Performance Manager,
on devices.
The \QSDK installation program creates shortcuts for installing
the applications on Symbian devices.
\if defined(qcmanual)
To run your applications in the Symbian emulator, you also need
to install Carbide.c++ v2.0.0 or higher.
\endif
\section1 Installing Required Applications on Devices
Separate installation packages are provided for Symbian^3 and Symbian^1
devices. To check the Symbian platform version of your device, see
\l{http://www.forum.nokia.com/devices}{Device Details}.
\note You can also copy the .sis files from
\c {<QtSDK_install_path>\Symbian\sis} to the device using USB storage
mode and install them from the file manager on the device.
\section2 Developing for Symbian^3
\note The command names and paths depend on the \QSDK version that is
installed.
\list 1
\o Choose \gui {Start > Qt SDK > Symbian^3 Qt 4.7.3 > Install Qt 4.7.3 for
Symbian^3 on Device}. Follow the instructions on the screen to install Qt
libraries to the device.
\o Choose \gui {Start > Qt SDK > Symbian^3 Qt 4.7.3 > Install QtMobility 1.1.2 for
Symbian^3 on Device}
and follow the instructions on the screen to install Qt
mobility libraries to the device.
\o Choose \gui {Start > Qt SDK > Symbian^3 Qt 4.7.3 > Install TRK
(Debug Agent) for Symbian^3 on Device} and follow the
instructions on the screen to install
the App TRK debugging agent to the device.
\o Choose \gui {Start > Qt SDK > Symbian^3 Qt 4.7.3 > Install QtWebKit
for for Qt 4.7.3 on Symbian^3 Device} and follow the
instructions on the screen to install QtWebKit to the device.
\endlist
\section2 Developing for Symbian^1
Symbian^1 incorporates Symbian OS and S60 5th Edition (S60 5.0), which is
built on Symbian OS v9.4.
\note The command names and paths depend on the \QSDK version that is
installed.
\list 1
\o Choose \gui {Start > Qt SDK > Symbian^1 Qt 4.7.3 > Install Qt 4.7.3
for Symbian^1 on Device}. Follow the instructions on the screen to install Qt
libraries to the device.
\o Choose \gui {Start > Qt SDK > Symbian^1 Qt 4.7.3 > Install QtMobility 1.1.2
for Symbian^1 on Device} and follow the instructions on the screen to install Qt
mobility libraries to the device.
\o Choose \gui {Start > Qt SDK > Symbian^1 Qt 4.7.3 > Install TRK
(Debug Agent)} for the type of the connected device and follow the
instructions on the screen to install
the App TRK debugging agent to the device.
\o Choose \gui {Start > Qt SDK > Symbian^1 Qt 4.7.3 > Install QtWebKit
for for Qt 4.7.3 on Symbian^1 Device} and follow the
instructions on the screen to install QtWebKit to the device.
\endlist
In addition, you can install an example application and demos to Symbian^1
devices.
\if defined(qcmanual)
\section1 Using On-device Debugging Agents
CODA is a new on-device debugging agent that will eventually replace App TRK.
You can choose which debugging agent to use in the \gui {Run Settings} for
the project.
CODA offers the following benefits:
\list
\o Extended error information
\o Debugging over WLAN
\o Extended information about the device
\endlist
CODA differs from App TRK in the following ways:
\list
\o Coda does not support debugging over a Bluetooth connection.
\o Coda supports only Symbian^1 and Symbian^3 devices. It does not
support S60 3rd Edition devices.
\endlist
\section2 Installing Debugging Agents
You can download CODA from the
\l{http://tools.ext.nokia.com/coda/}{CODA download server}.
The \QSDK installation program creates a shortcut for installing
App TRK on Symbian devices, but you can also download and install it
separately from the
\l{http://tools.ext.nokia.com/trk/}{App TRK download server}.
\section1 Adding Symbian Platform SDKs
\QSDK contains all the tools you need for developing Qt applications for
Symbian devices. To use Symbian APIs directly in your applications, you can
install additional Symbian Platform SDKs:
\list
\o \l{http://www.forum.nokia.com/info/sw.nokia.com/id/ec866fab-4b76-49f6-b5a5-af0631419e9c/S60_All_in_One_SDKs.html}
{S60 Platform SDK 3rd Edition FP1 or higher}.
\o Either the GCCE ARM Toolchain that is included in the Symbian
SDKs, or RVCT 2.2 [build 686] or later (which requires a license).
\o Qt for Symbian 4.6.2 or later, installed into the Symbian SDKs you want
to use.
\endlist
\section2 Setting Up Qt Creator
When you run Qt Creator after installing the Symbian SDK and Qt for
Symbian, the installed SDKs and their corresponding Qt versions are
automatically detected. For each detected Symbian SDK with Qt, a special entry
is made in the Qt version management settings in \gui{Tools} >
\gui{Options...} > \gui{Qt4} > \gui{Qt Versions}.
If you manually add a Qt version for Symbian, you must
also manually specify the Symbian SDK to use for this version.
For more information about adding Qt versions and tool chains, see
\l{Setting Up Qt for Symbian Versions} and \l{Adding Tool Chains}.
\else
\section1 Building and Running Applications
You can test your application on a device by building and running
it from Qt Creator for the \gui {Symbian Device} target.
\list 1
\o Connect the device to the development PC through a USB cable.
The target selector displays a green check mark when a
device is connected.
\image qtcreator-qt4-symbian-device-connected.png
The tool tip of the target selector shows more details about the actual
device that will be used when you run your application.
\o Start the debugging application, App TRK or CODA, on the device and
deny the
Bluetooth connection.
\o Select \gui Options to select USB as connection type.
\o Click the \gui Run button in Qt Creator.
\endlist
\endif
*/
|
