Lan@dote.ru: Created page with "This page describes steps necessary to create your own BioUML or BDK plugin. Suppose you want to create plugin named `biouml.plugins.myplugin`. All paths ar..."

2013-09-10T04:35:18Z

Created page with "This page describes steps necessary to create your own BioUML or BDK plugin. Suppose you want to create plugin named <code>biouml.plugins.myplugin</code>. All paths ar..."

New page

This page describes steps necessary to create your own [[BioUML]] or [[BDK]] plugin. Suppose you want to create plugin named <code>biouml.plugins.myplugin</code>. All paths are relative to BioUML/BDK root directory.

== Code and compilation ==
* Create package folder <code>src/biouml/plugins/myplugin</code> and put your Java code there. If necessary, create subpackages folders like <code>src/biouml/plugins/myplugin/access</code>.
* Create plugin folder <code>plugins/biouml.plugins.myplugin_1.0.0</code> (replace 1.0.0 with your plugin version).
* Add ant target to <code>src/build.xml</code> to build your plugin. It may look like this:
<target name="plugin.myplugin" depends="compile">
<echo message="Making biouml.plugins.myplugin_1.0.0/myplugin.jar" />
<jar jarfile="${PLUGIN_DIR}/biouml.plugins.myplugin_1.0.0/myplugin.jar" compress="true">
<fileset dir="${OUTDIR}">
<patternset>
<include name="biouml/plugins/myplugin/**/*.class" />
<exclude name="biouml/plugins/myplugin/**/_test/**/*.class" />
</patternset>
</fileset>
<fileset dir="${SRCDIR}">
<patternset>
<include name="biouml/plugins/myplugin/**/*.gif" />
<include name="biouml/plugins/myplugin/**/*.html" />
</patternset>
</fileset>
</jar>
</target>
<code>${SRCDIR}</code> fileset is used to copy all the necessary resource files. Add other file types there if you use them.

After these steps your plugin jar file <code>myplugin.jar</code> can be built using <code>ant plugin.myplugin</code> command. For convenience you may add the dependence to <code>plugin.all</code> target.

== MANIFEST.MF file ==
Every plugin must have its MANIFEST.MF file. Create folder <code>plugins/biouml.plugins.myplugin_1.0.0/META-INF</code>, then create text file <code>MANIFEST.MF</code> in this folder and fill it in the following manner:

Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Localization: plugin
Bundle-Name: My plugin
Bundle-SymbolicName: biouml.plugins.myplugin;singleton:=true
Bundle-Version: 1.0.0
Bundle-Vendor: Provider Name
Require-Bundle: biouml.workbench,
ru.biosoft.access,
ru.biosoft.analysis,
ru.biosoft.table
Bundle-ClassPath: myplugin.jar
Export-Package: biouml.plugins.myplugin,
biouml.plugins.myplugin.access
Let's discuss this file in detail:
Manifest-Version: 1.0
Bundle-ManifestVersion: 2
Bundle-Localization: plugin
These rows should always look like this, just copy them.
Bundle-Name: My plugin
Here user-friendly plugin name "My plugin" is displayed. It's rarely used in BioUML, but it's good to specify something relevant. If wiki page will be generated for your plugin, this name will be displayed on it.
Bundle-SymbolicName: biouml.plugins.myplugin;singleton:=true
Symbolic name <code>biouml.plugins.myplugin</code> must be exactly the same as your root Java package and plugin folder name (except version part).
Bundle-Version: 1.0.0
Version must be exactly the same as in plugin folder.
Bundle-Vendor: Provider Name
User-friendly plugin provider name. It's used for wiki pages generation.
Require-Bundle: biouml.workbench,
ru.biosoft.access,
ru.biosoft.analysis,
ru.biosoft.table
Here all other plugins which your plugin directly depends on must be listed. For example, if you're using <code>ru.biosoft.bsa.Site</code> class somewhere in your plugin, then you must list <code>[[Ru.biosoft.bsa (plugin)|ru.biosoft.bsa]]</code> plugin here.
Bundle-ClassPath: myplugin.jar
Here exact name of the jar file which will be created during plugin build procedure must be specified.
Export-Package: biouml.plugins.myplugin,
biouml.plugins.myplugin.access
Here you must specify all packages from your plugin which should be accessible from the outside.

== plugin.xml file ==
If you want to define new extensions or extension points in your plugin, you should create <code>plugins/biouml.plugins.myplugin_1.0.0/plugin.xml</code> file and fill it like this:
<?xml version="1.0" encoding="UTF-8"?>
<plugin>
<extension-point name="myExtensionPoint" id="myExtensionPoint"/>

<extension point="biouml.plugins.myplugin.myExtensionPoint">

</extension>

<extension point="ru.biosoft.analysis.method">

</extension>
</plugin>
If you want to create an extension for existing extension point, please refer to the corresponding [[:Category:Extension points|extension point documentation page]].

[[Category:Development]]

Plugin development - Revision history

Lan@dote.ru: Created page with "This page describes steps necessary to create your own BioUML or BDK plugin. Suppose you want to create plugin named biouml.plugins.myplugin. All paths ar..."

Lan@dote.ru: Created page with "This page describes steps necessary to create your own BioUML or BDK plugin. Suppose you want to create plugin named `biouml.plugins.myplugin`. All paths ar..."