Platform Runtime

Table of Contents

• Applications
  • Identifier
  • Description
  • Configuration Markup
  • Examples
• Products
  • Identifier
  • Description
  • Configuration Markup
  • Examples
  • Supplied Implementation

Applications

Identifier

org.blueberry.osgi.applications

Description

The applications extension point allows plugins to contribute applications to the BlueBerry Platform.

Configuration Markup

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

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

<!ELEMENT run EMPTY>
<!ATTLIST run
  class CDATA #REQUIRED>

Examples

<extension id="sampleApplication" point="org.blueberry.osgi.applications">
  <application id="my.domain.application">
  <run class="xyz::SampleApp"/>
  </application>
</extension>

Products

Identifier

org.blueberry.core.runtime.products

Description

Products are the BlueBerry unit of branding. Product extensions are supplied by plug-ins wishing to define one or more products. There must be one product per extension as the extension id is used in processing and identifying the product.

There are two possible forms of product extension, static and dynamic. Static product extensions directly contain all relevant information about the product. Dynamic product extensions identify a class (an IProductProvider) which is capable of defining one or more products when queried.

Configuration Markup

<!ELEMENT extension ((product | provider))>
<!ATTLIST extension
  point CDATA #REQUIRED
  id    CDATA #IMPLIED
  name  CDATA #IMPLIED>

<!ELEMENT product (property*)>
<!ATTLIST product
  application CDATA #REQUIRED
  name        CDATA #REQUIRED
  description CDATA #IMPLIED>

• application: the default application to run when running this product
• name: the human-readable name of this product
• description: the human-readable description of this product

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

• name: the key under which this property is stored
• value: the value of this property

<!ELEMENT provider (run)>

<!ELEMENT run EMPTY>
<!ATTLIST run
  class CDATA #REQUIRED>

• class: the fully-qualified name of a class which implements IProductProvider

Examples

<extension id="coolProduct" point="org.blueberry.core.runtime.products">
  <product name="%coolName" application="coolApplication" description="%coolDescription">
    <property name="windowImages" value="window.gif"/>
    <property name="aboutImage" value="image.gif"/>
    <property name="aboutText" value="%aboutText"/>
    <property name="appName" value="CoolApp"/>
    <property name="welcomePage" value="$nl$/welcome.xml"/>
    <property name="preferenceCustomization" value="plugin_customization.ini"/>
  </product>
</extension>

The following is an example of a dynamic product (product provider) declaration: Following is an example of an application declaration:

<extension id="coolProvider" point="org.blueberry.core.runtime.products">
  <provider>
     <run class="me::CoolProvider"/>
  </provider>
</extension>

Supplied Implementation

No implementations of IProductProvider are supplied.