qt5base-lts/dist/changes-5.8.0

498 lines
20 KiB
Plaintext
Raw Normal View History

Qt 5.8 introduces many new features and improvements as well as bugfixes
over the 5.7.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/index.html
The Qt version 5.8 series is binary compatible with the 5.7.x series.
Applications compiled for 5.7 will continue to run with 5.8.
Some of the changes listed in this file include issue tracking numbers
corresponding to tasks in the Qt Bug Tracker:
https://bugreports.qt.io/
Each of these identifiers can be entered in the bug tracker to obtain more
information about a particular change.
This release contains all fixes included in the Qt 5.7.1 release.
****************************************************************************
* License Changes *
****************************************************************************
Static libraries that are linked into executables (winmain and
qopenglextensions) are now licensed under BSD _and_ commercial licenses.
****************************************************************************
* Deprecation Notice *
****************************************************************************
- The following platforms or toolchains are deprecated and will be
removed as of Qt 5.9:
* Apple OS X Mavericks (v10.9)
* Apple iOS 7.x
Deprecated platforms and toolchains continue to work until removed.
- The Q_OBJECT_CHECK macro is deprecated and will be removed in Qt 6. The
internal, template function qt_check_for_QOBJECT_macro that it created in
QObject-derived classes will be removed in Qt 5.9.
****************************************************************************
* Important Behavior Changes *
****************************************************************************
- Support for the following platforms was removed in this version:
* Apple OS X Mountain Lion (v10.8)
* Apple iOS 6.x
configure & build system
------------------------
- The configuration system has been rewritten almost from scratch. This
improved the consistency between builds on Unix and Windows, but some
subtle unintended behavior changes are also possible. Also, some
obsolete options have been entirely removed and will now cause errors.
- It is not permissible any more to manually #define QT_NO_<FEATURE>
anywhere. Instead, configure's -no-feature-* options must be used.
Note that this does not apply to defines which modify behavior rather
than entirely removing features.
- Configure test results are now cached. Use -recheck or -recheck-all
to discard them.
- [QTBUG-32530][QTBUG-42962] The Unix configure won't pick up CFLAGS and
related environment variables any more. Instead, it now accepts QMAKE_*
variable assignments on the command line.
- [QTBUG-52266] Configure won't pick up QMAKESPEC from the environment
any more. Use the -platform option instead.
- Device and simulator libraries are now combined on Apple device
platforms (iOS). This means that there will no longer be any
*_simulator.a libraries and the simulator architectures will simply
reside alongside the device architectures in a single Mach-O file.
- [Darwin] Project files may not override QMAKE_MAC_SDK any more.
QtCore
------
- qFatal will now use std::abort to terminate the application on all
operating systems. Previously, ::abort() or ::exit(1) were called,
depending on the operating system.
- QLibraryInfo::licensee()/licensedProducts() were deprecated and
return empty strings now.
- Destroying a QThread which is still running will now result in
immediate and abnormal program termination.
QtGui
-----
- [QTBUG-54936] QFont::toString() and QFont::key() were modified to save
the font's style name if one is set, invalidating any stored font
identifiers. QFont::fromString() was also adjusted to accommodate the
change.
QtNetwork
---------
- Proxies from system settings will now be used by default. Configure
with -no-system-proxies to disable.
- [QTBUG-53649] libproxy is now turned off by default. Configure with
-libproxy in order to enable it again.
****************************************************************************
* Library *
****************************************************************************
QtCore
------
- Disambiguated the relational operators comparing QByteArray with
QStringRef (and vice versa).
- Added qHash() overloads for QHash, QMultiHash.
- Added QDeadlineTimer, a counterpart to QElapsedTimer, used to mark a
time point in the future (a deadline) and determine whether such a
deadline has passed.
- Qt now relies on type traits from the C++11 standard library.
- [QTBUG-54981] Added Q_NAMESPACE, which can be used to add Q_ENUM_NS/
Q_ENUMS, Q_FLAG_NS/Q_FLAGS and Q_CLASSINFO to a namespace.
- Q_IS_ENUM was deprecated. Use std::is_enum<>::value instead.
- QChar:
* Added missing operator{<,>,<=,>=} comparing against QLatin1String and
QStringRef.
* Added missing operator{==,!=} comparing against QLatin1String.
- QCommandLineOption:
* Added flags() and setFlags() methods. Added ShortOptionStyle and
HiddenFromHelp flags.
- QDateTime:
* Introduced toSecsSinceEpoch, fromSecsSinceEpoch and setSecsSinceEpoch
functions, which use 64-bit integers to represent the number of
seconds.
* The toTime_t, fromTime_t and setTime_t functions are deprecated and
will be removed in Qt 6.0. For new code, use the equivalent functions
with "SecsSinceEpoch" in the name, or the equivalent ones with
millisecond accurancy that have existed since Qt 4.7.
* Added string formatting type Qt::ISODateWithMs.
- QFileInfo:
* QFileInfo now reports file times with millisecond precision on Unix
systems.
- QFileSystemWatcher:
* [QTBUG-55896] Fixed a bug that caused QFileSystemWatcher to mis-handle
file paths that contained non-US-ASCII characters on Apple platforms.
- QJsonDocument:
* [QTBUG-39751] fromVariant can now take a QVariantHash argument.
* Fixed a number of bugs that could cause crashes when loading corrupt
binary JSON data.
- QJsonValue:
* [QTBUG-43077] QJsonValue(Null).toVariant() now returns a QVariant of
type QMetaType::Nullptr instead of an invalid QVariant.
- QLatin1String:
* Added at(), operator[](), mid(), right(), left().
- QLibraryInfo:
* Added QLibraryInfo::version(), which returns the current version of
the Qt library as a QVersionNumber object.
- QLine/QLineF:
* Added center().
- QLockFile:
* Fixed a bug that caused QLockFile to over-sleep while waiting for the
lock file to become available.
- QMetaType:
* std::nullptr_t is now a built-in Qt metatype.
- QModelIndex:
* QModelIndex::child has been deprecated due to its lack of generality.
Use model->index(row, column, index) instead.
- QMutex:
* QMutex now fully models the TimedLockable concept by providing the
try_lock, try_lock_for and try_lock_until functions, therefore making
it usable in Standard Library lock management classes and functions.
- QObject:
* The QT_NO_NARROWING_CONVERSIONS_IN_CONNECT macro has been added. When
using the new connection syntax (PMF-based) this macro makes it
illegal to narrow the arguments carried by the signal, and/or to
perform floating point to integral implicit conversions on them. When
the macro is defined, depending on your compiler a QObject::connect()
statement triggering such conversions will now fail to compile.
- QPersistentModelIndex:
* QPersistentModelIndex::child has been deprecated due to its lack of
generality. Use model->index(row, column, index) instead.
- QStringList:
* Added join(QLatin1String) overload.
- QStringRef:
* Added missing operator{<,>,<=,>=} comparing against QLatin1String and
QString.
- QSysInfo:
* The output of QSysInfo::prettyProductName now includes the Windows
OS/kernel version number. In case of future versions of Windows, a
valid string is now returned.
- QSettings:
* [QTBUG-56124] Fixed a bug that caused QSettings to fail on Apple
platforms when strings with embedded null (\0) bytes were present
- QSharedPointer:
* [QTBUG-52369] Fixed a bug that caused QSharedPointer to fail to compile
if it was initialized with a nullptr literal.
* Fixed a bug that made QSharedPointer delete the pointer it held with the
wrong destructor if the type of the QSharedPointer and that of the object
passed on the constructor were different. Its behavior is now the same as
std::shared_ptr.
- QStandardPaths:
* [QTBUG-55507] Fixed the QStandardPaths::FontsLocation on XDG systems to
be $XDG_DATA_DIR/fonts.
* Fixed handling of potential paths that do not exist on Windows. Now,
QStandardPaths may return storage locations that may not exist on all
platforms.
- QTimer:
* Added support for std::chrono duration objects for QTimer methods,
like QTimer::singleShot and QTimer::setInterval.
- QWaitCondition:
* Added notify_one() and notify_all() to make QWaitCondition be usable from
algorithms that use the Standard Library naming convention.
QtDBus
------
- QDBusConnection:
* Fixed a bug that would cause QDBusConnection::connect() to return true
if a slot was already connected to the same D-Bus signal. QtDBus does
not support multiple connections.
QtGui
-----
- [QFileDialogOptions/QFontDialogOptions/QMessageDialogOptions/
QColorDialogOptions] These classes no longer have value semantics, but
need to be held in QSharedPointer (as they always were). To copy an
instance, use the clone() method.
- QOpenGLTextureBlitter, a utility class to draw textured quads, has been
made public.
- [QTBUG-38825] Fixed QTextEdit to match undo functionality of QLineEdit
to group two sequential inserts into one undo action.
- [QTBUG-51844] Added rotation and uniqueId properties to
QTouchEvent::TouchPoint. This is mainly for the benefit of the TUIO
plugin so far: it now supports tracking physical objects (fiducials)
on the touchscreen surface, as long as the object's ID can fit in a
64-bit integer. QPointingDeviceUniqueId is a wrapper for the ID,
designed to be extensible to support other types of IDs in the future.
- [QTBUG-52510] A stationary touchpoint event is delivered if its
velocity changes. This is to ensure that the application will be
notified when a TUIO fiducial object comes to rest.
- [QTBUG-53076] Add QGuiApplication::applicationDisplayNameChanged()
signal.
- QAbstractTextDocumentLayout:
* Added imageAt() and formatAt() methods, which respectively can be used
to retrieve the source link of the image under the cursor, or the
QTextFormat of the text under the cursor.
- QFont:
* [QTBUG-48043] The default value of QFont::stretch() is now 0 to
indicate any default stretch is acceptable.
- QRegion:
* Is now iterable as a container of QRects: added {c,}{r,}{begin,end}().
- Text handling:
* [QTBUG-51411] Fixed performance hit from showing large QTextDocuments
in a QTextEdit or QTextBrowser. (Regression introduced in Qt 5.3.0)
* [QTBUG-50090] Fixed line spacing with some scalable fonts containing
bitmaps with the Freetype font engine.
* [QTBUG-56346] Fixed QStaticText when manually breaking lines and no
text width was set.
* [QTBUG-56659] Fixed a regression where raster fonts on Windows were
detected as smoothly scalable and thus rendering with said fonts in Qt
Quick would break.
* [QTBUG-51223] Fixed synthesized oblique for non-latin text on
platforms using the basic font database, such as Android.
* [QTBUG-56672] Fixed list of supported sizes for bitmap fonts on
Windows.
* [QTBUG-56714] Fixed a bug where a no-break space would sometimes cause
the first character of the containing line to not be displayed.
* [QTBUG-55856] Fixed rendering of large fonts when a device pixel ratio
is set and the Freetype engine is used.
QtNetwork
---------
- Added QNetworkDatagram class, along with new function receiveDatagram()
in QUdpSocket that returns it, and an overload to writeDatagram() that
can accept it.
- Added QSctpServer and QSctpSocket classes. Note that these need to be
explicitly enabled via a configure option.
- [QTBUG-50956] Added support for HTTP/2 protocol
- QSslSocket:
* [QTBUG-39077] TLS PSK ciphers are possible in server sockets.
* It is now possible to set custom Diffie-Hellman parameters for
QSslSocket-based servers.
- QTcpServer:
* [QTBUG-51288] It is now possible to use QTcpServer with an externally
created QTcpSocket.
QtSql
-----
- QSqlDatabase:
* When connecting to a MySQL server whose version is 5.5.3 or higher,
the default connection charset is now utf8mb4 instead of utf8 to allow
4-byte UTF-8 encodings.
- SQLite:
* Added notification feature to SQLite driver
QTestLib
--------
- [QTBUG-44030] Added QTest::createTouchDevice() for use in autotests
which generate touch events.
- Added ref-cycles perf counter.
- QFETCH variables can now be declared const (QFETCH(const T, name)).
- It is now possible to use variables of types with an explicit operator
bool in the QVERIFY macro.
QtWidgets
---------
- QFormLayout:
* [QTBUG-15990] Added removeRow(), takeRow().
- QMainWindow:
* [QTBUG-56628] Fixed crash using takeCentralWidget when the central
widget was not set.
****************************************************************************
* Platform-specific Changes *
****************************************************************************
- Added technology preview support for Apple tvOS and Apple watchOS.
- Added initial support for Microsoft Visual Studio 2017, which uses the
mkspec "win32-msvc2017". Full support will happen after the final release
of that compiler.
Android
-------
- [QTBUG-48948] Show password while typing is now supported
- [QTBUG-55035][QTBUG-50759] Introduced a mechanism to forward
permission related callbacks on Activity objects to interested
parties.
Apple platforms
---------------
- Added QImage::toCGImage() that returns a CGImage.
- Added functions that convert Qt types QPoint/QPointF, QRect/QRectF and
QSize/QSizeF to and from CGPoint, CGRect and CGSize. Note that QPoint,
QRect and QSize do not provide fromCGXxx functions since that would
silently lose precision.
iOS
---
- Precompiled headers are now supported on iOS.
- Starting from iOS 10, Apple requires all apps that need access to photos
to have the key 'NSPhotoLibraryUsageDescription' in the Info.plist.
Therefore, to get the same support in Qt (when, e.g., using a file
dialog), the Info.plist assigned to QMAKE_INFO_PLIST will need this key
as well.
macOS
-----
- Speech to text dictation now works for Qt text input.
- [QTBUG-33708] Fixed underline position in font rendering.
Linux
-----
- [QTBUG-39959] QWidget-based applications running on the eglfs platform
plugin can now request 180 or 90 degrees rotated output by setting the
QT_QPA_EGLFS_ROTATION environment variable.
- KDE/Gnome themes now implement QPlatformTheme::fileIconPixmap(), showing
file icons.
Windows
-------
- [QTBUG-31476] QFactoryLoader now filters potential plugins by the
".dll" suffix.
- [QTBUG-56239] 'What's this' button is now shown by default only for
QWidget dialogs.
- [QTBUG-53833] QProcess::startDetached() changed behavior on Windows:
it no longer creates a new console window unconditionally, instead it
passes the same creation flags to CreateProcess as QProcess::start().
- Text handling:
* [QTBUG-54740] Fixed embedding fonts in PDF when dpi scaling is active
or when the hinting preference was none or vertical hinting.
* [QTBUG-47485] Fix selecting non-regular fonts when using the Freetype
engine.
* [QTBUG-49346] Fixed rendering error when using the MingLiU fonts at
certain combinations of pixel size and scale.
****************************************************************************
* Tools *
****************************************************************************
configure & build system
------------------------
- The -no-feature-* option family was integrated with the rest of the
configuration system. Numerous existing features were made optional,
and build problems in various reduced configurations were fixed.
This is an ongoing effort known as "Qt Lite".
- Numerous Qt modules outside qtbase now support configure options.
In a module-by-module build, these can be passed to qmake itself,
after a -- option.
- Introduced the qtConfig(<feature>) qmake function to replace the
patterns contains(QT_CONFIG, <feature>) and load(qfeatures)+
contains(QT_DISABLED_FEATURES, <feature>).
Likewise, the C++ macro QT_CONFIG(<feature>) was introduced to
replace the pattern !defined(QT_NO_<FEATURE>).
The old methods are effectively deprecated and will stop working at
some point in the near future.
- Use of -sysroot will now trigger a cross-build even if -platform and
-xplatform are the same.
- The JPEG & GIF handlers and the SQL drivers are now always built as
plugins, even in static builds (static "plugins" in this case).
- [GCC] Include paths from system libraries are now marked as such,
resulting in fewer warnings the user cannot do anything about.
- [Windows] config.status.bat is now created, like on Unix.
- [QTBUG-46974] Fixed location of config.status in top-level builds.
- [QTBUG-38792][Unix] The -redo option is now accepted, like on Windows.
- It's now possible to add more arguments when -redo is used. Note that
these arguments are not saved in turn. Likewise for config.status.
- [QTBUG-32896][iOS/clang] Added missing CFBundleIdentifier to library
template.
- [QTBUG-47624] Fixed abort when some, but not all, XCB dependencies
are met. The feature is now disabled instead, as expected.
- [QTBUG-50838] The Raspberry Pi EGL detection now uses pkg-config.
- [QTBUG-52112][Android] Plugins now have a SONAME, as required by
Android 6+.
- [QTBUG-54438] Fixed launching tests, examples, and build tools in
some configurations.
- [QTBUG-56289][GCC@Windows] Fixed -separate-debug-info.
- [QTBUG-57086] Added support for Visual Studio 2017.
qdbusxml2cpp
------------
- [QTBUG-34126] qdbusxml2cpp now supports the --verbose switch, which
provides more details when parsing invalid XML sources.
qmake
-----
- Added the $$take_first(), $$take_last(), $$num_add(), $$str_size(),
$$str_member(), and $$sorted() functions.
- The error() function can now be called without arguments to exit
silently. Use after write_file() and similar functions which already
print an error message.
- The $$system() function can return the command's exit code now.
- The $$prompt() function can now print the prompt verbatim.
- QMAKE_EXTRA_TARGETS will now consistently treat the target as a file
name (separator adjustment and quoting).
- [QTBUG-16904][VS] Fixed warning about circular dependencies when
Q_OBJECT is used in .cpp files.
- [QTBUG-36256] packageExists() and PKGCONFIG can now be used
regardless of whether Qt itself was built with pkg-config support.
- [QTBUG-43468][WinRT] Added option to use verbatim manifest files.
- [QTBUG-53905] Fixed OBJECTIVE_SOURCES being moc'd twice.
- [QTBUG-55591][VS2015] Added support for the /DEBUG:FASTLINK option.
- [QTBUG-56507] Fixed parallel builds when a lex source refers to a
file generated from a yacc source.
- [QTBUG-56594][MSVC] Fixed PDB files not being installed for static
libraries.
moc
---
- [MSVC] qmake and moc now cooperate to use the Visual Studio environment
variables (set by the VCVARSALL.BAT script) to find system include
files. A possible consequence is that moc parses application headers
slightly differently, depending on #if conditions that depended on
macros that previous versions had not seen #define'd. Implementers of
other buildsystems are advised to pass the --compiler-flavor=msvc option
to moc.