43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# KDDockWidgets and QtQuick
|
|
|
|
## Supported Qt versions and toolchains
|
|
|
|
KDDockWidgets for QtQuick requires a C++17 capable compiler and Qt >= 6.2.1.
|
|
|
|
Qt 5.15.2 will probably also work, but it's not built and tested by KDAB CI, we
|
|
advise users to move to Qt6 as soon as possible.
|
|
|
|
## Build instructions
|
|
|
|
Doing a default build will build a KDDW library that's suitable for both QtWidgets and QtQuick development.<br>
|
|
This is in contrast with 1.x version, where a separate build for QtQuick was required.
|
|
|
|
You can however be explicit and exclude the QtWidgets support:
|
|
|
|
`cd build && cmake -DKDDockWidgets_FRONTENDS=qtquick ..`
|
|
|
|
## Troubleshooting
|
|
|
|
- QtGraphicalEffects is not supported, as it's buggy when moving between different QWindows.
|
|
See for example QTBUG-94943, KDDockWidgets issue #213. Also search the Qt bug tracker
|
|
for "QQuickItem: Cannot use same item on different windows at the same time"
|
|
|
|
- Very rarely, in some Nvidia/X11 setups, floating/docking has noticeable lag (like 1 second)
|
|
This could be solved by going to Nvidia's settings and making sure all monitors have
|
|
the same refresh rate and disabling "Allow Flipping". It's not known why this solves it. Might also
|
|
be a bug in Qt.
|
|
|
|
- `"EGLFS: OpenGL windows cannot be mixed with others"` QtQuick on EGLFS does not support having more
|
|
than 1 window. This is a known QtQuick limitation. The QtWidgets stack worksaround this by compositing
|
|
all windows into a single native window.
|
|
|
|
- `module "QtQuick.Controls" is not installed`
|
|
|
|
Set the `QML_IMPORT_PATH` env var pointing to your Qt qml plugin dir or check the
|
|
Qt documentation on how to deploy QtQuick applications.
|
|
|
|
```bash
|
|
# Replace with your actual path
|
|
export QML_IMPORT_PATH=/home/user/Qt/5.15.2/gcc_64/qml
|
|
```
|