qt6windows7/dist/changes-5.10.0

577 lines
22 KiB
Plaintext
Raw Normal View History

2023-10-30 06:33:08 +08:00
Qt 5.10 introduces many new features and improvements as well as bugfixes
over the 5.9.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.10 series is binary compatible with the 5.9.x series.
Applications compiled for 5.9 will continue to run with 5.10.
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.
****************************************************************************
* Important Behavior Changes *
****************************************************************************
- [QTBUG-60857] The names of the roles returned by
QSqlQueryModel::roleNames now only include a name for the
Qt::DisplayRole. Previously all the roles names of QSqlQueryModel were
returned.
- QFileInfo on empty strings now behaves like the default-constructed
QFileInfo. Notably, path() will now be the empty string too, instead of
".", which means absoluteFilePath() is no longer the current working
directory.
- QTemporaryFile:
* rename() no longer attempts to do block copying, as that usually
indicates a mistake in the user's code. Instead, either create the
temporary file in the same directory as the new name to be, or use
QSaveFile.
* On Linux, QTemporaryFile will attempt to create unnamed temporary
files. If that succeeds, open() will return true but exists() will be
false. If you call fileName() or any function that calls it,
QTemporaryFile will give the file a name, so most applications will
not see a difference.
- Windows:
* [QTBUG-62662] On Windows, a drag & drop operation of local file URIs,
like QListView items backed by a QFileSystemModel, will result in the
attachment or opening of the files by the target application, instead
of the creation of hyperlinks.
****************************************************************************
* General Notes *
****************************************************************************
Deprecation Notice
------------------
- Starting with Qt 5.10, IPv6 support is mandatory for all platforms.
Systems without proper IPv6 support, such as the getaddrinfo() function
or the proper socket address structures, will not be able to build
QtNetwork anymore.
- QSignalMapper is now marked as deprecated.
Potentially Source-Incompatible Changes
---------------------------------------
- QByteArray:
* qbytearray.h no longer includes qstring.h. In particular, this means
that in order to use QStringBuilder with QByteArray, you need to
include both qbytearray.h and qstring.h now (or <QByteArray> and
<QString>, resp.).
- QStaticText:
* The QStaticText(const QString &) constructor is now explicit.
Third-Party Code
----------------
- PCRE2 has been updated to version 10.30.
- Replaced bundled libjpeg by libjpeg-turbo 1.5.2
- Improve documentation about Freetype 2 licenses.
- Sqlite was updated to version 3.20.1
****************************************************************************
* Library *
****************************************************************************
QtCore
------
- Added qHash(QStringView).
- [QTBUG-37253] Added QMetaObject::invokeMethod() overloads for function
pointers.
- [QTBUG-41006] Added qEnvironmentVariable, which returns the value of an
environment variable in a QString, while qgetenv continues to be used to
return it in a QByteArray. For Unix, since most environment variables
seem to contain path names, qEnvironmentVariable will do the same as
QFile::decodeName, which means NFC/NFD conversion on Apple OSes.
- [QTBUG-62915] qAddPostRoutine() and qRemovePostRoutine() are now
thread-safe.
- Containers:
* Added an STL-like iterator to go through QHash/QMap returning both the
key and the value of the element pointed to. That lets QHash/QMap
interoperate better with stl's algorithms like std::set_union.
- JSON:
* QJsonArray, QJsonDocument, QJsonObject and QJsonValue now have move
operations and a swap() member function.
- Logging:
* If you set QT_FATAL_WARNINGS to a number n > 1, Qt will stop the
application on that n-th warning, instead of on the first. For the
sake of compatibility with previous versions, if the variable is set
to any non-empty and non-numeric value, Qt will understand it as "stop
on first warning".
- QByteArray:
* Added shrink_to_fit() for compatibility with the Standard Library. This
function does the same as squeeze().
- QChar:
* Added constructors from char16_t and, on Windows, wchar_t.
- QCoreApplication:
* [QTBUG-57095] Calling QCoreApplication::translate() is now
thread-safe.
- QCryptographicHash:
* [QTBUG-59770] In order to preserve compatibility with earlier versions
of Qt, QCryptographicHash is now able to calculate Keccak message
digests. Please see the release notes for Qt 5.9.2 for more details.
- QDate/QTime/QDateTime:
* Added toString() overloads taking the format as a QStringView.
* [QTBUG-22833] Added support for parsing of time-zones.
- QDebug:
* Added streaming of QStringViews.
- QFile:
* [QTBUG-984] Added fileTime() and setFileTime().
- QFileInfo:
* [QTBUG-984] Added fileTime().
* Deprecated created() because it could return one of three different
file times depending on the OS and filesystem type, without the
ability to determine which one is which. It is replaced by
metadataChangeTime() and birthTime().
* Added QFileInfo::metadataChangeTime(), which returns the time the
file's metadata was last changed, if it is known, and falling back to
the same value as lastModified() otherwise. On Unix systems, this
corresponds to the file's ctime.
* Added QFileInfo::birthTime(), which returns the file's birth time if
it is known, an invalid QDateTime otherwise. This function is
supported on Windows and on some Unix systems.
- QIODevice:
* Added skip() method to improve performance in read operations.
- QLatin1String:
* Added isEmpty(), isNull().
* Added iterators, {c,}{r,}{begin,end}().
* Added chopped(), chop(), truncate().
* Added startsWith(), endsWith().
* Added a constructor taking two pointers, complementing the constructor
that takes a pointer and a length.
* Added trimmed() function.
- QLocale:
* Added toString(QDate/QTime/QDateTime) overloads taking the format
string as a QStringView.
* Added QLocale::formattedDataSize() for formatting quantities of bytes
as kB, MB, GB etc.
- QLockFile:
* Fixed a bug that would cause QLockFile to mis-identify valid lock
files as stale if the application name was set with
QCoreApplication::setApplicationName().
- QMimeType:
* Add Q_GADGET, so that QML applications can make use of QMimeType's
properties and methods.
- QObject:
* [QTBUG-60339] Added connect() support for move-only function objects.
- QProcess:
* [QTBUG-2058][QTBUG-2284][QTBUG-37656][QTBUG-52405][QTBUG-57687] Added
non-static QProcess::startDetached to support more features for
detached processes.
* [QTBUG-2284] Added the ability to set a custom process environment for
detached processes.
* [QTBUG-52405] Added the ability to specify native arguments for
detached processes on Windows.
* [QTBUG-2058][QTBUG-37656] Added support for standard channel
redirection using setStandard{Input|Output|Error}File to
QProcess::startDetached.
- QSaveFile:
* [QTBUG-47379] Saving to Alternate Data Streams on NTFS on Windows is
now possible, but requires setDirectWriteFallback(true).
- QSemaphore:
* Added a new RAII class, QSemaphoreReleaser, to reliably perform
release() calls.
- QSettings:
* [QTBUG-47379] Added setAtomicSyncRequired(), which allows one to use
QSettings with config files in unwriteable directories or in Alternate
Data Streams on NTFS on Windows. This used to work before Qt 5.4, but
remains a non-default behavior due to the potential of data
corruption.
- QSortFilterProxyModel:
* QSortFilterProxyModel now does not emit an unnecessary layoutChanged()
following a model reset.
- QStandardPaths:
* On Windows, QStandardPaths now also looks into
"<APPDIR>/data/<APPNAME>" for non-generic paths.
- QString:
* Added arg(QStringView), arg(QLatin1String) overloads.
* Added shrink_to_fit(), for compatibility with the Standard
Library. This function does the same as squeeze().
- QString/QStringRef:
* Added startsWith(), endsWith() overloads taking QStringView.
- QString/QStringRef/QByteArray:
* Added chopped(n), a const version of chop(n).
- QString/QStringRef/QByteArray/QLatin1String:
* Added front() and back() for STL compatibility.
- QStringBuilder:
* Added support for (non-const) char*.
- QStringList:
* Added contains(QLatin1String) overload.
- QStringRef:
* trimmed() now returns an empty string-ref for an empty input. Before,
it would return a null one.
- QStringView:
* New class, superseding const QString and QStringRef as function
parameters, accepting a wide variety of UTF-16 string data sources,
e.g. u"string", std::u16string{,_view}, and, on Windows, L"string",
std::wstring{,_view} without converting to QString first.
- QTemporaryDir:
* The class now supports the "XXXXXX" replacement token anywhere in the
template, not just at the end. This behavior is similar to what
QTemporaryFile supports.
- QTextCodec:
* Added fromUnicode() and canEncode() overloads taking QStringView.
- QTextEncoder:
* Added fromUnicode() overload taking QStringView.
- QThread:
* Added the QThread::create() function.
* An exception escaping from QThread::run() will now result in immediate
and abnormal program termination. The same applies if an exception
leaves a slot connected directly to the QThread::started() or
QThread::finished() signals.
- QUuid:
* Added fromString(QStringView/QLatin1String).
- QVariant:
* QVariants containing pointers will now return true on isNull() if the
contained pointer is null.
- QVarLengthArray:
* Added shrink_to_fit(), for compatibility with the Standard Library.
- QVector:
* Added shrink_to_fit(), for compatibility with the Standard Library.
- QVersionNumber:
* Added QStringView and QLatin1String overloads of fromString().
- QtGlobal:
* Q_ASSERT() and Q_ASSERT_X() now always expand to expressions of type
void that are usable in constexpr contexts. This makes them usable in
both C++11 and C++14 constexpr functions and in comma expressions.
QtGui
-----
- [QTBUG-55981] Added support for rendering to QWindow via the Vulkan
graphics API.
- [QTBUG-55981] Added QVulkanWindow, a convenience subclass of QWindow.
- Added support for the OpenGL ES 3.2 API in QOpenGLExtraFunctions
- [QTBUG-50987] Added support for requesting OpenGL windows with
sRGB-capable default framebuffers. While this is implicit on some
platforms, QSurfaceFormat now has the necessary flags to request such
windows in a cross-platform manner.
- High DPI variants of 9-patch images can now be loaded using the
following syntax: "foo@2x.9.png"
- It's now possible to retrieve the screen at a given point via
QGuiApplication::screenAt().
- Important Behvior Changes:
* [QTBUG-56848][QTCREATORBUG-17683] Changed CSS line-height property
with multiplier to follow CSS spec
- Tablet support:
* [QTBUG-44964] If the application attribute AA_CompressTabletEvents is
set in addition to AA_CompressHighFrequencyEvents, even the
QTabletEvents will be compressed (only on the X11 platform so far).
AA_CompressHighFrequencyEvents does not enable compression of tablet
events by itself, because paint applications typically need to process
all possible tablet events in order to draw the smoothest curves.
- QPA:
* [QTBUG-57608] QWindowSystemInterfacePrivate::handleGeometryChange no
longer takes the old geometry as an argument.
- QImage:
* QImages can now use more than 2GByte of pixel data.
- QCursor:
* Added equality operators.
- QImageWriter:
* Add QImageWriter::InvalidImageError to communicate invalid attempts to
write a bad QImage (for instance, a null QImage).
- QMovie:
* Added lastError and lastErrorString accessors, as a convenience over
connecting to the error() signal.
- QWindow:
* setMask() no longer requires the window to be created to have an
effect; it can be set at any time.
- Text:
* [QTBUG-56728] Added QFont::PreferNoShaping style strategy to support
improvements to performance at the expense of some cosmetic font
features.
- Windows:
* [QTBUG-55967] Native menus have been implemented.
* A native system tray icon is now available for SystemTrayIcon.
QtNetwork
---------
- [QTBUG-56102] QSslSocket can now use a temporary keychain on macOS.
- Fixed a proxy-authentication issue, after a wrong password has been used,
when supplying the right password.
- HTTP/2:
* [QTBUG-61397] In case of clear text HTTP/2 we now initiate a required
protocol upgrade procedure instead of 'H2Direct' connection.
- QHostInfo:
* Added swap() and move operator.
- QLocalServer:
* [QTBUG-55043] Added a function to retrieve the socket descriptor.
- QNetworkAccessManager:
* [QTBUG-63075] Added support for HTTP status 308.
- QNetworkInterface:
* [QTBUG-51922] Changed allAddresses() to not include addresses found in
inactive interfaces, matching the user expectations of this function.
If those addresses are needed for some purpose, the application can
call allInterfaces() and obtain the addresses in each interface.
- QNetworkProxy:
* [QTBUG-45495] Setting of network proxies is now supported on UWP.
* [QTBUG-45495] UWP now supports proxies using SOCKS5.
* The functions related to QNetworkConfiguration are deprecated. They've
performed no action since Qt 5.0, so code using them can safely stop
doing so.
- QSslSocket:
* [QTBUG-52905] Added OpenSSL 1.1 backend.
QtSql
-----
- QSqlError:
* Added swap().
- SQLite:
* Named placeholder can now be used. If compiling Qt by hand and using
system libraries, this feature requires at least SQLite 3.3.11.
* [QTBUG-18084] Added QSQLITE_ENABLE_REGEXP connect option for the SQLite
backend. If set, a Qt based regexp() implementation is provided
allowing use of REGEXP in SQL statements.
QtTest
------
- [QTBUG-53381] Added keySequence() function.
- QCOMPARE:
* Can now be used for mixed-type comparisons.
* Now outputs contents of QPair and std::pair on failure.
* Now supports printing QStringViews in case of test failures.
QtWidgets
---------
- The windowsxp style is no longer available as a separate style, because
it did not (and cannot) actually provide an XP-style appearance on
currently supported Qt platforms.
- Added AA_DisableWindowContextHelpButton attribute. Setting this
attribute globally prevents the automatic "What's this" button on
dialogs on Windows (WindowsContextHelpButtonHint).
- [QTBUG-56860] Fixed widget losing focus after showing menu second time.
- [QTBUG-47185][QTBUG-61280] QOpenGLWidget is now able to render and
return its content via grabFramebuffer(), QWidget::grab() or
QWidget::render() even when the widget has not been made visible.
- [QTBUG-10907] When tabbing to a widget with focus proxy, focus will now
be given to the proxy rather than just being ignored.
- ItemViews:
* Made it easier to drop above and below items.
- QAbstractItemView/QTreeWidget/QTableWidget/QListWidget:
* [QTBUG-61139] Added isPersistentEditorOpen().
- QDockWidget:
* When QMainWindow::GrouppedDragging and QMainWindow::AllowNestedDocks
are both enabled, floating dock widgets now have the ability to be
dropped together side by side.
* [QTBUG-63526] Fixed an issue in QDockWidgets where the widget would
not resize despite showing a resize cursor.
- QFusionStyle:
* The default palette used by the platform-agnostic Fusion style has
been desaturated. Previously the window background color, and other
colors derived from it, were brown shades. Now these colors are
neutral gray that fit better on any desktop.
- QInputDialog:
* [QTBUG-17547] Added setDoubleStep to enable changing of the step
amount for getDouble().
- QLineEdit:
* Added selectionEnd(), selectionLength(), complementing
selectionStart().
- QOpenGLWidget:
* [QTBUG-50987] Added support for specifying custom internal texture
formats in QOpenGLWidget in order to make it possible to have the
widget backed by an sRGB-capable framebuffer.
- QSplashScreen:
* All constructors now implicitly set Qt::FramelessWindowHint, not just
the (pixmap, flags) one.
- QWidget:
* [QTBUG-10907] QWidget::setTabOrder() will now preserve the local tab
order inside a widget if it has a focus proxy set to an inner child.
- Styles:
* Added SH_Widget_Animation_Duration style hint which supersedes
SH_Widget_Animate, which is now deprecated.
- Text:
* Introduced tabStopDistance property in QTextOption, QTextEdit and
QPlainTextEdit as replacement for the inconsistently named tabStop and
tabStopWidth properties. QTextOption::tabStop, QTextEdit::tabStopWidth
and QPlainTextEdit::tabStopWidth are now deprecated.
****************************************************************************
* Platform-specific Changes *
****************************************************************************
- [QTBUG-60268] Input context is now supported with the offscreen platform.
Android
-------
- QtLoader: Enabled loading shared libraries from /system/lib or a custom
path specified with the android.app.system_libs_prefix metadata variable in
AndroidManifest.xml. This supports deploying Qt apps as Android system
apps.
- [QTBUG-58060] Android dialogs now have more appropriate button layouts,
with affirmative actions on the right.
- [QTBUG-59175] QWidget::createWindowContainer() is now supported on
Android for embedding OpenGL-based QWindows into widget UIs.
iOS
---
- [QTBUG-59403] Support added for using the input panel as a trackpad
using two-finger swipe.
- The minimum deployment target for applications is now iOS 10.0.
Linux
-----
- Qt uses the statx(2) system call for obtaining file information on
kernels 4.12 and later. Some older container systems install system call
protection rules that do not include this system call. If you experience
problems running Qt applications inside containers (such as the report of
a file not existing when it does), ensure the statx(2) is allowed in the
container configuration.
- Linux/XCB:
* Added screen product information from EDID.
- eglfs/KMS:
* Screen modes, including current and preferred ones, are now listed.
* Added screen product information from EDID.
Windows
-------
- Accessibility:
* MinGW builds now support IAccessible2.
- Fonts:
* [QTBUG-62176] Some key fonts, such as Calibri, were being detected as
bitmap fonts and not rendered correctly in Qt Quick. This has now been
fixed.
X11
---
- Native painting (instead of software rasterization) has been experimentally
re-introduced. Enabled by the configure option -xcb-native-painting.
- XInput device property changes are now detected at runtime (no
application restart required).
- [QTBUG-60513][QTBUG-29278][QTBUG-43768][QTBUG-18380] The _NET_WORKAREA
atom is used for calculating QScreen::availableGeometry() only on systems
with one monitor. In all other cases QScreen::availableGeometry() is
equal to QScreen::geometry(). To restore the legacy behavior with
untrustworthy values in QScreen::availableGeometry() set
QT_RELY_ON_NET_WORKAREA_ATOM=1 in the environment.
- The QT_XCB_NO_XI2_MOUSE environment variable is deprecated and will be
removed in Qt 6. If your application relies on behavior set by
QT_XCB_NO_XI2_MOUSE, it should be updated accordingly.
- Pointer event delivery on X11 is now done starting from XInput version
2.0 (when available) instead of 2.2. XInput support can be disabled by
setting QT_XCB_NO_XI2=1 in the environment; note that doing so will also
disable tablet and touch support.
****************************************************************************
* Tools *
****************************************************************************
moc
---
- moc now supports NOTIFY signals of parent classes in Q_PROPERTY
qmake
-----
- [QTBUG-1581] Introduced the variable OBJECTIVE_HEADERS.
- [QTBUG-11117][nmake] Added support for precompiled header also for
plain C files.
- Added versionAtLeast() and versionAtMost() test functions.
- If you use CONFIG+=qmltestcase with no SOURCES, 'make check' will now
run qmltestrunner for you.
- [Darwin] Added support for Info.plist in non-bundle apps and libs.
uic
---
- [QTBUG-51602] Added the no-stringliteral option, to be used for building
shared objects which are meant to be unloadable.
- Old images embedded in ui files, imported from Qt 3, are now ignored.
uic will now behave consistently with Qt Designer - both will ignore
them.