构建 James 工具

取得源代码
有两种办法可以得到James的源代码。

1. 下载源代码的发布文件 - James 的下载目录提供源码的下载. 你只要选择想要下载的那个James版本，进入那个版本的src目录，然后选择适合你的系统平台的源码发布文件就行了。这种方法很简单。

2. 用CVS取得源码- 用这种方法你可以访问最新的代码库。关于如何用CVS取得James源码（jakarta-james发布文件）的指导，可以在这里找到。

需要的工具
构建James需要两个第三方提供的工具。

1. Java开发包 - 要构建James的发布文件，你的机器上必须安装有JDK 1.3或者更高版本。你需要根据自己的系统平台选择适当的JDKs，下载并安装完成之后才能进行James的构建。

2. Ant - 这是一个用于Java的、可用XML进行配置的、可扩展的构建或者说是构造系统。在James的源码树中包含了Ant v1.5。你可以在这里找到最新的版本。但既然现在James的源码发布文件里包含Ant，你就没有必要再单独下载它了。

构建发布文件
在James源码发布文件的顶层目录中有两个用于构建的辅助脚本。脚本build.bat用于Windows系统，而build.sh适用于Unix系统。每个脚本都带了一组可选的参数，这些参数告诉脚本构建一个什么样的James。

要使用这些脚本，需要将环境变量JAVA_HOME设置为JDK的根目录。然后就可以运行构建脚本了，下面的任何命令行参数都是可选的。

clean - 删除构建目录，使系统准备一个清除构建。
compile - 编译源代码。
dist - 产生所有的James发布文件并打包。
dist-lite - 产生所有的James发布文件但不打包。这是一个默认的参数。
javadocs - 构建James的javadocs。。
usage - 输出脚本使用的指令。
website - 构建完整的James网站。
xdocs - 创建James的文档。

所有构建的产品都会输出到James源码发布文件的dist子目录中。在构建过程中还会在James源码发布文件的目录下创建一个build子目录。 如果你用clean参数构建这两个目录都会被删除。

警告！你在 'dist'目录下所做的任何改变在重新编译都会丢失，所以如果你要对config.xml或其它文件做修改，我们建议你先备份src目录，然后在src目录里修改以免丢失工作。