aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSergey Silin <moonhound@gmail.com>2024-02-13 02:49:42 +0300
committerSergey Silin <moonhound@gmail.com>2024-03-30 08:54:32 +0000
commit340f1d7b427641f48fbc1e8807f5bb681ecd4386 (patch)
tree15d1f547f5e0a63ee0b7b323ebcd15564f80cf38
parent3ca0deef536d33163256fee9a50895f1ee5e4a75 (diff)
Add a README section for xcb plugin problem
Linux users may encounter a problem of missing xcb plugin while using Qt6 built from sources. Missing plugin prevents QtCreator from starting with default settings. The new section provides solution gathered from Qt forum Change-Id: I2917965c99fa6a05feac0d1506c7e60ff63796b1 Reviewed-by: hjk <hjk@qt.io> Reviewed-by: Eike Ziller <eike.ziller@qt.io>
-rw-r--r--README.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/README.md b/README.md
index 9f4b6f1457..71f02d884e 100644
--- a/README.md
+++ b/README.md
@@ -107,6 +107,33 @@ get LLVM.
cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja "-DCMAKE_PREFIX_PATH=/path/to/Qt;/path/to/llvm" /path/to/qtcreator_sources
cmake --build .
+#### Troubleshooting: libxcb plugin not found while using Qt libraries built locally from source
+
+Ensure all prerequisites for building Qt are installed:
+https://doc.qt.io/qt-6/linux.html
+https://doc.qt.io/qt-6/linux-requirements.html
+
+If they were installed before building Qt and xcb plugin is missing try reinstall them with
+
+```sh
+ sudo apt-get --reinstall <package_name>
+```
+
+Reset building configuration for Qt libraries at '/path/to/qt_sources'
+
+```sh
+ cmake --build . --target=clean
+```
+
+and remove CMakeCache.txt
+
+```sh
+ rm CMakeCache.txt
+```
+
+Try building Qt source again.
+
+
### Windows
These instructions assume that Ninja is installed and in the `PATH`, Qt Creator