Qt SDK 1.2

Connecting Symbian Devices

When you install Qt SDK, the build and run settings for Symbian devices are set up automatically in Qt Creator. You only need to install and launch the CODA on-device debugging agent on the devices and connect the devices to the development PC.

Make sure that Ovi Suite or PC Suite is installed on the development PC. Connect the device to the development PC with an USB cable in Ovi Suite or PC Suite Mode. This setting is in the device USB settings. 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.

You can run Qt applications on Symbian devices if the software that Qt applications require (typically Qt, Qt Mobility, QtWebkit, and Open C) is installed on the device. On Symbian Anna and later devices, some version of Qt is pre-installed. For more information, see Device Configurations.

To deploy applications to earlier devices, you can package the application with Nokia Smart Installer for Symbian to automatically install the modules that Qt applications require. For more information about which Qt modules are supported on-demand for different Symbian device models, see Nokia Smart Installer for Symbian.

The tool chain for building applications locally on the development PC for the 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 Nokia Developer. You can install Remote Compiler as part of the Qt SDK. For more information, see Building with Remote Compiler.

For more information about developing applications for the Symbian platform, select Help > Index and look for Platform Notes, or see Platform Notes - Symbian.

Using On-device Debugging Agents

To run and debug applications on Symbian devices from Qt Creator, you must install the CODA on-device debugging agent on the device.

Support for the App TRK on-device debugging agent has been removed from Qt Creator 2.3. Only CODA is supported Qt SDK 1.1.3 onward. It offers the following benefits:

  • Extensive error information
  • Debugging over WLAN
  • Extensive information about the device

Note: CODA does not support debugging over a Bluetooth connection.

Installing Debugging Agents

The CODA installation package is delivered together with Qt SDK. You can find it in the Qt SDK installation folder in the \Symbian\sis\<target>\CODA folder. On Windows, you can use Start menu commands to install CODA on Symbian devices.

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 Tools > Options > Build & Run > 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 Setting Up Qt for Symbian Versions and Adding Tool Chains.

Building and Running Applications

You can test your application on a device by building and running it from Qt Creator for the Symbian Device target.

  1. Connect the device to the development PC through a USB cable. The target selector displays a green check mark when a device is connected.

    The tool tip of the target selector shows more details about the actual device that will be used when you run your application.

  2. Start the CODA debugging agent on the device.
  3. Select Options to select USB as connection type.
  4. Click Projects to edit the Build Settings for the Symbian Device target. Select the Qt version to use for building the application. For more information, see Selecting Qt for Symbian Versions.
  5. Click the Run button in Qt Creator.

Selecting Qt for Symbian Versions

When you select the Qt for Symbian version to build the application with, consider which version provides the application with the widest support on different Symbian platforms. The binary compatibility promise of Qt and Symbian means that applications that are built against Qt 4.6.3 also run on Qt 4.7.3. Similarly, applications that are supported on S60 5th Edition are also supported on Symbian Anna and Belle. However, dependencies, such as Qt Quick or Qt Mobility API versions might restrict the choice of Qt versions that you have.

If you use Qt Quick in the application, you can use S60 5th Edition Qt 4.7.3 to build it. The application is supported on both S60 5th Edition and Symbian Anna and Belle devices. However, if you only target Symbian Anna and Belle, you can use the state of art Qt in the Symbian Anna Qt 4.7.4 target to build the application. This allows you to re-use the application for MeeGo Harmattan devices.

If you want to use the native Symbian Belle APIs and make sure that the application created for earlier Symbian platforms work on Belle as well, use Symbian Belle Qt 4.7.4 to build them. You cannot run such applications on Symbian Anna or earlier Symbian platforms.

Note: The Qt SDK only contains the latest tool chains available for developing applications for a particular Symbian platform. The Qt 4.6.3 for Symbian and Qt 4.7.3 for Symbian^3 and Symbian Anna targets have been removed from Qt SDK 1.1.4. To develop for those targets, use Qt SDK 1.1.2.

If you use native Symbian APIs, you must check that they are available on the target devices. For more information about the API differences between Symbian platforms, see the Symbian Reference Documentation for Qt, which is delivered together with Qt SDK and which you can view in the Help mode.

You can use a set of ready-made UI components called Qt Quick Components for Symbian that enforce a Nokia UI look and feel. Qt SDK updates the Qt Quick Components to version 1.1 that contains usability and other improvements. All devices that support Qt Quick Components for Symbian support version 1.1.

The following table summarizes the supported configurations for each Qt version available in Qt Creator build settings:

Qt VersionQt QuickQt Quick ComponentsQt Mobility VersionNative Symbian C++ APIsQt OpenGL Support
S60 5th Edition Qt 4.7.3 (online installer only)1.0No1.1.3NoNo
Symbian Anna Qt 4.7.41.11.11.2Yes (Symbian Anna APIs)Yes
Symbian Belle Qt 4.7.4 (online installer only)1.11.11.2Yes (Symbian Belle APIs)Yes

Developing Applications Using Qt 4.6.3 or Qt 4.7.3 for Symbian

S60 3rd Edition devices support only Qt 4.6.3, not Qt 4.7 or later. Further, support for the App TRK on-device debugging agent has been removed from Qt Creator 2.3. Only CODA is supported from Qt SDK 1.1.3 onward, and CODA does not support S60 3rd Edition. Therefore, you can no longer run and debug applications from Qt Creator on S60 3rd Edition devices.

The tool chains for developing applications using Qt 4.6.3 for Symbian and Qt 4.7.3 for Symbian^ 3 and Symbian Anna have been removed from Qt SDK 1.1.4. To develop such applications, download and use Qt SDK version 1.1.2 instead. It contains Qt 4.6.3 for Symbian and Qt 4.7.4 for Symbian support for Symbian devices with the Application TRK debug agent.

Note: Problems may arise if you install multiple instances of Qt SDK on the same development PC using the same user account. Use separate user accounts to install them or install them on separate development PCs.

Note: Do not update Qt SDK 1.1.2 with the Qt SDK update tool, because the updater removes App TRK support.

In general, if you use only Qt 4.6 APIs in the application, you can use S60 5th Edition Qt 4.6.3 to build it. The application is supported on both S60 5th Edition and later devices.

The following table summarizes the supported configurations for each Qt version available in Qt Creator build settings if you installed Qt SDK 1.1.2.

Qt VersionQt QuickQt Quick ComponentsQt Mobility VersionNative Symbian C++ APIsQt OpenGL Support
Qt 4.6.3 for Symbian^1 (S60 5th Edition)NoNo1.0.2NoNo
Qt 4.6.3 for Symbian^3NoNo1.0.2Yes (Symbian^3 APIs)No
Qt 4.7.3 for Symbian^3 and Symbian Anna1.01.01.1.3Yes (Symbian Anna APIs)Yes

Advanced Development with Symbian SDK

For normal Qt application development, Qt SDK provides all you need even if the application needs native Symbian OS API access.

However, for more advanced Symbian application development, Nokia provides the Carbide C++ IDE and Symbian C++ SDKs. You can use them also for Qt application development. For example, these SDKs provide Symbian device emulators that are built mostly from the software that the actual devices are running. Therefore, they provide much closer emulation of the device than Qt Simulator.