Qt 4.7.4 Compatibility Issues

[toc align_right="yes" depth="3"]

List of compatibility issues in the Qt 4.7.4 Release Bundle

PLEASE NOTE: THIS PAGE IS UNDER WORK AND WILL RECEIVE UPDATES SHORTLY

This documents lists the noteworthy breaks in binary or functional compatibility in the Qt 4.7.4 release bundle. In Qt and related components terms this means the following updates:

• Qt 4.7.3 -> 4.7.4
• Mobility 1.1.3-> 1.2.0
• Qt Quick Components 1.0 -> 1.1

At its current form the list focuses on problems seen on Symbian platform.

h2. Stricter QML import version checking

Import version number must now be correct. Previously a too big version number was ignored, and the latest version was used. Example: In Qt 4.7.3: “import QtMultimediaKit 1.2” is accepted, but the latest version 1.1 is used In Qt 4.7.4: “import QtMultimediaKit 1.2” produces an error “module ”QtMultimediaKit" version 1.2 is not installed import QtMultimediaKit 1.2”

h2. Changes in Mobility QML bindings

• QML Map (http://doc.qt.nokia.com/qtmobility-1.1/qml-map.html ) is re-implemented in Qt Mobility 1.2. While the only direct break is the removal of objects property, there are many functional changes ( http://doc.qt.nokia.com/qtmobility-1.2/qml-map.html ). Usage of old QtMobility.location 1.1 import is not recommended. Use "import QtMobility.location 1.2" instead.

• QML DeviceInfo ( http://doc.qt.nokia.com/qtmobility-1.1/qml-deviceinfo.html) has several methods removed. Please see http://doc.qt.nokia.com/qtmobility-1.2/qml-deviceinfo.html for new equivalent properties.

' startBatteryLevelChanged' method removed, set monitorBatteryLevelChanges property to true instead ' startBatteryStatusChanged' method removed, set monitorBatteryStatusChanges property to true instead ' startPowerStateChanged' method removed, set monitorPowerStateChanges property to true instead ' startCurrentProfileChanged' method removed, set monitorCurrentProfileChanges property to true instead ' startBluetoothStateChanged' method removed, set monitorBluetoothStateChanges property to true instead

• QML NetworkInfo ( http://doc.qt.nokia.com/qtmobility-1.1/qml-networkinfo.html ) has several methods removed. Please see http://doc.qt.nokia.com/qtmobility-1.2/qml-networkinfo.html for new equivalent properties.

' startStatusChanged' method removed, set monitorStatusChanges property to true instead ' signalStrengthChanged' method removed, set monitorSignalStrengthChanges property to true instead ' modeChanged' method removed, set monitorModeChanges property to true instead ' currentMobileCountryCodeChanged' method removed, set monitorMobileCountryCodeChanges property to true instead ' currentMobileNetworkCodeChanged' method removed, set monitorMobileNetworkCodeChanges property to true instead ' mode' method removed

• QML DocumentGalleryModel documentation( http://doc.qt.nokia.com/qtmobility-1.1/qml-documentgallerymodel.html ) had several signals which did not actually exist. The documentation is now updated at http://doc.qt.nokia.com/qtmobility-1.2/qml-documentgallerymodel.html

' onCancelled' ' onFailed' ' onFinished' ' onSucceeded'

h2. PowerState property removed from QSystemInfo

The PowerState property in QSystemInfo has been removed in Qt Mobility 1.2. Use the currentPowerState property instead. See documentation: http://doc.qt.nokia.com/qtmobility-1.1/qsystemdeviceinfo.html http://doc.qt.nokia.com/qtmobility-1.2/qsystemdeviceinfo.html

h2. QSystemInfo usage from different threads in Symbian

There are some considerations when using QSystemInfo methods in other threads than the main thread. Documented in: http://doc.qt.nokia.com/qtmobility-1.2/qsystemstorageinfo.html More info in: https://bugreports.qt.nokia.com/browse/QTMOBILITY-1058 This change has taken place between Mobility 1.1.3 and 1.2.0

h2. Qt Quick Components import changes in Symbian

“import Qt.labs.components.native 1.0” will not work anymore after components 1.1 has been installed on device. 1.1 is pre-installed on newer Belle releases. Use “import com.nokia.symbian1.0” instead.

h2. Qt Quick Components Window anchoring changes in Symbian

This change is listed here for future reference. The actual change is not in Symbian Belle but in a future Symbian update. It is still advised to update your application now.

Any child items should not be anchored to the Window root item directly, but refer to parent instead: Wrong (child anchoring refers to the Window id):

Window {

id: root
Statusbar { anchors.top: root.top }
ToolBar { anchors.bottom: root.bottom }
}

Correct (child anchoring refers to the parent):

Window {
id: root
Statusbar { anchors.top: parent.top }
ToolBar { anchors.bottom: parent.bottom }
}

(link to documentation to be added later)

h2. Orientation detection in QWidget –based Symbian application

Using QApplication::desktop()->availableGeometry() during the resize event to detect orientation will produce wrong results. The recommended method is to connect to QApplication::desktop()'s workAreaResized(int) signal and call QApplication::desktop()->availableGeometry() in the connected slot function.

This break has been introduced between Qt 4.6 and 4.7, so it already applies to Symbian Anna. See https://bugreports.qt.nokia.com//browse/QTBUG-14058 for more info.