Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "SMILA/Documentation/HowTo/How to integrate new bundle into build process"

m (1. Include new plug-in into org.eclipse.smila.feature)
m (1. Include new plug-in into org.eclipse.smila.feature)
Line 10: Line 10:
 
<tr><td>
 
<tr><td>
 
'''Useful Information'''
 
'''Useful Information'''
You don´t have to modify the build file (make.xml) to include your bundle in the build process.  
+
You don't have to modify the build file (<tt>make.xml</tt>) to include your bundle in the build process.  
The <tt>make.xml</tt> file includes all SMILA bundles located under the local trunk folder, along with the bundles whose names match its <patternset> elements (com.*, net.* and so on). If you get an error such as "Unable to find bundle xxx", it's probably because it is not matched by <tt>make.xml</tt> and it is not copied to the build folder. If you don't want to include your new bundle into the build process, the bundle has to be excluded explicitly in <tt>make.xml</tt>.  
+
The <tt>make.xml</tt> file includes all SMILA bundles located under the local trunk folder, along with those bundles whose names match its <patternset> elements (com.*, net.* and so on). If you get an error such as "Unable to find bundle xxx", it's probably because it is not matched by <tt>make.xml</tt> and it is not copied to the build folder. If you don't want to include your new bundle into the build process, the bundle has to be excluded explicitly in <tt>make.xml</tt>. For further information see: [[SMILA/Development_Guidelines/Introduction to make.xml|Introduction to make.xml]].
 
+
For further information see: [[SMILA/Development_Guidelines/Introduction to make.xml|Introduction to make.xml]].
+
 
</td></tr>
 
</td></tr>
 
</table>
 
</table>
  
For further information on how to build the SMILA distribution see: ''[[SMILA/Development_Guidelines/Howto_build_a_SMILA-Distribution|How to build a SMILA distribution]]''.
+
For information on how to build the SMILA distribution see: ''[[SMILA/Development_Guidelines/Howto_build_a_SMILA-Distribution|How to build a SMILA distribution]]''.
  
 
=== '''2. Optionally: Generate Source Bundle '''  ===
 
=== '''2. Optionally: Generate Source Bundle '''  ===

Revision as of 09:00, 25 January 2012

The following steps have to be done to integrate a new bundle (plug-in) in the SMILA build process:

1. Include new plug-in into org.eclipse.smila.feature

  1. Open the feature.xml file of the project org.eclipse.smila.feature in the Feature Manifest Editor.
  2. Switch to the Plug-ins page and add the bundle to the Plug-ins and Fragments list. You don't have to adapt the Plug-in Details.
    EilfFeature.png


Useful Information You don't have to modify the build file (make.xml) to include your bundle in the build process. The make.xml file includes all SMILA bundles located under the local trunk folder, along with those bundles whose names match its <patternset> elements (com.*, net.* and so on). If you get an error such as "Unable to find bundle xxx", it's probably because it is not matched by make.xml and it is not copied to the build folder. If you don't want to include your new bundle into the build process, the bundle has to be excluded explicitly in make.xml. For further information see: Introduction to make.xml.

For information on how to build the SMILA distribution see: How to build a SMILA distribution.

2. Optionally: Generate Source Bundle

The build process can also generate an additional source bundle for a new bundle so that debugging is easier when SMILA is used as a target platform (see How to set up the integration environment). This needs some manual modification of the files of the feature that includes the bundle:

  • In org.eclipse.smila.feature/build.properties add a line like this using the bundle name of your new bundle:
generate.plugin@org.eclipse.smila.sample.pipelet.source = org.eclipse.smila.sample.pipelet
  • In org.eclipse.smila.feature/feature.xml add an entry like this to include the source bundle in the feature:
   <plugin
         id="org.eclipse.smila.sample.pipelet.source"
         download-size="0"
         install-size="0"
         version="0.0.0"
         unpack="false"/>
Ignore the warning that the bundle cannot be resolved. It is generated automatically at build time.
  • In your bundle be sure to add at least the META-INF directory, the about files and the build.properties to the build configuration of the source build. Add additional files (schemas, sample configs, etc) as appropriate. Do NOT add the code/src or other source directories, this is done automatically by the build process:

SMILA-bundle-source-build-properties.png

Back to the top