Common Issues - therecipe/qt GitHub Wiki
Check this list for a problem that you have encountered:
- Why is the initial setup using
qtsetup
so slow ? - Why is the deploying process using
qtdeploy
so slow ? - Why are my
uint64
values not correct when using them in QML ? - Why my app doesn't look native in Linux ?
qtsetup
so slow ?
Why is the initial setup using The setup spends most of its time generating binding code and installing all of Qt packages, which in turn will speed up the compilation of your applications later. If you want, you can run minimal setup by exporting enviromental variable QT_STUB=true
before running the setup, which thereby make the setup faster.
qtdeploy
so slow ?
Why is the deploying process using qtdeploy
is slow, because it is intended to be used for deploying, and therefore takes some extra actions that may not be needed during development. If you want, you can use the -fast
flag to skip most of the actions taken otherwise, and so drastically reduce the time it takes to compile your application. Do note: before using -fast
, you must have already run qtdeploy
normally at least once before.
uint64
values not correct when using them in QML ?
Why are my QML is not able to handle 64 bit integers at the time of this writing. Check out the qt docs:
In case you do not require to interact with your uint64
value as an integer, there is a workaround. Simply format your value to a string
and pass that to QML. See this issue for further details on that.
Why my app doesn't look native in Linux ?
At the moment, in Linux all applications built with this binding use Fusion style by default instead of the native style. There were some problems with GTK styling in Qt 5.7.+ because of the change from gtk2
to gtk3
or something. As a workaround, distros developer have created different solutions for each of their own distro, like qt5ct
on Arch/Fedora or qt5-style-plugins
on Ubuntu/Debian. But these solutions seem to only work if you also use the system Qt libs and not the official "portable" Qt libs.
With that said, you have three choice :
- Keep using Fusion style.
- Keep using Qt 5.6.2 (which should style correctly) until this bug (hopefully) fixed in future Qt version.
- Deploy your app using your system Qt libs by exporting environment variable
QT_PKG_CONFIG=true
.
The downside is your app will only work with systems that use same or compatible version of Qt with your system, and has same distro with you. For example, if you run qtdeploy
in Arch Linux with Qt 5.9.1, then your app might not work or style correctly in Ubuntu with Qt 5.8.0.
For more details, you can follow this issue.