After launcher a target application with GammaRay, or attaching or connecting to a running one, you are presented with the GammaRay client. This is the primary user interface for exploring what is going on inside the target application.
The GammaRay client is available in two forms:
- as a standalone application as depicted in the following screenshot
- as Qt Creator plugin (for Qt Automotive Suite only)
GammaRay contains a number of different tools, each providing a different view on the activities and data of the target application. A tool typically focuses on a specific Qt framework such at Qt Quick or state machines, or model/view.
Switching between tools is done via the tool list on the left side of the GammaRay client window. Only tools applicable to the current target applications are active. Inactive tools can be hidden via the context menu.
An overview of all available tools can be found in the Tools section of this manual.
Many tools in GammaRay deal with a set of objects of the target application, most commonly QObject sub-classes. To explore the properties of a selected object, those tools typically show the object property inspector on the right hand side (as seen in the above screenshot). The property inspector contains a number of different tabs, depending on the type of the object.
Object and code navigation
Different tools might show different aspects of the same object, so it's useful to be able to navigate to the current object in other tools. This is offered in most places via the context menu.
Equally, it is useful to navigate to the code that declared or instaniated an object, this is offered also via the context menu (QML only currently).
Finding the right objects in the manu thousands existing in a target application typically can be challenging. GammaRay supports this by the following means:
- Search fields for most object tree or list views, to quickly filter by type, object name or other displayed properties.
- In-application object picking for visual elements, using Ctrl+Shift+left click on the target application.
© 2016-2017 Klarälvdalens Datakonsult AB (KDAB).
Documentation contributions included herein are the copyrights of
their respective owners.
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.