Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Download Pre-Compiled Packages
Since GammaRay needs to be compiled for exactly the Qt version you are using in the application you are debugging (and on most platforms even with the same compiler and compiler settings), the pre-compiled packages are only useable in combination with the corresponding Qt. For Linux packages that is usually the standard Qt packages of that distribution.
Example install script for Ubuntu-18.04 (and Linux Mint Tara)
repo=https://download.opensuse.org/repositories/isv:/KDAB/xUbuntu_18.04 echo "deb $repo/ /" | sudo tee -a /etc/apt/sources.list.d/obs.list wget -O - $repo/Release.key | sudo apt-key add - sudo apt install gammaray
Build Recipes for Source-Based Distributions
There are ready made build recipes for a number of source-based distributions, those are usually easier to use than building GammaRay manually.
- Homebrew: https://github.com/KDAB/homebrew-tap
- Yocto: see https://github.com/KDAB/GammaRay/wiki/Cross-compiling-GammaRay
- Buildroot: see https://github.com/KDAB/GammaRay/wiki/Cross-compiling-GammaRay
Building From Source
Requirements for compiling and using it:
- Qt (obviously)
- Supported: 4.8, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 5.10, 5.11
- Previously supported (likely to work with older GammaRay versions, or some extra #ifdefs): 5.0, 5.1, 5.2
- 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.0, CMake 3.1.0 (for MSVC)
- GCC >= 4.8 or MSVC >= 2010 or Clang >= 3.1, ie. a compiler supporting some basic C++11 features.
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:
- KDE4 or 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.
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:
- Latest Stable Snapshot: https://github.com/KDAB/GammaRay/zipball/v2.9.1
- Latest Development Snapshot: https://github.com/KDAB/GammaRay/zipball/master
- Past Releases: https://github.com/KDAB/GammaRay/tags
Once you have the source code, follow the build instructions in Install.txt.