Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Eclipse update site is

...

a website that is part of the mirrored Apache distribution on apache.org/dist/incubator/uima/eclipse-update-site.

Due to an error in setting this up initially, there is also a directory .../incubator/uima/eclipseUpdateSite. The next release will put things on the eclipse-update-site directory, and remove the temporary .htaccess file that is redirecting eclipse-update-site to eclipseUpdateSite.

The build process packs and compresses the plugin jars, and builds a packed/compressed form of the website, using Eclipse tooling to do this.

...

The update site support consists of 2 feature projects and one update site project. The 2 features are there because one feature is for users who might wish to integrate UIMA into an RCP - it consists of the "runtime" part of UIMA, without the Eclipse tooling plugins for UIMA. The other feature are the Eclipse tooling plugins for UIMA. The 2nd feature has the first one as a prerequisite, and also prereqs EMF.

The update site "build" is done by an ant script called by maven's ant-run plugin, but the script (called build.xml, and located in the eclipse-update-site project) can also be run directly (for testing).

Each time we go to a new version, we (currently) keep all things version-synchronized. The 3 projects have version information in them that is udpated.

The Eclipse update site (in apache.org/dist/incubator/uima) holds many versions. (The number is up to us - but for now, it will hold all the versions). The HEAD of the SVN always has the current version. When a new version is created, the version numbers in the project are incremented, and the site.xml in the eclipse-update-site project is augmented to add the new versions of the plugin.

Currently, the strategy is to do a new version with every uima release, so everything is kept in sync.

Old , however, needs to keep the old versions that were previously put up as part of the update site, are kept available. There are 3 kinds of information that are kept for older versions:

  1. the site.xml - holds references to previous versions
  2. the jars built for the features (these are very small, and are kept in the update site's features directory
  3. the jars for the associated plugins, and are kept in the update site's plugins directory

...

  1. the jars for the associated plugins
    The previous jars are kept on apache.org/dist/incubator/uima.

Update site build process

The version numbers are incremented in the 2 feature projects and the site project, and new site entries are added for the new version. The build process will create the update site in the /target of the eclipse-update-site project; this will be complete except for the jars of the previous version of the update site. The "upload" for this will therefore need to merge these files with the existing files in the update site.