Deploying Qt QML Compiled Executable

Question

So I have a simple app that uses QML for my graphical interface and c++ code for some of the logic. I was looking for a method to compile the QML into c++ code and link it into my binary and found this page over at the Qt home site:

http://doc.qt.io/QtQuickCompiler/

Basically it says use the resource system for all of my QML graphical interface files and add the QML compiler flag to my qmake config line in my .pro file and everything should be good to go.

As far as I know everything compiles fine, but when I use the the Qt windeployqt.exe tool to get all of the dependency files and test it on a clean system, I get a small white screen as if my QML files were not loaded properly.

I have one c++ reference to my main QML file using "qrc:/mainqml.qml" and that's it.

Any idea what I am doing wrong?

Kuba hasn't forgotten Monica · Accepted Answer · 2018-06-27 19:19:37Z

3

You're using the open source version of Qt. It didn't come with the Qt Quick compiler until Qt 5.11 where it is included - and after a rework, too. So it performs better than precompiled QML did in Qt 5.10 and before.

I get a small white screen as if my QML files were not loaded properly.

... thus you need to deploy these files with the application, otherwise it won't work.

add the QML compiler flag to my qmake config

That flag was a no-op on an open source Qt build until Qt 5.11.

edited Jun 27, 2018 at 19:19

answered Jan 11, 2016 at 19:54

Kuba hasn't forgotten Monica

99.1k17 gold badges168 silver badges333 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Leben Asa · Accepted Answer · 2016-01-13 04:10:06Z

3

Qt Quick Compiler only shipped with Qt Commercial License, but you can still compile your QML files into qrc file. Starting a Qt Quick application project from Qt Creator does exactly this.

Deploying QML application with windeployqt require additional flag --qmldir, e.g.

windeployqt --(release or debug) --qmldir %PATH_TO_YOUR_QML_FILES% %YOUR_APPLICATION%.exe

It will parse your qml files and deploy all qml imports you used.

edited Jan 13, 2016 at 4:10

answered Jan 12, 2016 at 9:33

Leben Asa

3271 silver badge6 bronze badges

4 Comments

MrJman006 Over a year ago

So if I understand properly, the Qt Quick Compiler just compiles .qml files, but by adding them to the .qrc resource file, they automatically get compiled into the final binary?

Leben Asa Over a year ago

Both of them compile qml files into qt resource file (qrc) into final binary. Qt Quick Compiler, however, allows you to go a step further by compiling qml and javascript files into intermediate C++ code, therefore reduces the application startup time and allows for a much faster execution on platforms that do not permit Just-in-time compilation.

Leben Asa Over a year ago

In your case, I suspect your deployment folder doesn't include necessary plugins and QML plugins. Using correct flag in windeployqt would fix this issue (since I have encountered such case myself).

Tomilov Anatoliy Over a year ago

Is this fix only for Windows?

Collectives™ on Stack Overflow

Deploying Qt QML Compiled Executable

2 Answers 2

Comments

4 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

Comments

4 Comments

Your Answer

Sign up or log in

Post as a guest

Related