Eclipse Source Builds (Source from Zip)

Table of Contents

What is an Eclipse Source Build?

Eclipse source builds provide developers with an automated method for compiling
the Java code, generating javadoc, and finally, copying launcher files to the
right location to launch Eclipse from a downloaded source tree. The end result
of a source build is a runnable Eclipse.

Getting the Source

This source build download contains all the Java code, non-Java resources,
and scripts that build a particular version of Eclipse. Although you can manually
edit build.xml files in each feature and plug-in, they are typically generated
by the Eclipse pde-build plug-in. As a result you will need to download a fresh
source build zip file when major changes occur to Eclipse source, such as the
addition or removal of plug-ins. The version of Eclipse a particular source
build will create is embedded in the source build zip file name. For example,
eclipse-sourceBuild-srcIncluded-2.0.zip builds Eclipse version 2.0

The full path to the rt.jar to compile against. The rt.jar
file is part of any JDK or JRE. Typically this parameter is only specified
if you are cross compiling Eclipse. The default is the rt.jar on your
path.

target (optional)

The Ant target from build.xml to execute. The default target is run
and performs a complete build, javadoc build and install. Other valid
targets are:

compile (compiles Java code and generates javadoc)

buildDoc (creates doc.zip files in *.doc.isv and *.doc.user plug-ins)

install

Building Eclipse using Eclipse

Description

Produces an Eclipse SDK compiled with the Eclipse Java compiler and built in
Ant
support.

System Requirements

Eclipse build F3
or later installed and running. i.e. installed with a JDK or JRE (version
1.3 required).

A source build zip file from eclipse.org

JDK 1.3 or higher
(optional - used for building javadoc. A JRE will not include the javadoc
tool)

300 meg free disk space

Initial Setup

Install Eclipse and a JDK (if you wish to generate javadoc) as per each program's
instructions.

Run the Build

Extract eclipse-sourceBuild-srcIncluded-*Zip to an empty directory.

Start Eclipse.

Choose File->New->Project

Choose Simple Project, click Next.

Enter a project name.

Under Project contents, deselect Use default, and set the contents to the
eclipse-sourceBuild-srcIncluded*.zip installation directory. Click Finish.

The full path to the rt.jar to compile against. The
rt.jar file is part of any JDK or JRE. Typically this parameter
is only specified if you are cross compiling Eclipse. The default
is the rt.jar on your path.

For example: Dos=win32,-Dws=win32

Deselect"Show execution log in console". Building is pathologically
slow if you leave this option selected (see bug 19520)

Click "Finish".

(Optional) To recompile the source, deselect the "run" target
and select the "compile" from the list of available targets. Other
valid targets you may wish to run are:

fetchAll

compile (compiles Java code and generates javadoc)

buildDoc (creates doc.zip files in *.doc.isv and *.doc.user plug-ins)

install

Supported Platforms

Eclipse can be built on any of the following platforms. With some limitations
any platform can be used to build Eclipse for any or all supported platforms.

Operating System (OS)

Windowing System (WS)

win32

win32

linux

motif

linux

gtk

solaris

motif

aix

motif

hpux

motif

qnx

photon

Known Limitations

Building unix flavours of Eclipse on Windows will result in incorrect file
permissions. The *.so, *.sl, and Eclipse executable files will not have execute
permissions. In addition, linux-motif and linux-gtk builds will not have soft
links to libXm.so.2.1 in the installation root directory. In these cases you
would have to write an install or post install script to set permissions properly.
(UNIX builds built on UNIX systems will set sufficient permissions and make
the appropriate soft links).

Only Java source code is compiled. *.dll, *so, *sl and Eclipse executables
are all provided prebuilt in this build process.