Overview

Your plug-in can contribute an application to the workbench using the org.karora.moomba.ui.applications extension point. This allows you to tailor how the workbench looks by specifying such things as what perspective(s) are shown and in what order. It also allows you to add default toolbar/menu items to the workbench.

Plugin Configuration file

Identifier: org.karora.moomba.ui.applications

Description

Platform runtime supports plug-ins which would like to declare main entry points. That is, programs which would like to run using the platform runtime but yet control all aspects of execution can declare themselves as an application.

Configuration Markup:

<!ELEMENT extension (application)>
<!ATTLIST extension
point CDATA #REQUIRED
id    CDATA #REQUIRED
name  CDATA #IMPLIED>
<!ELEMENT application (run?)>

<!ATTLIST application
visible     (true | false) "true"
cardinality (singleton-global|singleton-scoped|1|2|3|4|5|*) "singleton-global"
thread      (main|any) "main">

visible - Specifies whether the application should be visible for the user. For example, some applications may provide features to other applications but nothing directly to the user. In this case the application should not be revealed to the user to start it individually. The default value is set to true.
cardinality - Specifies the cardinality of the application. The cardinality controls the number of applications that may be running at the same time in the Platform. The following cardinality types are allowed
singleton-global
This application must be the only application running. No other types of applications can start while this application is active
singleton-scoped
This application must be the only scoped application running. No other applications that use the singleton-scoped cardinality can start while this application is active
integer
An integer indicates the maximum number of active instances allowed for this application. Other applications are allowed to start while this application is active, except for singleton-global applications
*
A value of "*" indicates there is no maximum on the number of active instances allowed for this application. Other applications are allowed to start while this application is active, except for singleton-global applications
The default value is "singleton-global".
thread - Specifies the thread the application must run on. The following thread types are allowed.
main
This application must run on the main thread.
any
This application may run on any thread.
The default value is "main".

<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>

class - the fully-qualified name of a class which implements org.eclipse.equinox.application.IApplication.

<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name  CDATA #REQUIRED
value CDATA #REQUIRED>

name - the name of this parameter made available to instances of the specified application class
value - the value of this parameter made available to instances of the specified application class

Examples

Following is an example of an application declaration:

<extension id="coolApplication" point="org.eclipse.core.runtime.applications"> 
      <application> 
         <run class="com.xyz.applications.Cool"> 
            <parameter name="optimize" value="true"/> 
         </run> 
      </application> 
   </extension>

API Information

The value of the class attribute must represent an implementor of org.eclipse.equinox.application.IApplication.

Supplied Implementation

The platform does not supply any applications.

Applications - org.karora.moomba.ui.applications