构建Tomcat 6

目录

• 介绍
• 下载JDK5及以上发布包
• 安装Ant1.8及以上
• 检出或获得Tomcat6源代码
• 构建Tomcat
• 使用Eclipse构建
• 使用其它IDE构建

介绍

从SVN构建Apache Tomcat非常简单， 也是向Tomcat贡献的第一步，下面一步一下的操作步骤。

下载JDK5及以上发布包

JDK发布包可以从这里下载
重要： 设置一个环境变量JAVA_HOME，指向你安装JDK发布版的目录。

安装Ant1.8及以上

从这里下载Ant1.8及以上的二进制发布包

解压二进制发布包到一个合适的位置，这样Ant发布程序可以放在属于它自己的目录里（约定目录名叫作：”apache-ant-1.8.x”）。为了下文方便的目的，”${ant.home}“被用来引用发布目录的全路径。

创建一个ANT_HOME环境变量指向${ant.home}，然后修改PATH环境变量包含目录${ant.home}/bin，这使ant命令行脚本可用，构建时会展示他的实际作用。

检出或获得Tomcat6源代码

Tomcat 6.0 的SVN仓库地址：http://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk/

从http://tomcat.apache.org/download-60.cgi下载源代码包

使用SVN检出源代码，选择一个已发布的tag版本或者trunk的开发代码，或者下载解压一个源代码包。放置源代码的目录会以${tomcat.source}为引用名

构建Tomcat

使用下面的命令：

cd ${tomcat.source}
ant download
ant

警告： 运行ant download命令行会下载构建需要的库到默认的/usr/share/java目录。在典型的Linux或者MacOS系统上，即使你这样做，写到这个目录对你来说可能不合适。在Windows上这个目录通常是和c:\usr\share\java目录一致。除非你使用的是Cygwin。阅读下面的部分学习如何自定义二进这制文件的下载目录。

注意： 通过代理访问Internet的用户必须使用一个属性文件指向Ant代理配置。见下文。

可以通过创建一个${tomcat.source}/build.properties文件来控制构建，添加如下内容到文件中：

# ----- 代理设置 -----
# 如何使用代理服务请解除注释
#proxy.host=proxy.domain
#proxy.port=8080
#proxy.use=on

# ----- 依赖包的默认基准目录 -----
# 替换需要下载的依赖二进制包的下载目录
base.path=/home/me/some-place-to-download-to

使用Eclipse构建

重要： 这不是一个受支持的构建Tomcat的手段。这里提供的信息不被保证:-)。唯一被支持的构建Tomcat的手段是使用上面提到的ant build命令。然而，一些开发者喜欢使用一个Java IDE来编码，这些开发者可以使用下面的步骤来工作。

注意你必须完成所有上面的步骤来获取依赖包并首次构建一些Jar文件。当你完成上面的步骤后，你可以设置一个Eclipse工程。注意这样在Eclipse下不会让你完成所有的构建。构建过程的许多阶段需要使用Ant而不是简单的Java编译。然后，它允许你查看和编辑Java代码、获得警告、重格式化代码、执行重构、在IDE下运行Tomcat等等 。

使用菜单Windows –> Preferences –> Java –> Build Path –> Classpath Variables来添加两个新的类路径变量：

在根目录下有两个文件，eclipse.classpath和eclipse.project，分别以新名字创建它们的副本，.classpath和.project。
使用菜单File –> Import –> Existing Projects into Workspace –> 选择你检出的Tomcat源代码的根目录。

在Tomcat仓库的根目录里提供的Eclipse的.project 和 .classpath文件会允许Eclipse找到所有的源代码树和jar包，有希望编译不会出现问题。注意这些文件假定你正在使用一个JDK5及以上的Eclipse。

不使用特殊的IDE插件来运行Tomcat，你可以简单地使用菜单Run –> Run… ，然后输入”org.apache.catalina.startup.Catalina” 作为主类，”start”作为程序参数，”-Dcatalina.home=…(你的构建目录的名字)”作为JVM参数。

使用其它IDE构建

应用上面提到的对Eclipse的同样的警告。
同样，通常的做法应该在大部分IDE下会奏效，比如据报告这样在Idea下工作正常。

其它

本文翻译自官网：http://tomcat.apache.org/tomcat-6.0-doc/building.html
注意：尊重劳动成果，转载请注明出处，谢谢！