Logging and Debugging
The application-manager installs its own message handler that neatly formats logging output. It will also pass the output to GENIVI DLT (Diagnostic Log and Trace), if the QtGeniviExtras module is available.
The following logging categories are defined by the application manager:
am.installer- Installer sub-system
am.notify- Notification sub-system
am.qml- QML messages
am.qml.ipc- QML IPC
am.runtime.qml- QML runtime
am.system- General system messages
am.graphics- OpenGL/Wayland related messages
general- General messages not part of any ApplicationManager sub-system
This is a (incomplete) list of environment variables that influence the logging output at runtime:
|AM_STARTUP_TIMER||If set to 1, a startup performance analysis will be printed on the console. Anything other than 1 will be interpreted as the name of a file that is used instead of the console. For more in-depth information see StartupTimer.|
|AM_FORCE_COLOR_OUTPUT||Can be set to |
|AM_TIMEOUT_FACTOR||All timed wait statements within the application-manager will be slowed down by this (integer) factor. Useful if executing in slow wrappers, like e.g. valgrind. Defaults to |
|QT_MESSAGE_PATTERN||Setting this variable has the same effect as described on the Debugging Techniques page and will overwrite the default application-manager message handler. Parallel DLT logging will still be supported, if available.|
Debugging the application-manager, the System-UI and applications is dependent on the mode the application-manager is running in:
- In single-process mode, you can just start the
appmanbinary using your debugging tool of choice directly (e.g.
gdb --args appman -c config.yaml). Since everything is running in a single process, you cannot debug applications independently though.
- In multi-process mode, you have to distinguish between debugging the application-manager itself or the System-UI and debugging individual applications: The application-manager and System-UI can be debugged in the same way as described for a single-process setup above. Debugging applications is a bit more tricky though, since they have to be started by the application-manager: this is accomplished by running the app through a debug wrapper which describe how to start an application using your favorite debugging tool.
To enable QML Debugging/Profiling in the application-manager or an application it needs to be started with the
--qml-debug argument. See QML Debugging Infrastructure for more information.
Please note that although the concept is called "debug" wrappers, these wrappers are not limited to actual debugging tasks. They are also useful for various other tasks that involve running the program under test through a wrapper, e.g. profiling tools.
Using Debug Wrappers
There are three ways to do start applications using debug wrappers - all of them rely on a common way to specify which debug wrapper to use:
- Within your System-UI, do not use
startApplicationto start an app, but debugApplication:
ApplicationManager.debugApplication("io.qt.app", "/usr/bin/strace -f")
- Via D-Bus, you can call the debugApplication method:
qdbus io.qt.ApplicationManager /ApplicationManager debugApplication "gdbserver :5555" io.qt.app
- Using the
appman-controllerwhich uses D-Bus internally, but is able to find the correct bus automatically and supports standard-IO redirection:
appman-controller debug-application -ioe "valgrind --tool=helgrind" io.qt.app
-eparameters will redirect the respective IO streams (
stderr) to the calling terminal.
Note: In order to use the D-Bus options, the application-manager has to be connected to either a session- or system-bus - make sure to not run it with
The debug wrapper specification has to be a single argument string, that is interpreted as a command line. If this string contains the sub-string
%program%, it will be replaced with the full path to the executable of the application (or the
appman-launcher-qml binary for QML applications). The same thing happens for
%arguments%, which will be replaced with potential command line arguments for the application. If you don't specify
%arguments%, they will simply be appended to the resulting command line.
This means that all of these debug wrappers are essentially the same:
appman-controller debug-application "gdbserver :5555 %program% %arguments%" io.qt.music appman-controller debug-application "gdbserver :5555 %program%" io.qt.music appman-controller debug-application "gdbserver :5555" io.qt.music
appman-controller debug-application "%program% -qmljsdebugger=port:1234,block %arguments%" io.qt.browser
You also have the possibility to specify environment variables for the debug wrapper - just like on the command line. This command will run your application through
strace while also setting the
WAYLAND_DEBUG environment variable to
appman-controller debug-application "WAYLAND_DEBUG=1 strace -f" io.qt.browser
For added convenience, you can even just only set environment variables without any actual debug wrapper, e.g. to debug imports and plugin loading in a QML application:
appman-controller debug-application "QT_DEBUG_PLUGINS=1 QML_IMPORT_TRACE=1" io.qt.browser
It is advisable to create aliases or wrapper scripts when using complex debug wrappers on the command line often.
© 2018 Pelagicore AG. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.