使用Ant编译Eclipse源代码

一、什么是Eclipse源代码编译？

Eclipse源代码编译提供开发者一个自动方法来编译java代码，产生javadoc，最后，产生一个zip文件，从下载的源代码树而来的eclipse运行体。源代码编译最终的结果是一个可以运行的Eclipse。

 

二、获得源代码

源代码编译下载包含所有的java代码，非java资源和脚本，编译一个完整版本的Eclipse所需要的。尽管你可以手工编辑build.xml文件在每个feature和plugin里，他们是由eclipse pde-build plugin产生的。作为一个结果，你需要下载一个新的源代码编译zip文件当eclipse源代码版本发生改变时，例如增加或减少插件。Eclipse的详细源代码编译的版本建立是包含在源代码编译的zip文件名。例如，eclipse-sourceBuild-srcIncluded-3.0.zip 编译 Eclipse 版本 3.0

 

        源代码下载地址： http://download.eclipse.org/eclipse/downloads

        当前版本：3.1.2               eclipse-sourceBuild-srcIncluded-3.1.2.zip               63 MB

 

三、        使用Ant和JDK来编译Eclipse

1、   描述

使用一个你安装的java编译器来产生一个Eclipse SDK。

 

2、   系统要求

a、 Ant 1.6.1或更高，目前Ant 1.6.5

下载地址： http://ant.apache.org/bindownload.cgi

 

b、 JDK 1.4，目前是5.0

下载地址： http://java.sun.com/j2se/1.5.0/download.jsp

 

c、 Info-Zip 压缩和解压缩软件，*nix下使用Tar。

下载dos版本。

UnZip 5.52               unz552x3.exe

下载地址： http://www.info-zip.org/pub/infozip/UnZip.html

 

Zip 2.31        zip231x.zip

下载地址： http://www.info-zip.org/pub/infozip/Zip.html

 

d、 1GB的空余硬盘空间

e、   源代码编译zip文件，从eclipse.org下载。

 

3、   初始设置

按照指示安装Ant和JDK。至少你要设置下边几个环境变量：

a、   增加Ant的执行目录到你的path

b、   设置JAVA_HOME环境变量为你的JDK的安装根目录

c、   设置ANT_HOME环境变量为你的ANT的安装根目录

d、   (Windows 98)增加默认的环境空间大小指定。

 

4、   开始编译

a、   将eclipse-sourceBuild-srcIncluded-*.zip文件解压缩到一个空目录里。*nix下使用tar解压缩。

b、   改变目录，使用cd命令：

c、   运行：build -os <osType> -ws <windowSystemType> -arch <architecture> [-bc <bootclasspath>] [-compilelibs] [-target <target>]

 

参数名称	描述
osType	目标操作系统类型
windowSystemType	目标视窗系统类型
architecture	目标系统架构
bootclasspath (optional)	列出编译需要的jars，用冒号或分号来分隔。这些jars是JDK或者JRE的补充。需要指定这个参数仅仅在你交叉编译eclipse或者使用一个JDK但没有使用一个rt.jar文件在所包含的java库里。默认rt.jar在你的path里。
compilelibs	强制编译本地库的标志
target (optional)	Ant选择build.xml里的目标来执行，默认的是run，完成一个编译，并产生一个安装文件。 其它合法的目标有： compile(编译java代码和产生javadoc) clean install

 

 

5、   安装Eclipse

当Eclipse编译完成，会产生一个zip文件：

 

<osType>-<windowSystemType>-<architecture>-sdk.zip

 

在你编译目录的result子目录里。如果你在linux或Mac下编译，产生一个tar.gz文件。

解压缩这个文件到你要运行eclipse的目录里，如果你将它解压缩到根目录里，一个名为：eclipse的目录将被建立。运行eclipse使用合法的命令行参数。

 

四、支持平台

eclipse可以被建立在下面的平台上。除了一些小小的限制，可以在任何平台上为其他支持的平台编译eclipse

 

Operating System (os)	Windowing System (ws)	Architecture(arch)
win32	win32	x86
linux	gtk	x86
linux	gtk	ppc
linux	gtk	ppc64
linux	gtk	x86_64
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

 

 

五、已知限制：

a、   在windows下编译unix平台会出现不正确的文件属性。*.so，*.sl，和eclipse执行文件将没有执行权限。另外，linux-motif和linux-gtk编译将没有联接到libXm.so.2.1在安装根目录。对于这些问题你不得不写一个安装脚本来设置权限属性。(在UNIX系统上做UNIX编译可以设置足够的权限和设置正确的联接)

 

b、   只有java源代码被编译。*.dll，*.so，*.sl和eclipse执行文件都提供预编译在这个编译过程前。Linux-gtk-ppc64,linux-gtk-ia64,hpux-motif-ia64_32和hpux-motif-ia64设置需要一个eclipse执行文件和swt库的再编译，复制这些文件到适当的目录中。这可以被完成在运行编译时，使用-compilelibs选项。关于再编译eclipse执行文件和再编译swt库的指导，在SWT FAQ中有一个有用的参考。这个文档也包括了在linux GTK下运行SWT的先决条件的列表。

 

c、   如果你希望使用1.5JDK来编译eclipse，将你源代码中的build.xml中的javacSource的值改为1.4。