Creating a DTK Plugin
To create and commit a DTK plugin:Â
Create the different Java files required for the type of plugin you want to create. See the chapters describing each plugin for further information.
ÂCompile all the Java files for your plugin into classes:
> javac -classpath $CLASSPATH com/mycompany/myagent/*.java
Â
Create a user defined *.jar file containing the classes, see the section below, Creating a User Defined Jar File.
ÂCreate a user defined *.mzp package containing the *.jar file, see the section below, Creating a User Defined Package.
ÂCommit your user defined package, see the section below, Committing a User Defined Package.
Creating a User Defined Jar
To create a *.jar file containing the classes, use the following command syntax:
> jar cvf my_agent.jar com/mycompany/myagent/*.class
It is also possible to add resources to a jar file, just append any resource name to your "jar create" command. This allows you to, for instance, add images that your class depends on to the jar:
> jar cvf my_agent.jar com/mycompany/myagent/*.class com/mycompany/myagent/myagent_icon.svg
Creating a User Defined Package
In order to insert the *.jar file, a package containing the jar file must first be created. A package gives the *.jar file a name and a version. The mzsh pcreate
command creates a code package used for composing packages (.mzp)
in order to create additional functionality and updates. The name and version will be visible in the About window once the new package has been committed into the system.
A package is created using the pcreate
command in the mzsh Command Line Tool:
Argument | Description |
---|---|
| The name of the package |
| The version string of the package |
| The resulting package file name |
| Specifies if this software should support update to a running system. The default level can either be Note!Not all kinds of software using the development toolkit can be updated and also that a third party library being used by the software may or may not support the execution level. |
| Used to show the revision number from which the |
| Used to show the repository from which the |
| Used if the |
| The level name can either be platform or execution. Each filename to be included can optionally be preceded by a level. |
[ -osgi <true/false> ] | Used to indicate if the Exporting 3PP PackagesIt is advisable to use a Java wrapper as a proxy for exporting the packages used by your custom mzp.  Example - Using osgi and exportpackages |
[ -exportpackages <Java wrapper>] | A mandatory option when osgi is set to true. This option is used to export the Java wrapper for use by the DTK plugin. Â |
[ -exported <export-version> file=<jar file>] | This option is used to export all Java packages that comes bundled in a third party library package. This option is especially useful when there are multiple large third party library packages that contains large quantities of packages embedded within them. Â |
Committing a User Defined Package
Â