Qt Reference Documentation

Getting started with Qt Quick Components for Symbian

This page provides you basic information for developing applications that utilize Qt Quick Components for Symbian. It decribes the development environment and instructs how to create an application and run it on a device. It also provides you useful links for deepening the knowledge about application development.

Development Environment

Qt Quick Components for Symbian have been tested using the following compilers:

The latest Qt SDK contains the development tools and Qt libraries in a single package. However, if you want to install Qt libraries separately, notice the Qt version requirements:

  • Qt Quick Components 1.1 for Symbian requires Qt 4.7.4 or newer.
  • Qt Quick Components 1.0 for Symbian requires Qt 4.7.3 or newer. Qt SDK's 1.1.4 and newer versions do not support application development using this Qt Quick Components version.

In Qt SDK version 1.1.4, Qt Quick Components 1.1 for Symbian is available in the following targets:

  • Desktop
  • Qt Simulator
  • Symbian with the following configurations:
    • Qt 4.7.4 for Symbian Anna
    • Qt 4.7.4 for Symbian Belle

Note: The Symbian toolchain is only available for Windows. Developers using Linux or Mac OS must use the Remote Compiler to build Symbian binaries.

Qt Quick Components for Symbian is targeted for Symbian Anna and later Symbian platforms.

Qt Quick Components for Symbian SIS Packages

On the standard Qt SDK installation, the compiled and signed SIS files are found in <QtSDK installation directory>\Symbian\sis\Symbian_Belle\QtQuickComponents\1.1 directory. These SIS files are for development and demonstration purposes. Utilize Nokia Smart Installer for Symbian when releasing your application to a wider audience.

Creating and running a Qt Quick Components for Symbian application

The following instructions guide you how to first create an application that utilizes Qt Quick Components for Symbian and then run it on a phone. The instructions apply to the Windows environment. Before you start to perform the steps below, make sure that you have the latest Qt SDK installed on your PC.

  1. Create a new Qt Quick Application project that utilizes Qt Quick Components for Symbian:
    • Start Qt Creator.
    • Create a new project in Qt Creator: Select File > New File or Project...
    • Choose a template: Select Qt Quick Project > Qt Quick Application and press Choose...
    • Enter Introduction and Project Location data, for example Name: Test and Create in: C:\ and press Next.
    • Select Ot Quick Application Type: Select Qt Quick Components for Symbian and press Next.
    • In Target Setup dialog, make sure that Symbian Device and Qt Simulator are selected and press Next.
    • In Symbian Specific dialog press Next.
    • In Summary dialog press Finish.
  2. Connect the target phone to PC with a USB cable. For more information, see Connecting Symbian Devices.
  3. Select Projects > Symbian Device > Run > Create SIS package and tick Create Smart Installer package.

    "Symbian device's run settings"

  4. Start the application by pressing the Run button.

    .

    If necessary, Smart Installer package downloads and installs the required Qt, Qt Mobility, and Qt Quick Components for Symbian packages to your phone.

  5. Accept all installation messages on the phone.

    The Test application looks like this:

    "Hello World application"

  6. Close the application and disconnect the USB cable from the phone.

Where to Go from Here

Visit the following guides that demonstrate the components usage and view the examples and demo applications.

Additional information