Release note

Qt 6.1 introduces many new features and improvements as well as bugfixes
over the 6.0.x series. For more details, refer to the online
documentation included in this distribution. The documentation is also
available online:

https://doc.qt.io/qt-6/index.html

The Qt version 6.1 series is binary compatible with the 6.0.x series.
Applications compiled for 6.0 will continue to run with 6.1.

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.

To make it easier to port to Qt 6, we have created a porting guide to
summarize those changes and provide guidance to handle them. In the
guide, you can find links to articles about changes that may affect your
application and help you transition from Qt 5.15 to Qt 6:

https://doc.qt.io/qt-6/portingguide.html

Important Changes

qtbase

9a186e1da7 Fix license information for libjpeg-turbo
Clarified that libjpeg-turbo is actually covered by three licenses, not
only IJG.
02a5580292 macOS: allow Qt::AA_DontShowShortcutsInContextMenus
overrides
The shortcutVisibleInContextMenu property defaults to the value of the
Qt::AA_DontShowShortcutsInContextMenus attribute, which in turn defaults
to the platform integration. To override the default, set the
application attribute after instantiating QApplication, or override the
default for each QAction instance.

qtwayland

c0ef4aa9 client: Gracefully handle shutdown and window hiding
Fixed a crash that could happen when hiding or closing windows while Qt
Quick was actively rendering on a different thread.

qt3d

eb0011ba1 Fix multi-view picking
Non rendered entities (due to layer filtering) are no longer pickable

qtimageformats

f111501 Update bundled libtiff to version 4.3.0
Bundled libtiff was updated to version 4.3.0

qtvirtualkeyboard

6201217 Fix high CPU utilization caused by key repeat timer
Fixed high CPU utilization caused by key repeat timer.
062e4d0 Disable Windows IME when Qt Virtual Keyboard plugin is loaded
Disable Windows IME when Qt Virtual Keyboard plugin is loaded

qtquick3d

4a08fa54 Fix the occlusionMap to be compatible with GLTF2
This patch changes how occlusionMap works in QQuick3DMaterial.
Previously occlusionMap influences on all the diffuse colors and
emissive colors. Now it will not affect punctual lightings.(For now it
will affect only IBL.) The result of a lancelot test,
principled/occlusion.qml, will be changed because it does not have
IBL.(The occlusionMap will be ignored.) There will be 4 rows in the new
test. Top 2 rows are without IBL, and others are with IBL in their
materials.

Fixes

qtbase

QTBUG-49771 Backspace key is not working when CapsLock is on
QTBUG-88651 Can't Hide Menu Separator
QTBUG-92488 When a QComboBox is set to use Fusion style after changing
the size adjust policy to AdjustToContents then it will cut off the last
item in a list and force it to be scrollable
QTBUG-93736 QCombobox last item become inaccessible when a listview is
used in popup
QTBUG-92583 QListVIew page turning error
QTBUG-93504 Running automoc with --collect-json stalls during cmake
build with Makefiles
QTBUG-94064 D3D11 debug layer warning is printed when having a vertex
shader with no inputs
QTBUG-36565 Some key symbols generated by xkb level 3 shift don't work
in QTextBrowser, QTextEdit, QLineEdit
QTBUG-94070 Memory corruption in sqlite plugin
QTBUG-93174 QtDeviceUtilities doc build doesn't produce .qch file
QTBUG-89754 Reg->6.0/Linux/CMake build : QtGui has dependency on
libopengl0
QTBUG-93600 90° X rotation as quaternion produces NaN on euler angle
QTBUG-83089 NameFilters not working in FileDialog in Android 10
QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying
QTBUG-83089 NameFilters not working in FileDialog in Android 10
QTBUG-77771 A Double click on QtreeView/QTreeWidget index is emitting
two clicked() and one doubleClicked() signal
QTBUG-92266 vertical space before video on
https://doc.qt.io/qt-6/gettingstarted.html
QTBUG-94057 QLineEdit should be enter editing status when FocusIn
QTBUG-92234 QTranslator.load problem by skipping some
QTBUG-93431 Android: build system dependencies are wrong
QTBUG-86754 [Reg 5.12.4-> 5.12.5]Action text overlaps the shortcut in
menu when padding is used
QTBUG-94269 QIntValidator: integer values exceeding top "intermediate"
according to validate() func
QTBUG-93868 Fix unnoticed regression after merging the fix for UNC
path handling
QTBUG-92232 [REG] Option Clicking Window Close Button Crashes App
QTBUG-64543 When starting a drag scroll via QScroller in a listview
there will be a slight jump right before the scrolling starts
QTBUG-50866 QTabBar scroll buttons overlap tabs
QTBUG-70498 Cannot scroll first tab right, using scroll button in
QTabBar, when tab size do not fit into visible rect.
QTBUG-91025 Should mention that QPrint Support is not available for
iOS
QTBUG-94248 Check scrollbar ScrollBarOverlap when computing QListView
margins
QTBUG-27640 QToolButton::menu-arrow{image:none;} does not work in
Custom TitleBar
QTBUG-86362 [Reg 5.14 to 5.15.0] macOS: Tabbed QDockWidgets not
properly drawing the tabs
QTBUG-93742 Error in public function "setclearbuttonenabled" of
"QLineEdit" control
QTBUG-94211 Windows Long Path issue for RelWithDebInfo config
QTBUG-71894 Hangul composition bug
QTBUG-94264 When building for Android, instead of an apk, just .so is
built
QTBUG-91120 QDate::fromString() fails on isolated dates on macOS with
TZ=Europe/Lisbon
QTBUG-94400 /EHsc flag removal wrong
QTBUG-94347 QRandomGenerator64 refers to functions as static, aren't.
QTBUG-94470 Incorrect parsing of HTTP2 frame headers.
QTBUG-94032 Command line is too long when building large projects
QTBUG-76948 IOS: disconnect second screen while app in b/g, it crashes
when app goes into foreground
QTBUG-93764 QPrintPreviewDialog: printer orientation not updated by
QPageSetupDialog
QTBUG-94532 Markdown checkboxes are clipped when text range selected
QTBUG-62102 QKeySequenceEdit handles meta keys incorrectly on Wayland
QTBUG-93360 Compile Qt with gcc 11
QTBUG-94043 MSVC warning C4996: 'ID2D1Factory::GetDesktopDpi':
Deprecated. Use DisplayInformation::LogicalDpi for Windows Store Apps or
GetDpiForWindow for desktop apps.
QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying
QTBUG-91147 Correct wrong snippet paths reported by CI
QTBUG-94194 Qt 6.1/6.1.1 compilation fails after MSVC 2019 16.10
update with "/std:c++latest" compiler flag
QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying
QTBUG-94264 When building for Android, instead of an apk, just .so is
built
QTBUG-85714 QOpenGLWidget with NativeWindow QDockWidget does not
render when undocked
QTBUG-87263 QMap compilation error
QTBUG-60822 [REG: 4->5] WA_TranslucentBackground cannot be changed
after widget has been shown
QTBUG-38776 QDockWidget titlebar icons are not drawn with high DPI
QTBUG-64543 When starting a drag scroll via QScroller in a listview
there will be a slight jump right before the scrolling starts
QTBUG-88248 QObject orphaned connections soft-leak

qtdeclarative

QTBUG-94022 Visiting FolderListModel's Qt 6 documentation results in
404
QTBUG-93880 MultiPointHandlers (DragHandler, PinchHandler) don't emit
the grabChanged signal
QTBUG-91549 WheelHandler enables itself although deactivated
QTBUG-94067 Runtime error in qv4stackframe
QTBUG-79163 DragHandler steals events from a MouseArea with
preventStealing = true
QTBUG-93489 Not obvious how to generate key events for QML when using
QQuickRenderControl
QTBUG-94502 Crash on Android caused by automatic type conversion
between JS array and QVariantList (SIGBUS)
QTBUG-90869 tst_qquickdesignersupport: tests segfault when running on
QEMU and Windows MinGW developer build
QTBUG-33179 QML revisioning does not work for grouped properties

qttools

QTBUG-94345 Qt Designer crash in QQuickWidget plugin
QTBUG-74353 Qt Assistant doesn't take stylesheet into account with
search result view
QTBUG-94510 Failed to generate docs during qt5.git#6.1
QTBUG-94555 qdoc: Broken links to \internal or \dontdocument nodes
QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

qttranslations

PYSIDE-1598 PySide6 QTranslator can not load qm files

qtdoc

QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

qtwayland

QTBUG-92249 quick3d examples crashes or hangs on exit on wayland

qtquickcontrols2

QTBUG-93039 Crash when scrolling ScrollView with zero-sized item
QTBUG-93994 QML ComboBox hide error
QTBUG-93958 Crash with ScrollView + TextArea + Item when the app is
closing
QTBUG-55705 SwipeDelegate is not swiping inside SwipeView
QTBUG-77946 tst_QQuickDrawer::Universal::position(right) failed on
Linux openSUSE_15_0 (gcc-x86_64)
QTBUG-94251 tst_QQuickPopup fails with OpenSUSE 15.3

qtcharts

QTBUG-94469 Doc: Wrong return type for QValueAxis::labelFormat qml
property

qtdatavis3d

QTBUG-90665 RenderingMode changing does not work correctly
QTBUG-90371 The labels for the bars are not displayed when property
"Rotate horizontally" set max to the right
QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

qtvirtualkeyboard

QTBUG-93997 Warnings with virtual keyboard in Qt 6
QTBUG-94259 High CPU load on embedded targets caused by timers
QTBUG-93042 Program crashed when type with keyboard
QTBUG-94560 The first item of selection list sometimes get highlight
QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

qtscxml

QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart
QTBUG-94144 Incorrect Qt version numbers on Qt 6.1.1 source code
package

qtnetworkauth

QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

qtquicktimeline

QDS-4403 Errors with imported 3D component, DS built with Qt 6.1

qtquick3d

QTBUG-94185 Misplaced Joint{} element may crash application
QTBUG-94230 Node method map***() causes crash if node if null
QTBUG-94263 Balsam seems to interpret a sphere parented under leaf
joint as joint
QDS-4399 Properties missing for some components
QDS-4477 Imported Qt3DStudio project looks different in DS built with
Qt6.1 compared to QDS 2.1
QTBUG-94453 Rectangles can't be used for light probs in View3D
QTBUG-94453 Rectangles can't be used for light probs in View3D

qt5compat

QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake
counterpart

Known Issues

Check that your system meets Qt's requirements:
https://doc.qt.io/qt-6/gettingstarted.html#platform-requirements
RTA reported issues from Qt 6.1
https://bugreports.qt.io/issues/?filter=22879
Supported development platforms are listed here:
https://bugreports.qt.io/browse/QTBUG-86432

Linux

Minimum glibc version for prebuild binaries is still 2.28, see
https://bugreports.qt.io/browse/QTBUG-88833.
Workaround: compile Qt 6.1.2 by yourself or update glibc to 2.28 or newer

Windows

Wrong rendering in Dialog with native Windows style
https://bugreports.qt.io/browse/QTBUG-91755

Android

Old openssl version used on Linux hosts
https://bugreports.qt.io/browse/QTBUG-94355
https://bugreports.qt.io/browse/QTQAINFRA-4501

Credits for the release goes to:

Aavitsland Eirik
Agocs Laszlo
Astals Cid Albert
Bennett Nicholas
Blomfeldt Eskil Abrahamsen
Bornemann Joerg
Boudjelthia Assam
Buddenhagen Oswald
Butirsky Andrey
Croitor Alexandru
Curtis Mitch
D'Angelo Giuseppe
Edelev Alexey
Faure David
Ferrer Josep Ma.
Gustavsen Richard Moe
Haixiang Tang
Halmet Heikki
Hao Zhang
Hartmann Thomas
Heikkinen Jani
Heikkinen Miikka
Heimrich Karsten
Hermann Ulf
Hilsheimer Volker
Jensen Allan Sandfeld
Jokiniva Jukka
Kleint Friedemann
Knoll Lars
Kobus Jarek
Koehne Kai
Koivikko Jarkko
Kosmale Fabian
Krus Mike
Kushnir Igor
Köhne Kai
Lee Inho
Leinonen Tony
Lemire Paul
Liu Haoyu
Löhning Robert
Nikiforov Aleksei
Nordheim Mårten
Ollila Kimmo
Pocheptsov Timur
Reinio Topi
RuiJie Fan
Rutledge Shawn
Shaw Andy
Strømme Christian
Suzuki Tasuku
Varanka Sami
Vertriest Nico
Vestbø Tor Arne
Vuolle Juha
Welbourne Edward
Wicking Paul
Wolff Oliver
Xinwei Li
Zhang JiDe