Skip to content

Getting GammaRay

Waqar Ahmed edited this page Oct 7, 2024 · 54 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.15, 6.3, 6.4, 6.5, 6.6, 6.7
    • Older Qt versions (<5.15, 6.0 - 6.2) where supported until GammaRay 3.1.
    • Even 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 https://github.com/KDAB/GammaRay.git

Bundled (zip or tar.gz) source downloads are available at https://github.com/KDAB/GammaRay/releases/tag/3.1.0

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