[Documentation] [TitleIndex] [WordIndex

Plugin Description File Reference

This page describes the XML format used for plugin description files used by the pluginlib package.

<class_libraries> tag

The class_libraries tag allows listing multiple libraries which, in turn, contain plugins within one plugin description file.

<library> tag

The library tag defines the library in which plugin classes live. A library may contain multiple plugins of varying class types.

Attributes:

<class> tag

The class tag describes a class provided by a library.

Attributes:

Examples

A simple plugin description file for a library with one class to export

<library path="lib/libplugin">
  <class name="MyPlugin" type="my_namespace::MyPlugin" base_class_type="interface_namespace::PluginInterface">
    <description>
      A description of MyPlugin
    </description>
  </class>
</library>

A plugin description file for a library with multiple plugins

<library path="lib/libplugin">
  <class name="FirstPlugin" type="my_namespace::FirstPlugin" base_class_type="interface_namespace::PluginInterface">
    <description>
      A description of FirstPlugin
    </description>
  </class>
  <class name="SecondPlugin" type="my_namespace::SecondPlugin" base_class_type="interface_namespace::PluginInterface">
    <description>
      A description of SecondPlugin
    </description>
  </class>
</library>

A plugin description for multiple libraries with plugins

<class_libraries>
  <library path="lib/libplugina">
    <class name="MyPluginA" type="my_namespacea::MyPluginA" base_class_type="interface_namespace::PluginInterface">
      <description>
        A description of MyPluginA
      </description>
    </class>
  </library>
  <library path="lib/libpluginb">
    <class name="MyPluginB" type="my_namespaceb::MyPluginB" base_class_type="interface_namespace::PluginInterface">
      <description>
        A description of MyPluginB
      </description>
    </class>
  </library>
</class_libraries>

2024-09-28 14:24