Skip to content

Getting GammaRay

Allen Winter edited this page Sep 4, 2023 · 52 revisions

Getting GammaRay

Download Pre-Compiled Packages

Starting with release 3.0.0, pre-compiled packages are no longer provided for Linux from the OpenSUSE Build Service nor from homebrew for MacOS. Ask your distributor to provide GammaRay packages if they don't do that already.

Building From Source

Requirements for compiling and using it:

  • Qt (obviously)
    • Supported: 5.5, 5.6, 5.7, 5.8, 5.9, 5.10, 5.11, 5.12, 5.13, 5.14, 5.15, 6.1, 6.2, 6.3, 6.4, 6.5
    • Older Qt versions (5.2 - 5.4, 4.8) were supported until GammaRay 2.10.
    • Make sure to have private Qt headers installed. That is automatically the case when using the Qt SDK or a self-compiled Qt, but some Linux distributions ship them in separate packages (e.g. qtX5-private-dev on Ubuntu).
  • CMake >= 3.16.0
  • A C++11 compliant compiler

The following libraries enable additional features when found on your system at compile time:

  • librt (Linux only), enables the timer profiler
  • KDSME for runtime QStateMachine visualization

The following libraries enable some rarely needed esoteric features when found at compile time:

  • KF5 KCoreAddons, enables the KJob tracker plug-in
  • KF5SyntaxHighlighting, enables syntax highlighting in the code editor

The following runtime dependencies are recommended:

  • gdb or lldb, enables runtime attaching to already running targets (Linux/Mac only)

For using GammaRay on an embedded device, also see Cross-compiling GammaRay.

Building

Easiest way to get the source is cloning the Git repository:

git clone git://github.com/KDAB/GammaRay.git

A ZIP download is also available:

Once you have the source code, follow the build instructions in Install.txt.