Eclipse Source Builds (Source from CVS)
Table of Contents
- What is an Eclipse source build?
- Getting the source
- Building 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 checking
out source code and other required resources, compiling the Java code, generating
javadoc, and finally, creating a zip file of an Eclipse runtime from a downloaded
source tree. The end result of a source build is a runnable Eclipse.
Getting the Source
A source build download contains shell and ant scripts that fetch and 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-I20030624.zip
builds Eclipse from integration build 20030624.
Building Eclipse using Ant and a JDK
Description
Produces an Eclipse SDK using the Java compiler you have installed.
System Requirements
- Ant 1.6.1 or higher
- 1.4 and 1.5 JDK
- Info-Zip
zip and unzip executables on system path. Tar for *nix distributions
- CVS 1.10
or higher
- 1 GB free disk space
- Source build zip from eclipse.org
Initial Setup
Install Ant, 1.4 and 1.5 JDKs, and a CVS client, as per each program's instructions. Minimally
you will need the following environment variables set.
- Add the Ant bin directory, and the CVS executable to your path.
- Set the JAVA_HOME environment variable to the root of your 1.4 JDK installation.
- Set the ANT_HOME environment variable to the root of your Ant installation.
- (Windows 98) Set the HOME environment variable to c:
- (Windows 98) Increase the default environment space as specified here.
Run the Build
- Extract the eclipse-sourceBuild-*.zip to a directory. Extract using tar if using a *nix drop.
- cd to the buildScripts directory.
- Execute build -os <osType> -ws <windowSystemType> -arch <architecture> -java5home <java 5 installation>
[-bc <bootclasspath>] [-compilelibs] [-target <target>]
Parameter Name | Description |
osType | Target operating system (See
supported types). |
windowSystemType | Target windowing system (See
supported types). |
architecture | Target system architecture (See
supported types). |
java 5 installation | Path to root directory of 1.5 JDK installation. Libraries in install used to compile plug-ins in the eclipse SDK that require 1.5 compliance (currently only JDT APT). This directory should contain /bin/javadoc or /bin/javadoc.exe required to generate javadoc for JDT APT. |
bootclasspath (optional) | The default list of bootclasspath jars to compile against using
either a colon or semi-colon as separators. The jars that make up a
bootclasspath are part of any JDK or JRE. Typically this parameter is
only specified if you are cross compiling Eclipse. The default is set to the
jars in the JDK or JRE in JAVA_HOME. |
compilelibs | Flag to force the recompilation of native libraries. |
target (optional) |
The Ant target from build.xml to execute. The default target is run
and performs a complete fetch, build, javadoc build and install. Other
valid targets are: |
Install Eclipse
When the Eclipse build is complete, there will be a zip file called
<osType>-<windowSystemType>-<architecture>-sdk.zip
in the results subdirectory of your build directory. If you are building for Linux or Mac, there will be a tar.gz file.
Extract this file to the directory where you would like to run Eclipse. If
you extract it to your root directory, a directory called eclipse will be created.
Run Eclipse with the desired
command line parameters.
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) | Archecture |
win32 | win32 | x86 |
linux | gtk | x86 |
linux | gtk | x86_64 |
linux | gtk | ppc |
linux | gtk | ppc64 |
linux | gtk | ia64 |
linux | motif | x86 |
macosx | carbon | ppc |
aix |
motif | ppc |
hpux | motif | PA_RISC |
hpux | motif | ia64_32 |
qnx | photon | x86 |
solaris | motif | sparc |
solaris | gtk | sparc |
solaris | gtk | gtk |
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 checked out of dev.eclipse.org prebuilt in this build process. The
linux-gtk-ppc64, linux-gtk-ia64, linux-gtk-ia64_32 and hpux-motif-ia64 configurations
will require a re-compilation of the eclipse executable and swt libaries
and copying these files to the apppropriate directories.
This can be accomplished by using the -compilelibs flag when running the
build. The instructions on recompiling
the eclipse executable and recompiling
the swt libraries available in the SWT
FAQ are also a useful reference. This document also includes a list of
the prerequisites for
running SWT on Linux GTK
Using the source build to construct a new Eclipse
port
The Eclipse platform releng team has limited hardware, software and time to compile Eclipse on every conceivable platform. If you would like to enhance
the source build scripts to build eclipse on a platform
that is not currently included, please follow the following steps:
- Extract the source build drop
- Update the build.bat and build files to reflect the new architecture. For
example:
- in the build file: add an another entry to the if [ "$os-$ws-$arch" = "linux-motif-x86" ]
line similar to || [ "$os-$ws-$arch" = "newOs-newWs-newArch"]
that reflects the new os-ws-arch combination
- in the build.bat file:
add an entry similar to if %os%-%ws%-%arch%==NewOs-newWs-newArch goto run that reflects the new os-ws-arch combination
- Copy an existing assemble.org.eclipse.sdk.os.ws.arch.xml script to a new one that
indicates that platform being built
- In the build.xml
- update the compilelibs property in the init target to reflect the new
architecture
- update the compilelibs target to reflect the new architecture
- Run the build using "build -compilelibs" to force the recompilation
of the native libaries
- Patches may be required to the swt native library and launcher build scripts
to compile the new port. The swt native library files
and launcher source and build files are stored in the swttmp and launchertmp
directories respectively.
- Please open a bug with platform-releng with patches required to build this platform so they can be included in future source
builds. This allows others to use your contribution and compile the new eclipse
port