Qt 4.7.4 Compatibility Issues
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine. Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean. |
[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.