Connecting Symbian DevicesWhen 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 PC Suite or Ovi Suite are installed on 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. As with every supported platform, Qt strives to maintain application behavior and binary compatibility throughout the lifetime of the Qt 4.x major version and on the Symbian devices that support Qt. Symbian support in Qt SDK and Ovi Store were introduced with Qt 4.6. Each Qt release contains bug fixes that might change the API behavior and thereby affect application compatibility. In addition, Symbian devices have different input methods, such as different keyboard styles or touch input, screen sizes, memory, and CPU and GPU capabilities. Therefore, you must test applications on specific target devices to ensure compatibility. In order to build applications that are supported also on earlier devices, select the target in Qt SDK carefully. Generally, an earlier target (such as S60 5th Edition) is supported on a larger number of devices than a later target (such as Symbian Belle). 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^3 and later devices, some version of Qt is pre-installed. 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, see Qt on Symbian Devices. To run and debug applications on Symbian devices from Qt Creator, you must install the CODA on-device debugging agent on the device. For more information, see Using On-device Debugging Agents. 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. To run your applications in the Symbian emulator, you also need to install Carbide.c++ v2.0.0 or higher. Qt on Symbian DevicesGenerally, when developing for Symbian^3 or later devices, you do not need to install Qt on devices. However, you might want to upgrade or downgrade the Qt version on a device to test your application on a particular Qt version. Use the installation packages delivered with Qt SDK (<QtSDK_install_path>\Symbian\sis). Keep in mind that this might replace the pre-installed Qt on the device. Note: Earlier Qt for Symbian versions, such as Qt 4.6.3 for Symbian, are only available in the Qt SDK online installer. For more information, see Installing Qt SDK. Qt is supported on different Symbian platforms as follows:
To check the Symbian platform version of your device, see Device Specifications. The site contains information about the content that can be published for the device to the Ovi Store (General section) and the Qt libraries that are pre-installed on the device (API section). If the device does not have the necessary Qt libraries pre-installed, you can use Nokia Smart Installer for Symbian to deploy them during application installation. Smart Installer ensures that the necessary libraries are available in the target Symbian device before installing the actual application. For more information about which Qt modules are supported on-demand for different Symbian device models and how to enable Smart Installer support in Qt applications, see Nokia Smart Installer for Symbian. Selecting Qt Versions in Qt CreatorWhen you select the Qt 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^3. However, dependencies, such as Qt Quick or Qt Mobility API versions might restrict the choice of Qt versions that you have. In general, if you use only Qt 4.6 APIs in the application, you can use Qt 4.6.3 for Symbian^1 to build it. The application is supported on both Symbian^1 and Symbian^3 devices. If you use Qt Quick in the application, you can use Qt 4.7.3 for Symbian^1 to build it. The application is supported on both Symbian^1 and Symbian^3 devices. 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^1 and Symbian^3, 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. The following table summarizes the supported configurations for each Qt version available in Qt Creator build settings:
Using On-device Debugging AgentsSupport for the App TRK on-device debugging agent has been removed from Qt Creator 2.3. Only CODA is supported. It offers the following benefits:
Note: CODA does not support debugging over a Bluetooth connection. Installing Debugging AgentsCODA installation packages are delivered together with the Qt SDK. On Windows, you can use Start menu commands to install CODA on Symbian devices. You can also download CODA from the CODA download server. Setting Up Qt CreatorWhen 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... > Qt4 > 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. X
|