Software Development Kit

Revision as of 13:27, 1 February 2006 by Watkinson (talk | contribs)

The Developer Kit is a self-contained package that facilitates the process of developing plugins for geWorkbench.

Using the Developer Kit

The Developer Kit is available as a .zip file. Unzip it in to a directory of your choice, then follow the instructions below to create a geWorkbench plugin.

The high-level steps for creating, testing and releasing a plugin are as follows:

  1. Edit the provided Apache Ant build script to specify the name of your plugin.
  2. Add the .java source files for your plugin to the src directory.
  3. Add any .jar libraries that your plugin requires to the lib directory.
  4. Run ant to build your plugin.
  5. Edit the geWorkbench configuration file to add a directive for your new plugin.
  6. Run geWorkbench with ant run to test your plugin.
  7. Once satisfied with your plugin, use the provided utility to package your plugin in to a single file for distribution.

The next section will illustrate the above steps with an example.

An Example Plugin

We will create an example plugin that is simply called test. This will be a very simple visualization plugin that just displays a blank blue region.

  • In the provided build.xml, this line can be found near the beginning of the file:
<property name="component" value="noname"/>

The line is changed to:

<property name="component" value="test"/>

This specifies the name of our component, which is used for all build products.

  • Next we will add a single .java source file in the org.organization.test package. The file TestComponent.java goes in the src/org/organization/test and has the following contents:
package org.organization.test;

import org.geworkbench.engine.config.VisualPlugin;
 
import javax.swing.*;
import java.awt.*;
 
/**
 * @author John Watkinson
 */
public class TestComponent implements VisualPlugin {
 
    private JPanel panel;
 
    public TestComponent() {
        panel = new JPanel();
        panel.setBackground(Color.blue);
    }
 
    public Component getComponent() {
        return panel;
    }
}
  • The configuration file for the Developer Kit is called minimal.xml and it is in the conf directory. The following directive is added:
   <plugin id="testPanel" name="Test Panel" class="org.organization.test.TestComponent" source="test">
       <gui-area name="VisualArea"/>
   </plugin>
  • The plugin will now appear when the application is run. It can be run with the command:
ant run
  • Satisfied with the plugin, it can now be released by running:
ant gear

This creates the file test.gear. A .gear file is the geWorkbench analogue of a .war file for a web application. Is a bundled plugin that can deployed to a geWorkbench install by placing the file in the components directory. A configuration directive (such as the one above) would also need to be added to the configuration file to activate the plugin.