GEF/GEF4

From Eclipsepedia

Jump to: navigation, search

This page is the entry page for all information related to the GEF4 provisional component.

Introduction

As agreed on in Bugzilla 347636, development of a new GEF 4.0 API will be started in parallel to the current GEF 3.x development branch under the following terms:

  1. After the Indigo release has been completed, a GEF experimental branch is created by forking the GEF 3.7 code-base into a Git repository (possibly located next to Zest 2.0, so that all experimental GEF components can be found in one place).
  2. The experimental branch created thereby will live parallel to the GEF HEAD branch, considering all its API as provisional unless explicitly graduated. It will not interfere with GEF HEAD, i.e. it will have its own build process and separate wiki pages for documentation of the ongoing work (similar to Zest 2.0).
  3. Committers working on the experimental branch will be responsible for ensuring fixes made to GEF HEAD also get applied to the experimental branch.
  4. Graduation of the experimental branch back into GEF HEAD will have to imply that a proper compatibility layer is in place so all GEF 3.x clients run in a 100% binary compatible method. It will furthermore have to be acknowledged by all GEF committers.
  5. Work will start without an incubator project at first, granting commit rights on the Git repository to all current GEF committers. The question of introducing an incubator project (located under GEF) will be deferred until a) community wants to actively get involved or b) Juno has been released (whatever comes first).

As migration of GEF to git has not been completed yet (see Bugzilla 351232 for details), development has been started by creating a new Geometry API, based on the current Draw2d geometry classes (see Bugzilla 355997 for details).

Due to the lessons learned in developing an initial GEF 4 Geometry API, and due to the compatibility requirements imposed on a gradation of the new GEF4 API, migrating the existing code base on a module-per-module basis probably is more appropriate than branching the whole code base at once. The completion of the GEF4 Geometry API could be the first package that is to be completed with respect to this. Based on the Geometry API, other packages may then be investigated, as outlined in the Roadmap below.

Builds/Update Sites

A Tycho-based build infrastructure for the GEF4 component has been configured under https://hudson.eclipse.org/hudson/job/gef4-nightly-tycho. The build job will be triggered hourly in case of changes to the source code repository, or at least once per day. It produces an update-site, which does not get promoted to downloads.eclipse.org, but can directly be consumed from:

In addition to this, integration, milestones, and release builds are be promoted to updates sites, which are promoted to downloads.eclipse.org and can thus be found here:

While integration builds are promoted automatically once per week (every friday), milestone and release builds will be published only manually on the respective occasions. Note that those update sites for integration, milestones, and releases will further be merged (i.e. the former content gets preserved when publishing new one), while the nightly update site contents gets replaced on each build.

Components / Roadmap

  • GEF4 Geometry - Q4 2011
  • GEF4 Graph (current org.eclipse.draw2d.graph)
  • GEF4 Draw2d Core (Graphics, Canvas, Figure, Bounds, etc.)
  • GEF4 Draw2d Shapes
  • GEF4 Draw2d Text