- 1 STEM Release Engineering
- 2 Background
- 3 Adding New Code to the Builder
- 4 Running the STEM Builder
- 5 Continuous Integration (CI) Automated Builds
STEM Release Engineering
This page details how to operate the STEM builder to create binary, platform-specific builds of STEM. This information is for advanced users and committers only.
The STEM build process is built on several foundational pieces of the Eclipse Platform. These pieces include:
- Eclipse Products
- Eclipse Features
- PDE Build Process
- P2 Provisioning
These fundamental aspects of the Eclipse Platform are orchestrated to build platform-specific binaries of STEM.
Adding New Code to the Builder
This section describes how to add new plug-ins, features, and third-party dependencies to the STEM Build process.
Adding a new plug-in to an existing feature
STEM is built from Eclipse plug-ins. This section describes how to add one or more new plug-ins to the STEM build process to an existing feature. If you want to create a new feature, see the next section.
- Determine which Feature(s) the plug-in(s) should be added to
- See note above about feature cross-dependencies to help determine which features you should add the plug-in to
- In Eclipse, expand the feature project the plug-in(s) should be added to and double-click feature.xml
- In the Feature Editor, select the Plug-ins tab
- On the Plug-ins and Fragments page, click the Add... button
- In the Plug-in Selection dialog, type the name of the plug-in you wish to add. When it shows up in the list, select it and click OK
- Repeat this step for all plug-ins you wish to add to this feature
- Save feature.xml (File-Save or Control-S)
- Commit feature.xml (Right-click Team-Commit)
- Add the plug-in to SVN
- In Eclipse, select the plug-in project you wish to add.
- Right click on the project, highlight Team and select Share Project
- Follow the steps to add it to the repository.
- Note: The STEM Source Repository has a specific layout. Please make sure to place your new plug-in an appropriate location. Often the plug-ins are grouped in folders with plug-ins of similar functionality (such as disease models )
- Add the plug-in to the build map
- In Eclipse, expand the org.eclipse.stem.releng project
- Expand the maps folder and open stem.map in the text editor
- Add the plug-in to the build map. The syntax is as follows:
- [PLUGIN_NAME] should be replaced with the plug-in name (Example: org.eclipse.stem.core)
- [REPOSITORY_PATH] should be replaced with the path in SVN where the plug-in was added, relative to trunk (Example: plug-ins added to /trunk/core would use core for the [REPOSITORY_PATH])
- Important Note: Plug-ins are grouped in the build map for project set generation. To ensure that a plug-in gets checked out, make sure it's grouped appropriately with similar plug-ins
- Save and commit build.map