Eclipse Builder

- Creates Eclipse distributions for Linux (GTK), Mac OSX and Windows using the P2 Director application

Prerequisites

A Bash shell version 4.0 or greater (Attention: Mac OSX still ships with version 3.2!)
A recent P2 director application like the Buckminster's headless director or a standard Eclipse distribution from http://download.eclipse.org. Important: P2 Director version 4.5 (Neon) or higher is required for Mac OSX builds!
The eclipse-builder.sh script from https://github.com/ferstl/eclipse-builder
One or more configuration files describing the content of the Eclipse distribution to be built

The configuration file(s)

A configuration file contains the information which installable units (IUs) will be installed into the Eclipse distribution and where to download them:

remote-url:http://download.eclipse.org/releases/neon
local-url:file:///home/me/my-local-repository
tag:Basic Installation
iu:org.eclipse.epp.package.standard.feature.feature.group
iu:org.eclipse.jgit.feature.group
iu:org.eclipse.egit.import.feature.group
iu:...

Tag	Description
`remote-url`	URL of the remote repository where the listed IUs can be downloaded. The configuration file must contain one or more `remote-url` tags.
`local-url`	Alternative URL where the listed IUs can be downloaded. This tag can be used to get the IUs from a locally mirrored repository or from a P2-enabled Nexus repository manager. The configuration file must contain one or more `local-url` tags in case the script is executed with the `--local` option.
`tag`	Name of the installation tag. The tag will be shown in the installation history of the built Eclipse distribution. This tag is optional.
`iu`	IU to be installed in the Eclipse distribution. The configuration file must contain one or more `iu` tags.

Example Configuration

There are two configuration files in the eclipse-neon-example folder to build an Eclipse "Neon" distribution containing the Java IDE, EGit and M2Eclipse. The configuration file 01_eclipse-ide.conf will create an Eclipse 4.5 distribution. The file 02_eclipse-base.conf will add EGit and M2Eclipse.

How to run the eclipse-builder.sh Script

Running eclipse-builder.sh --help shows how to use the script:

Usage: eclipse-builder.sh <options> <configs>
  <options>:
    -c --p2command    Command to start the P2 director
                      (default: $BASEDIR/eclipse/eclipse)
    -l --local        Use local (on-site) repositories to download installable
                      units.
    -p --platform     Distribution platform. The currently supported platforms
                      are "linux", "macosx", "windows" (all 64bit)
    -d --destination  Destination directory (must be a fully qualifed name!)
                      for the created distributions
    -n --name         Name of the created distribution
                      (default: custom-eclipse)
    -h --help         Print this help message
  
  <configs>: Configuration files

Examples

The following examples are based on the directory structure below where the eclipse-builder.sh script, the P2 Director and the configuration files are located in the same directory.

/home/me/my-eclipse-build/
  |- eclipse/
  |   |- ...
  |   |- features/
  |   |- plugins/
  |   |- ...
  |   |- eclipse
  |   |- ...
  |
  |- eclipse-neon-example/
  |   |- 01_eclipse-ide.conf
  |   |- 02_eclipse-base.conf
  |
  |- eclipse-builder.sh

Example 1: Create a plain Eclipse 4.5 IDE distribution for Linux:

This command will create the Eclipse distribution in ~/my-eclipse-build/distros/my-personal-eclipse-ide-linux-gtk-x86_64:

cd /home/me/my-eclipse-build
./eclipse-builder.sh \
--platform linux \
--destination /home/me/my-eclipse-build/distros \
--name my-personal-eclipse-ide \
eclipse-neon-example/01_eclipse-ide.conf

Note that the --destination option requires a fully qualified path! Relative paths won't work due to this Bug.

Example 2: Create Eclipse 4.5 distributions for all supported platforms using local repositories:

This command will create Eclipse distributions for all three supported platforms in ~/my-eclipse-build/distros/my-personal-eclipse-distribution-<platform>

cd /home/me/my-eclipse-build
./eclipse-builder.sh \
--local \
--platform linux \
--platform macosx \
--platform windows \
--destination /home/me/my-eclipse-build/distros \
--name my-personal-eclipse-distribution \
eclipse-neon-example/01_eclipse-ide.conf \
eclipse-neon-example/02_eclipse-base.conf

Example 3: Create an Eclipse distribution when the eclipse-builder.sh Script is in a different directory

Assuming that the eclipse-builder.sh script and the example configuration files are in a different directory called /home/me/eclipse-builder, the --p2command has to be set to point to the executable of the P2 director application:

cd /home/me/eclipse-builder
./eclipse-builder.sh \
--p2command ../my-eclipse-build/eclipse/eclipse
--platform linux \
--destination /home/me/my-eclipse-build/distros \
--name my-personal-eclipse-distribution \
eclipse-neon-example/01_eclipse-ide.conf \
eclipse-neon-example/02_eclipse-base.conf

If you are using Buckminster's headless director, set --p2command ../my-eclipse-build/director/director.

ferstl/eclipse-builder