| <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> | |
| <html> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> | |
| <title>Workbench Extension Points</title> | |
| </head> | |
| <body link="#0000FF" vlink="#800080"> | |
| <center> | |
| <h1> | |
| Applications</h1></center> | |
| <b><i>Identifier: </i></b>org.eclipse.core.runtime.applications<p><b><i>Description: | |
| </i></b>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 <i>application</i>. | |
| Declared applications can be run directly from the main platform launcher by | |
| specifying the <i>-application</i> argument where the parameter is the id of an | |
| extension supplied to the applications extension point described here. | |
| This application is instantiated and run by the platform. Platform clients | |
| can also use the platform to lookup and run multiple applications. | |
| <p><b><i>Configuration Markup:</i></b> | |
| <p><tt> <!ELEMENT application run?></tt> | |
| <p> | |
| <tt> <!ELEMENT run parameter*></tt> | |
| <br><tt> <!ATTLIST run</tt> | |
| <br><tt> class | |
| CDATA #REQUIRED</tt> | |
| <br><tt> ></tt> | |
| <ul> | |
| <li> | |
| <b>class -</b> the fully-qualified name of a class which implements <tt>org.eclipse.core.boot.IPlatformRunnable</tt>.</li> | |
| </ul> | |
| <tt> <!ELEMENT parameter EMPTY></tt> | |
| <br><tt> <!ATTLIST parameter</tt> | |
| <br><tt> name | |
| CDATA #REQUIRED</tt> | |
| <br><tt> value | |
| CDATA #REQUIRED</tt> | |
| <br><tt> ></tt> | |
| <ul> | |
| <li> | |
| <b>name</b> - the name of this parameter made available to instances of | |
| the specified application class</li> | |
| <li> | |
| <b>value</b> - an arbitrary value associated with the given name and made | |
| available to instances of the specified application class</li> | |
| </ul> | |
| <b><i>Examples:</i></b> | |
| <p>Following is an example of a builder configuration: | |
| <p><tt> <extension id="coolApplication" point="org.eclipse.core.runtime.applications"></tt> | |
| <br><tt> <application></tt> | |
| <br><tt> <run class="com.xyz.applications.Cool"></tt> | |
| <br><tt> | |
| <parameter name="optimize" value="true"/></tt> | |
| <br><tt> </run></tt> | |
| <br><tt> </application></tt> | |
| <br><tt> </extension></tt> | |
| <p><b><i>API Information</i>: </b>The value of the <tt>class</tt> attribute | |
| must represent an implementor of <tt>org.eclipse.core.boot.IPlatformRunnable</tt>. | |
| <p><b><i>Supplied Implementation:</i></b> The platform itself supplies a number | |
| of applications including the platform workbench itself. | |
| <p><a href="hglegal.htm"><img SRC="ngibmcpy.gif" ALT="Copyright IBM Corp. 2000, 2001. All Rights Reserved." BORDER=0 height=12 width=195></a> | |
| </body> | |
| </html> |