Class ExtensionUtils

java.lang.Object

ghidra.util.extensions.ExtensionUtils

public class ExtensionUtils
extends Object

Utilities for finding extensions.

Extension searching is cached. Use reload() to update the cache.

Field Summary

Fields

Change	Modifier and Type	Field	Description
	static final String	MAX_ZIP_ENTRIES_OVERRIDE_PROPERTY	A property that is used to override the MAX_ZIP_ENTRIES_DEFAULT value
	static String	PROPERTIES_FILE_NAME
	static String	PROPERTIES_FILE_NAME_UNINSTALLED

Constructor Summary

Constructors

Change	Constructor	Description
	ExtensionUtils()

Method Summary

Change	Modifier and Type	Method	Description
	static void	clearCache()	Clears any cached extensions.
	static ExtensionDetails	createExtensionFromProperties(File file)
	static Set<ExtensionDetails>	getActiveInstalledExtensions()	Returns all installed extensions that are not marked for uninstall.
	static Extensions	getAllInstalledExtensions()
	static Set<ExtensionDetails>	getArchiveExtensions()	Returns all archive extensions.
	static ExtensionDetails	getExtension(File file, boolean quiet)
	static ExtensionDetails	getExtension(String path)
	static Set<ExtensionDetails>	getInstalledExtensions()	Returns all installed extensions.
	static void	initializeExtensions()	Performs extension maintenance.
	static boolean	install(ExtensionDetails extension, File file, TaskMonitor monitor)
	static boolean	isExtension(File file)	Returns true if the given file or directory is a valid ghidra extension.
	static void	reload()	Clears any cached extensions and searches for extensions.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MAX_ZIP_ENTRIES_OVERRIDE_PROPERTY NEW

public static final String MAX_ZIP_ENTRIES_OVERRIDE_PROPERTY

A property that is used to override the MAX_ZIP_ENTRIES_DEFAULT value

See Also:

• Constant Field Values

PROPERTIES_FILE_NAME

public static String PROPERTIES_FILE_NAME

PROPERTIES_FILE_NAME_UNINSTALLED

public static String PROPERTIES_FILE_NAME_UNINSTALLED

Constructor Details

ExtensionUtils

public ExtensionUtils()

Method Details

initializeExtensions

public static void initializeExtensions()

Performs extension maintenance. This should be called at startup, before any plugins or extension points are loaded.

getExtension

public static ExtensionDetails getExtension(String path)

isExtension

public static boolean isExtension(File file)

Returns true if the given file or directory is a valid ghidra extension.

Note: This means that the zip or directory contains an extension.properties file.

Parameters:

file - the zip or directory to inspect

Returns:

true if the given file represents a valid extension

install

public static boolean install(ExtensionDetails extension,
 File file,
 TaskMonitor monitor)

getActiveInstalledExtensions

public static Set<ExtensionDetails> getActiveInstalledExtensions()

Returns all installed extensions that are not marked for uninstall.

Returns:

all installed extensions that are not marked for uninstall

getInstalledExtensions

public static Set<ExtensionDetails> getInstalledExtensions()

Returns all installed extensions. These are all the extensions found in ApplicationLayout.getExtensionInstallationDirs().

Returns:

set of installed extensions

getAllInstalledExtensions

public static Extensions getAllInstalledExtensions()

getExtension

public static ExtensionDetails getExtension(File file,
 boolean quiet)

reload

public static void reload()

Clears any cached extensions and searches for extensions.

clearCache

public static void clearCache()

Clears any cached extensions.

getArchiveExtensions

public static Set<ExtensionDetails> getArchiveExtensions()

Returns all archive extensions. These are all the extensions found in ApplicationLayout.getExtensionArchiveDir(). This are added to an installation as part of the build processes.

Archived extensions may be zip files and directories.

Returns:

set of archive extensions

createExtensionFromProperties

public static ExtensionDetails createExtensionFromProperties(File file)