Eclipse Source Builds (Source from Zip)
Table of Contents
- What is an Eclipse source build?
- Getting the source
- Building Eclipse using Ant
- Building Eclipse using Eclipse
- Setting the bootclasspath
- Supported build platforms
- Known limitations
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
To run the scripts, see instructions below on building
Eclipse using ant or building Eclipse using
Eclipse.
Building Eclipse using Ant and a JDK
Description
Produces an Eclipse SDK using the Java compiler you have installed.
System Requirements
- Ant 1.4 or higher
- JDK 1.3
- 300 meg free disk space
- Source build zip from eclipse.org
Initial Setup
Install Ant and a JDK as per each program's instructions. Minimally you will need
the following environment variables set.
- Add the Ant bin directory to your path.
- Set the JAVA_HOME environment variable to the root of your JDK installation.
- Set the ANT_HOME environment variable to the root of your Ant installation.
- (Windows 98) Increase the default environment space as specified here.
Run the Build
- Extract the eclipse-sourceBuild-srcIncluded-*.zip to an empty directory.
- cd to the directory.
- Execute build -os <osType> -ws <windowSystemType> [-bc <bootclasspath>]
[-target <target>]
Parameter Name |
Description |
osType |
Target operating system (See
supported types). |
windowSystemType |
Target windowing system (See
supported types). |
bootclasspath (optional) |
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 2.1M5
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.
- Select build.xml and select the "Run Ant" context menu item.
-
Set the following Ant properties:
os=<osType>
ws=<windowingSystemType>
bootclasspath=<bootclasspath>
Where:
Parameter Name |
Description |
osType |
Target operating system (See
supported types). |
windowSystemType |
Target windowing system (See
supported types). |
bootclasspath (optional) |
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:
os=win32
ws=win32
- Deselect"Show execution log in console".
- 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.