Orbit/Easy Bake Builds with Orbit Bundles
During the Eclipse 3.3 M5 cycle, The Eclipse Team (Platform, JDT, PDE and Equinox) started consuming Orbit bundles in their builds. To facilitate this transition, PDE build was modified to support fetching builds from a http repository. See Bug 171869 Support for HTTP in map files PDE build also supports checking out multiple versions of the same plugin.
Before starting, it is very important to note that you must still receive approval from the Eclipse Foundation before including any third party bundles in your build. See the Orbit Faq and and Orbit web page for further information.
The process that we use to consume the Orbit builds can be summarized in three simple steps:
- Use a recent copy of PDE build in your builder with support for fetching prebuilt bundles - 3.3 M6 is the latest.
- * Consume the Orbit map file directly by fetching it during your build process. The Orbit build process generates map files with the lists of bundles that produced with each build.
For example, see the latest stable Orbit build - there are links to the map files in
CVS format or http GET format.
- * Update your local map file entry with the path to the Orbit bundle. The platform releng team has added an orbit.map to their map file project org.eclipse.releng/maps, see example orbit map The reason we don't consume the Orbit map directly yet is because we are migrating to Orbit bundles on a ongoing basis. If we consumed the Orbit map file directly today, we would have duplicate locations for the several bundles which would cause build issues. Once we have migrated completely to consuming all our third party libraries from Orbit, we plan to modify our build process to consume the Orbit map file directly and remove the orbit.map from our map file project.
- If you are adding a new bundle to your build, update the appropriate feature with information for the new Orbit bundle.
Each milestone, the Orbit team releases a milestone before the Eclipse team enters milestone week. This allows the Eclipse team to step up to the latest Orbit milestone before starting our milestone week. See the Orbit Promotion, Release, and Retention Policies for more detail.
Since everyone's build process is different, I invite other teams to add to this document with further information describing how they incorporated Orbit bundles in their builds.