This page contains frequently asked questions/problems and how to fix them.

How do I check whether I run appman in multi-process mode ?

Either start the application-manager with --verbose and look for the output WindowManager: running in Wayland mode, or simply start an application and make sure you can see at least one appman-launcher-qml process running.

How do I check why my appman doesn't support multi-process mode ?

Check the configure output of appman (Most likely you are missing the qtwayland module).

My applications are running slow within appman. What can I do ?

Check whether your applications run with hardware acceleration.

How do I check whether my applications use hardware-acceleration ?

Run appman with the environment variable QSG_INFO=1. You should see output looking similar this, when starting an application:

[DBG  | qt.scenegraph.general | c.p.music] Using sg animation driver
[DBG  | qt.scenegraph.general | c.p.music] Animation Driver: using vsync: 16.95 ms
[DBG  | qt.scenegraph.general | c.p.music] texture atlas dimensions: 1024x1024
[DBG  | qt.scenegraph.general | c.p.music] R/G/B/A Buffers:    8 8 8 8
[DBG  | qt.scenegraph.general | c.p.music] Depth Buffer:       24
[DBG  | qt.scenegraph.general | c.p.music] Stencil Buffer:     8
[DBG  | qt.scenegraph.general | c.p.music] Samples:            0
[DBG  | qt.scenegraph.general | c.p.music] GL_VENDOR:          VMware, Inc.
[DBG  | qt.scenegraph.general | c.p.music] GL_RENDERER:        llvmpipe (LLVM 5.0, 256 bits)
[DBG  | qt.scenegraph.general | c.p.music] GL_VERSION:         3.0 Mesa 17.3.0

If GL_RENDERER is "llvmpipe" you are using software-rendering for your wayland clients.

Note: You will also get this information output for the system-ui itself - make sure to look at the information table that has the application's id in the prefix (in the example above, com.pelagicore.music)

How do I turn on hardware-accerlation ?

This depends on your hardware and the operating system:

In general you need to make sure you have the correct drivers installed:

• NVIDIA on ubuntu/debian you need: nvidia-egl-wayland-icd
• Intel on ubuntu/debian you need: libwayland-egl1-mesa

On desktop systems make sure your Qt is configured to use at least OpenGL ES2/ES3 and NOT Desktop OpenGL. Check for the following configure summary line in Qt itself:

OpenGL ES 2.0 ........................ yes

You can force Qt to use Opengl ES2 by using the "--opengl es2" configure option.

Make sure the wayland-egl integration plugin is built: Check for the following file: <QT_DIR>/plugins/wayland-graphics-integration-client/libwayland-egl.so

If that is not available, check the QtWayland configure summary and make sure it does get built.