Qt 5.5 introduces many new features and improvements as well as bugfixes over the 5.4.x series. For more details, refer to the online documentation included in this distribution. The documentation is also available online: http://doc.qt.io/qt-5.5 The Qt version 5.5 series is binary compatible with the 5.4.x series. Applications compiled for 5.4 will continue to run with 5.5. Some of the changes listed in this file include issue tracking numbers corresponding to tasks in the Qt Bug Tracker: http://bugreports.qt.io/ Each of these identifiers can be entered in the bug tracker to obtain more information about a particular change. **************************************************************************** * Deprecation Notice * **************************************************************************** - Support for the following platforms or toolchains is deprecated in Qt 5.5 and will be removed as of Qt 5.6: * Apple OS X builds using GNU libstdc++ * BlackBerry 10 * QNX 6.5 The following platforms or toolchains are deprecated and will be removed as of Qt 5.7: * Apple OS X 10.7 (Lion) * GNU Compiler Collection (GCC) versions 4.6 and earlier * Microsoft Visual Studio compiler versions 2008 and 2010 * Microsoft Windows XP, Windows Vista * Microsoft Windows Embedded Compact 7 Deprecated platforms and toolchains continue to work until removed. - The QtWebKit and QtQuick1 modules and support for the QML 1 language are deprecated and Qt 5.5 will be the last release to include them. Starting with Qt 5.6, the source code for those modules will not be included in Qt's packaging. Compiling the 5.5 release of QtWebKit modules along with Qt 5.6 or future versions should work. QtQuick1 is not guaranteed to work in future versions after Qt 5.6. - The QtScript module is deprecated and will be removed from Qt's packaging starting with version 5.7. The 5.5 and 5.6 releases of QtScript should continue to work along with Qt 5.7 and future versions. - [QTBUG-25121] The usage of the QStyleOptionProgressBar::orientation member has been deprecated. - QLibraryInfo::buildDate() was deprecated and will return a constant date now. **************************************************************************** * Future Direction Notice * **************************************************************************** - In Qt 6, QCoreApplication::notify() will not be called for events being delivered to objects outside the main thread. The reason for that is that the main application object may begin destruction while those threads are still delivering events, which is undefined behavior. Applications that currently override notify() and use that function outside the main thread are advised to find other solutions in the mean time. - Qt 5.7 will begin requiring certain C++11 features in order to compile. The minimum compiler versions for that release will be: * Clang 3.2 (included in XCode 5.0) * GCC 4.7 * Intel C++ Composer XE 2013 SP1 (compiler version 14.0) * Microsoft Visual Studio 2012 (compiler version 17.0) **************************************************************************** * Important Behavior Changes * **************************************************************************** - Q_ASSERT will now expand the condition even in release mode when asserts are disabled, albeit in an unreachable code path. This solves compiler warnings about variables and functions that were unused in release mode because they were only used in assertions. Unfortunately, codebases that hid those functions and variables via #ifndef will need to remove the conditionals to compile with Qt 5.5. - QDBusConnection::sender() (deprecated since Qt 4.3) has changed to always return an invalid QDBusConnection. To know what connection the incoming call was received from, use QDBusContext. - QHostAddress will no longer convert IPv6 addresses of type "v4-mapped" to IPv4. To perform this conversion manually, construct another QHostAddress with the result of toIPv4Address(). - (DY)LD_LIBRARY_PATH will no longer "stick" in the process environment when starting a QProcess. This means that if a QProcess is started with a clear environment, it will not specially inherit (DY)LD_LIBRARY_PATH from the parent process. This should not affect most applications, but if the old behavior is desired, one can simply pass a clear QProcessEnvironment with the (DY)LD_LIBRARY_PATH values added, to the QProcess. - QAbstractTableModel and QAbstractListModel now reimplement sibling() to avoid calling parent() (which returns a constant). Subclasses of these models that override parent(), will likely also need to override sibling() now. - Qt 5.5 received some header #include cleanups. Code that relied on indirect includes from Qt headers may need to include some headers explicitly now. For example, qstringlist.h no longer includes QDataStream and QObject. - QCoreApplication: * [QTBUG-30330][QTSOLBUG-184] On Windows, QCoreApplication::arguments() now returns a list built from argv on Windows as well if a modified argv was passed to the class' constructor. - QIODevice: * Opening Android assets with QIODevice::ReadWrite now returns false to correctly indicate that the files are not writable. - QItemDelegate: * [QTBUG-3305] QItemDelegate will now not close a QTextEdit/QPlainTextEdit editor when the tab key is pressed; instead, the key will reach the editor. - QProgressDialog: * [QTBUG-17427][QTBUG-25316] The timer for estimating the duration of the progress dialog is now started in the constructor and in setValue(minimum()), as well as when calling setValue(0), as previously documented. - QSaveFile: * [QTBUG-44086] Files created by QSaveFile do now have the same rights as files created by QFile. This also fixes a regression in QSettings: In the Qt 5.4 series, new files created by QSettings were only readable by the current user. - QVariant: * [QTBUG-42722] QVariant now obeys the C++ type promotion rules when comparing numeric types (integrals, float and double), including the fact that unsigned comparisons are preferred for types of the same rank (that is, now QVariant(-1) > QVariant(0U)). - QWindow: * QWindows will no longer be re-shown automatically when moved from a destroyed QScreen, unless that QScreen was a virtual sibling of the primary screen. - qmake: * For commercial builds, qmake now checks for a valid Qt license. This requires setting up a Qt Account (or .qt-license file) on the development machine. * Qt configure and qmake used with a MinGW spec will no longer emulate MSVC by picking up the INCLUDE and LIB environment variables. Use the -I/-L configure options to pass additional paths, as you would under Unix. * A lot of quoting issues have been fixed. As a side effect, qmake has become more sensitive to over-quoted file names in project files. * qmake is now stricter about syntax errors in project files. **************************************************************************** * Library * **************************************************************************** QtCore ------ - Added qEnvironmentVariableIntValue(). - Added Q_DECL_RELAXED_CONSTEXPR for the corresponding C++14 feature - Added qHashRange() and qHashRangeCommutative() functions to aid implementing qHash() overloads for custom types. - Q_ENUMS and Q_FLAGS have been deprecated, and replaced by Q_ENUM and Q_FLAG macros. These two new macros automatically register the enum with the Qt metatype system, allowing automatic conversion to or from string in QVariant, or to show the strings by QDebug operators. They also enable the new QMetaEnum::fromType function. - QPersistentModel index becomes an built-in meta-type, including QVariant support. - Updated Unicode data to v.7.0 - Updated QLocale data to CLDR v.27 - Updated QTimeZone data to CLDR v.27 - Item Models: * QItemSelectionModel can now be created without a model and have one set later. - Logging: * QtInfoMsg got added as a new QtMsgType. Use the new qInfo(), qCInfo() macros to log to it. - Logging framework: * %{threadid} now prints the real thread ID. On Linux, OS X, iOS, FreeBSD and Windows, the value is unique system-wide. On other systems, it will print something that may be process-specific (the value of pthread_self(3)). To print the pointer to QThread::current(), use %{qthreadptr}. - moc * Classes annotated with Q_GADGET can now have Q_PROPERTY and Q_INVOKABLE functions. QMetaProperty::{read,write}OnGadget and QMetaMethod::invokeOnGadget can be used with those. - Objective-C: * [QTBUG-37116] Added NSDate/CDateRef converters for QDateTime - QAssociativeIterable: * Added find(). - QCommandLineParser: * Message boxes are used to display errors and usage if no console window can be obtained on Windows. - QDebug: * Printing of QStrings and QStringRefs whenever "noquote" is not active now prints the strings in a format that can be copied back to C++ code. All characters that aren't printable in US-ASCII are escaped (this includes printable Unicode characters outside of US-ASCII). Pretty-printing will not respect QTextFormat padding or field widths. * Similarly, printing of QByteArrays whenever "noquote" is not active now prints the arrays in a format consumable in C++, with all non-printable characters printed in hex escape sequences. - QJsonObject: * Added conversion to and from QVariantHash - QLibrary: * Added DeepBindHint which maps to RTLD_DEEPBIND on Linux making it possible to load libraries with external symbols that clash with already loaded ones, such as plugins linked to Qt4. - QLockFile: * [QTBUG-45497] Detection of stale lock files got more robust and takes the name of the process that belongs to the stored PID into account. - QRegularExpression: * Support for matching using QStringRef as the subject's string type has been added. - QSet: * Can now be used as the key in QSet and QHash. - QSortFilterProxyModel: * [QTBUG-35440] QSortFilterProxyModel now properly forwards the roles that have been changed when the source model emits dataChanged(). - QStandardPaths: * [QTBUG-38872][QTBUG-38845] Added QStandardPaths::AppConfigLocation, for application-specific configuration directory. ConfigLocation was inconsistent. - QString: * Added support for retrieving the QRegularExpressionMatch to indexOf and lastIndexOf. * Added QT_RESTRICTED_CAST_FROM_ASCII macro as less intrusive alternative to QT_NO_CAST_FROM_ASCII. * Added methods for convenient conversion to and from std::u16string and std::u32string. * Added asprintf(), vasprintf(). - QThreadPool: * Added QThreadPool::cancel() which allows removing from the job queue a job that hasn't been started yet. - QTimeZone: * Added methods systemTimeZone() and utc() that return QTimeZone objects for the system time zone and for UTC, respectively. - QVector: * Added QVector::append(const QVector &) overload - QVector3D: * Added convenience project and unproject methods to use like gluProject and gluUnproject - QtMath: * qmath.h no longer includes math.h, so any sources depending on that indirect inclusion may fail to build. - State Machine: * Added support for internal transitions. * [QTBUG-40293] Added an addTransition() overload that takes a pointer-to-member for the signal triggering the transition. * [QTBUG-44963] Fixed an issue where a history state restore would activate too many states, possibly putting the state machine in an invalid state. * QTBUG-44783] Fixed an issue where the state machine could end up in an invalid state when transitions from a parallel state were not checked for conflicts. * Fixed a case where a parallel state was not exited and re-entered when one of its substates was exited and subsequently re-entered. * Fixed the non-deterministic behavior of picking a transition from a set of conflicting transitions. QtDBus ------ - Added annotation org.qtproject.QtDBus.MethodName to allow autogenerating C++ methods with different names to the original DBus method QtGui ----- - Added support for device-specific backend plugins in eglfs. - eglfs is now using fullscreen mode also when running on X11. - Added a plugin to get mouse, keyboard and touch events via libinput. - The linuxfb platform plugin's input device handling is now compatible with eglfs. The evdev keyboard, mouse and touch code is compiled in by default. - The mouse cursor on Embedded Linux is now handling hotplugging correctly with eglfs and linuxfb regardless of how the input handling code is loaded (via a generic plugin or built in to the platform plugin). - QOffscreenSurface is now relying on EGL_KHR_surfaceless_context when available, and avoids creating a pbuffer surface when the extension is present. - initializeOpenGLFunctions() no longer needs to be called when querying a versioned function wrapper object via QOpenGLContext::versionFunctions(). - Added version function classes for OpenGL 4.4 and 4.5 and deprecate some erroneously classified functions. - Exposed TabFocusBehavior in QStyleHints - [QTBUG-42240][QTBUG-43263] Qt now contains a built-in GPU driver blacklist for Windows that disables the usage of desktop OpenGL with some older cards that are known to be unstable with opengl32.dll. - [QTBUG-44937] Support for QScreen::grabWindow() is now available on embedded platforms (eglfs, linuxfb). - Added QStyleHints::singleClickActivation to access whether the platform expects item activation to occur on single clicks rather than double clicks. - [QTBUG-40034] QOpenGLWidget and QQuickWidget are now supported on iOS. - Accessibility: * [QTBUG-44479] Qt now reports text attributes correctly on Linux, so ORCA+F now works properly in QTextEdit and other text controls. - Accessibility / OS X: * QTextEdit now properly reports to accessibility visual lines (softlines) as lines, instead of whole paragraphs. This allows better VoiceOver user experience when reading text line by line using arrows up/down. * Visual bounds returned by QTextEdit were singificantly improved; this enables VoiceOver to draw properly positioned VoiceOver cursor. - Image plugins: * [QTBUG-37946][QTBUG-43563][QTBUG-45552][QTBUG-45865] An option has been added to QImageReader to enable automatic application of EXIF orientation. This behavior was default in Qt 5.4.1, but reverted in Qt 5.4.2. - QFontDatabase: * Added QFontDatabase::isPrivateFamily() - QImage: * Added support for grayscale and alpha 8-bit formats which can also be rendered to. - QPainter: * [QTBUG-35830] QPainter will no longer try to replace IntersectClip with ReplaceClip if the paint engine is a QPicture. - QPlatformSurfaceEvent: * [QTBUG-42476][QTBUG-42483] Added event class QPlatformSurfaceEvent, which is sent to QWindow and QOffscreenSurface when native surface is created or about to be destroyed. - QQuaternion: * Added methods to convert a quaternion to/from Euler angles and to/from rotation matrix. - QScreen: * Added devicePixelRatio property. - QTextDocument: * Support for searching with a QRegularExpression in a document has been added. - QWheelEvent: * On OSX, trackpad wheel event phase transitions now occur in the order ScrollBegin, ScrollUpdate, ..., ScrollEnd, ScrollUpdate, ..., ScrollEnd, where the second batch of updates represents momentum events (inertial scrolling). - QWindow: * [QTBUG-32956] lastWindowClosed will now be emitted even if quitOnLastWindowClosed is not set. - Windows: * [QTBUG-43263] Introduced experimental feature allowing the user to specify a GPU driver buglist with some additional keywords to chooose the GL renderer backend depending on GPU. - i18n: * [QTBUG-43447] Fixed bug where layout direction did not switch according to the instruction in the translation file. - Text: * [QTBUG-39286] Fixed position of underline on centered text when the text layout's width is an even number. QtNetwork --------- - [QTBUG-26295] Introduced libproxy backend for Unix platforms, enabled automatically if the required dev package is present - As some legacy ifdefs for OpenSSL 0.9.7 and 0.9.8f were removed, Qt will no longer build with these versions. In addition, there is no longer support for an OpenSSL library built with NO_TLSEXT. - [QTBUG-26538] Fixed a bug that caused both QTcpSocket and QUdpSocket to close the socket and lose any bound ports before connecting. Now bind()/setSocketDescriptor() followed by connect() will retain the original file descriptor. - QLocalSocket: * [QTBUG-16688] On Windows, waitForReadyRead now always waits for more data, even if bytes are still in the buffer. - QNetworkAccessManager: * It is now possible to use TLS PSK ciphersuites when using HTTPS (or similar protocols working over SSL). - QSslSocket: * [QTBUG-39077] It is now possible to use TLS PSK ciphersuites in client sockets. * A new SSL backend for iOS and OS X, implemented with Apple's Secure Transport (Security Framework). - SSL/TLS support: * [QTBUG-18972] It is now possible to parse elliptic curve certificates. * It is now possible to choose which elliptic curves should be used by an elliptic curve cipher. QtTest ------ - QCOMPARE now pretty-prints QSizePolicy{,::Policy,::ControlType{,s}}. - QtTest now prints an escaped version of QByteArrays that failed to compare with QCOMPARE, instead of the hex dump. - QTest::toString() can now be overloaded (instead of just specialized) for custom types, and is now reliably found through argument-dependent lookup (ADL). QtWidgets --------- - Added QPlainTextEdit::createStandardContextMenu(QPoint) overload that takes the position in document coordinates. This method enables the actions that are sensitive to the given position eg. where the user clicked. - Accessibility / OS X: * VoiceOver users of QTextEdit can now use mouse and touch exploration on trackpad to point at text to have spoken to them. - Layouts: * [QTBUG-43099] Fixed a bug where spans sometimes didn't distribute themselves to the last cells they covered. - QAbstractItemView: * Added iconSizeChanged signal. - QAbstractScrollArea: * [QTBUG-8315] A getter for the viewport margins has been added. - QComboBox: * A QComboBox does not reset itself any more when setting the same model more than once. * [QTBUG-43350] QComboBox will now reset its root model index when a new model is set on it. - QHeaderView: * [QTBUG-21201] Auto-scroll the view when making extended row/column selections. * Default section size is now style-dependent by default. * Added resetDefaultSectionSize(). - QMenu: * [QTBUG-20094] QMenu now pick up how "sloppy" submenus behave from the style. - QOpenGLWidget: * [QTBUG-40717] Added an UpdateBehavior flag to QOpenGLWidget and enabled support for NoParitalUpdate for QOpenGLWidget. NoPartialUpdate is the default update behavior for QOpenGLWidget. - QSizePolicy: * QSizePolicy::ControlTypes is now introspectable through QSizePolicy's meta object. - QToolButton: * [QTBUG-23396] Fixed the double removal of ampersands. - QTreeWidget: * [QTBUG-40060] Restored Qt 5.1 behavior of QTreeWidgetItems with ItemIsTristate to enable automatic management of the check state. User-editable tristate checkboxes are now enabled by setting the new flag ItemIsUserTristate. **************************************************************************** * Platform Specific Changes * **************************************************************************** - Removed BlackBerry PlayBook support. Android ------- - [QTBUG-43705] Fixed canonical path for nonexistent paths on some devices. - [QTBUG-38700] On devices with translucent system UI, Qt's windows are now positioned to avoid overlapping it. This behavior can be overridden in the application's AndroidManifest.xml. - [QTBUG-45430] Fixed a bug that caused applications not to be resumable after user changed language in system settings. - QtCore / QTimeZone: * [QTBUG-35908] Android timezones are now available in QTimeZone. - QtWidgets: * Enable QDockWidget window decorations. - The QtDBus module is now disabled by default. - Added support for arm64-v8a, x86_64, and mips64 with gcc 4.9. OS X ---- - [QTBUG-43999] QApplication::setWindowIcon now changes the icon for the application in the dock. - Text: * [QTBUG-44708] Fixed appending text with a different writing system and formatting to a latin ligature. Windows ------- - QMimeData: * [QTBUG-17373] Added support for handling dropping of multiple mail attachments, adding ;index=N to the mimetype string application/x-qt-windows-mime;value="FileContents" - Text: * [QTBUG-44501] Fixed design metrics for text X11/XCB ------- - GLX and EGL code paths are now dynamically resolved, making it possible for one build of a plugin to use both code paths. The default is to use the GLX code path if available. This can be overridden by specifying QT_XCB_GL_INTEGRATION=xcb_egl as an environment variable. Enable the logging category qt.xcb.glintegration.debug to get debug log output of what integration is used. - [QTBUG-31762] QSystemTrayIcon now uses StatusNotifier D-Bus protocol when the desktop environment supports it - [QTBUG-40174][QTBUG-42985] If all QScreens (xcb outputs) are disconnected while an application is running, QGuiApplication::primaryScreen() will now return null until a screen is connected again. **************************************************************************** * Compiler Specific Changes * **************************************************************************** - Qt 5.5 now unconditionally uses the "using" keyword. Compilers that do not support this keyword are deprecated and will not be able to build Qt. Previous versions of Qt may or may not compile, as no testing was done to ensure it worked. - Visual Studio: -Zm200 (an option to specify the precompiled header memory allocation limit) is not added anymore by qmake to the compiler calls. If you encounter an C1076 compiler error you might need to re-add it in your .pro file. **************************************************************************** * Tools * **************************************************************************** configure & build system ------------------------ - Added support for VS2015. - [QTBUG-31814][OS X/iOS] Qt is now built with a relative RPATH. - [VS2012+] Qt is now always built with C++11 with these compilers. - [Windows] Added -static-runtime option. - Added support for GCC/Clang -fsanitize= options. - Enabled tslib autodetection by default. - Added configure-time check for IPC support. - [QTBUG-44690][QNX] Fixed NEON detection when cross-compiling on Windows. - On-device compilation should work better on RaspPi and some other devices now (use linux-g++ mkspec). - configure -redo and config.status support spaces in arguments now. - Qt can be now built in and installed to directories with spaces. Note that source directories with spaces are still not supported. qmake ----- - [QTBUG-3069][Linux] Building with -rpath will now create DT_RUNPATH tags instead of DT_RPATH, allowing LD_LIBRARY_PATH to override the rpath. - [QTBUG-41917][VS] Fixed project generation when PRECOMPILED_SOURCE is in a different directory than PRECOMPILED_HEADER. - [QTBUG-42454][MinGW] Added handling of QMAKE_MANIFEST. - [QTBUG-13496][MSVC] CONFIG+=no_batch is now automatically added when multiple sources with the same base name exist. - Added $$[QT_INSTALL_PREFIX/dev], etc. properties which reflect the on-device locations of Qt (the -prefix, etc. passed to configure). - Building under MSys is less problematic now. - [QTBUG-37269] Fixed cross-compilation for Unix on Windows/MinGW. - [QTBUG-8202][QTBUG-20566][QTBUG-44685] Fixed distclean targets. - [QTBUG-43162][VS] Added DISTFILES support for Visual Studio projects. - [QTBUG-41753][VS][WinPhone] Fixed MdilXapCompile deployment step. - [QTBUG-44960][VS] Reworked .dll deployment. Added $$QMAKE_DLL_PATHS. - [QTBUG-44823][MSVC] Fixed unreasonable values being passed in /VERSION. Added $$VERSION_PE_HEADER to override the value. - [WinRT] The icon handling was reworked/extended. - [QTBUG-12711] Fixed infinite recursion on malformed .prl files. **************************************************************************** * Third-party libraries * **************************************************************************** - [QTBUG-44815][QTBUG-37660][QTBUG-44694][QTBUG-42443] ANGLE was updated to Chromium branch 2356 (2.1~99f075dade7c).