GammaRay API Documentation  2.8.0
Functions
GammaRay::Paths Namespace Reference

Methods to determine install locations of the various bits of GammaRay. More...

Functions

QString binPath ()
 
GAMMARAY_COMMON_DEPRECATED_EXPORT QString currentPluginsPath ()
 
GAMMARAY_COMMON_DEPRECATED_EXPORT QString currentProbePath ()
 
QString documentationPath ()
 
QString libexecPath ()
 
QString libraryExtension ()
 
QString pluginExtension ()
 
QStringList pluginPaths (const QString &probeABI)
 Returns a list of plugin search paths for the given ABI. More...
 
QString probePath (const QString &probeABI, const QString &rootPath=Paths::rootPath())
 
QString rootPath ()
 
void setRelativeRootPath (const char *relativeRootPath)
 
void setRootPath (const QString &rootPath)
 

Detailed Description

Methods to determine install locations of the various bits of GammaRay.

Function Documentation

◆ binPath()

QString GammaRay::Paths::binPath ( )

Returns the path containing the GammaRay injector executable.

◆ currentPluginsPath()

GAMMARAY_COMMON_DEPRECATED_EXPORT QString GammaRay::Paths::currentPluginsPath ( )

Returns the path to the current plugins location. This is the same as currentProbePath() when using the GammaRay installation layout, but differs with e.g. the Android installation layout.

Note
Must not be used outside of probe or client/ui code!
Deprecated:
Use Paths::pluginsPaths instead.

◆ currentProbePath()

GAMMARAY_COMMON_DEPRECATED_EXPORT QString GammaRay::Paths::currentProbePath ( )

Returns the path to the current probe location, probePath(GAMMARAY_PROBE_ABI).

Note
Must not be used outside of probe code!
Deprecated:
Use Paths::probePath instead.

◆ documentationPath()

QString GammaRay::Paths::documentationPath ( )

Path to the installed .qch/.qhc documentation files.

◆ libexecPath()

QString GammaRay::Paths::libexecPath ( )

Returns the path containing helper executables.

◆ libraryExtension()

QString GammaRay::Paths::libraryExtension ( )

Returns the file extension used on the current platform for libraries.

◆ pluginExtension()

QString GammaRay::Paths::pluginExtension ( )

Returns the file extension used on the current platform for plugins.

◆ pluginPaths()

QStringList GammaRay::Paths::pluginPaths ( const QString probeABI)

Returns a list of plugin search paths for the given ABI.

This includes candidates based on Qt's plugin search paths, and GammaRay's install layout.

Parameters
probeABIThe ABI identifier we are looking for plugins for. If you are actually loading plugins, this must be GAMMARAY_PROBE_ABI.

◆ probePath()

QString GammaRay::Paths::probePath ( const QString probeABI,
const QString rootPath = Paths::rootPath() 
)

Returns the probe and plugin base path for the given probe ABI. If probeABI is empty, the path containing the probes is returned.

◆ rootPath()

QString GammaRay::Paths::rootPath ( )

Absolute path to the root of the GammaRay installation, anything else is relative to this.

◆ setRelativeRootPath()

void GammaRay::Paths::setRelativeRootPath ( const char *  relativeRootPath)

Convenience version of the above, for root paths relative to QCoreApplication::applicationDirPath().

◆ setRootPath()

void GammaRay::Paths::setRootPath ( const QString rootPath)

Call this to set the root of the GammaRay install location, as early as possible. The install location is usually determined by using QCoreApplication::applicationDirPath() or the probe path, and the known relative install location of the corresponding component.


Klarälvdalens Datakonsult AB (KDAB)
"The Qt Experts"
https://www.kdab.com/
GammaRay
Qt-application inspection and manipulation tool
https://www.kdab.com/gammaray/