Plugin descriptor

id

A plugin ID should be unique. It is used to identify a plugin by a plugin's manager internals and by requirements of other plugins. For example, my.first.plugin.0.

name

A plugin name. There is no strict rules applied to this attribute. For example, Example plugin.

version

A plugin version. The version can be used to check other plugins dependencies, if internalVersion is not defined.

internalVersion

A plugin internal version. It is used to check other plugins dependencies.

provider-name

A plugin provider name, which is a company or an author name. For example: No Magic.

class

A full qualified class name. The class must be derived from com.nomagic.magicdraw.plugins. A plugin and stored in plugin runtime library. This class will be loaded and initialized by the plugin's manager. For example, myplugin.MyPlugin.

ownClassloader

Optional; the default value is false.
Indicates, if to use an own plugin's classloader (separate from other plugins). All program plugins are loaded by the one classloader. If there are plugins that cannot be loaded by the same classloader (for example, because of conflicts in plugin libraries versions or other), their descriptors must be defined to use own class-loaders.

class-lookup

Optional; possible values are LocalFirst, GlobalFirst, the default value is GlobalFirst.
Specifies the priority of a "parent" class loader, if a plugin uses ownClassloader. LocalFirst forces to load classes from the plugin class loader even if such classes exist in the modeling tool core class path. This option should be used, if, in your plugin, you want to use different versions of same libraries that are used in the core.

requires

A modeling tool API version required by the plugin. Plugins and their versions required by the plugin.

runtime

Runtime libraries needed by a plugin.

api

A required modeling tool API version.

required-plugin

Plugin(s) that are required to run the plugin.

id

The ID of a required plugin. For example, my.first.plugin.0.

name

A name of a required plugin.

internalVersion

An internal version of a required plugin. If it is not defined, the "version" is used to check if the required plugin is suitable.

version

A version of a required plugin. If it is not defined, any required plugin version is suitable. For example: 1.1.

The default value of this attribute is false.

If value is false (or attribute is skipped), the plugin will be loaded only if the required plugin is loaded.

If value is true, the plugin will be loaded if the required plugin is loaded or required plugin is not installed.

A name (path) of the required library. The path is relative to the plugin descriptor directory (slash should be used to separate files in path).

For example, "pluginlib.jar", "lib/otherlib.jar".