Using SVN with Ant

摘要 ：

Subversion 是越来越被广泛使用的版本管理工具，使用Ant 脚本从Subversion 获取代码，实现Daily Build 。

 

1 ． Subversion 概述

先引用 Version Control with Subversion 中开头的话：

 

“ If C gives you enough rope to hang yourself, think of Subversion as a sort of rope storage facility.”

                                                          —Brian W. Fitzpatrick

 

然后告诉大家CVS是旧爱，Subversion是新欢。列举若干Subversion的特性和优势为证，懒得写了，直接看这里： Subversion的老家。

关于如何使用Subversion以及相关客户端软件，网上慢慢看吧， 官方自由图书不错。

 

2 ．蚂蚁出场

团队最近的项目中即使用Subversion作为版本控制工具。Daily Build过两天就得搭建起来了，上蚂蚁！

Tigris.org提供了Subclipse，SvnClientAdapter和SvnAnt。(见 这里)

Subclipse是一个Eclipse的插件，实现了IDE与Subversion得集成；

SvnClientAdapter是Subversion的一套Java API，封装了客户端对Subversion的一些访问操作；

SvnAnt是用于访问Subversion的Ant任务，其依赖于SvnClientAdapter。

我要用的就是SvnAnt，用SVN Check Out一份SvnAnt的代码：

svn co http://subclipse.tigris.org/svn/subclipse/trunk/svnant/ svnant

在这个工程里面还包括svnant的Ant Task使用说明文档，也可以在 这里直接查看。

使用其中的 build.xml编译SvnAnt后，在新生成的build子目录下会生成svnant.jar。按照官方文档的说法，把这个svnant.jar和 SvnAnt工程的lib目录下的svnClientAdapter.jar和svnjavahl.jar拷贝到Ant的目录下即可。然后编写如下的 Ant脚本进行测试：

<?xml version="1.0"?> <project name="SVN Ant Test" default="checkout" basedir=".">        <!-- 1 -->        <property name="remote.url"               value="svn://16.157.xxx.xxx/trunk/LNPORTAL/src/P3UIPAdapter/" />        <property name="local.dir" value="local" />            <!-- 2 -->        <taskdef name="svn" classname="org.tigris.subversion.svnant.SvnTask" />        <target name="prepare"               description="Prepare the dirs for other tasks">               <delete dir="${local.dir}" />               <mkdir dir="${local.dir}" />        </target>        <!-- 3-->        <target name="checkout" depends="prepare">               <svn javahl="true" username="lihq" password="password" >                      <checkout url="${remote.url}" destPath="${local.dir}" />               </svn>        </target> </project>

测试结果暂时不重要。

 

3 ． JavaSVN 出场

SvnAnt的执行依赖SvnClientAdapter，而执行访问SVN时又有两种形式：其一是通过SVN 命令行程序的形式进行的（我在想：如果是这样，还不如使用Ant的exec任务呢）；其二是通过Javahl来执行的。

Javahl是一个用于访问Subversion的Java接口（估计是JNI），这需要Windows机上有svnjavahl.dll才行。团队的Daily Build的并不是Windows，于是求助JavaSVN，这是一个纯Java的SVN解决方案。

请访问这个Guide： Making SvnAnt use JavaSVN

我的实际步骤如下：

Step 1 ：从Ant的lib目录下移除SvnClientAdapter.jar，我没有发现javahl.jar，于是便移除了svnjavahl.jar，其实移不移后者无所谓；

Step 2 ：在刚才那个页面下载javasvn.jar和javasvn-javahl.jar，以及JavaSVN的svnClientAdapter-0.9.32.jar。并把这三个jar都拷贝到Ant的lib目录下；

然后运行上面写的SVN Ant测试脚本，结果如下：

… BUILD FAILED java.lang.AbstractMethodError: org.tigris.subversion.svnant.Feedback.logRevision(J)V   Total time: 7 seconds

虽然SVN的代码都取下来了，但最后Ant会抛出一个如上的错，这会使得Ant脚本无法运行后面的任务。

 

4 ．Thanks Open Source

看来，大 概是JavaSVN用自己的svnClientAdapter-0.9.32.jar改变了SVNAnt本来对调用。SVNAnt（by Tigris.org）原先是调用svnjavahl.jar来运行SVN命令的。替换svnClientAdapter-0.9.32.jar 后，SVNAnt（plus JavaSVN）是调用javasvn-javahl.jar和javasvn.jar来运行SVN命令的。上面那个错误大概就是两套 svnClientAdapter对某个抽象方法的定义不完全一致造成的，估计是API版本对应的问题。解决如下：

首先查看 svnant.jar的源代码，发现org.tigris.subversion.svnant.Feedback是实现 svnClientAdapter.jar中的一个名为ISVNNotifyListener的接口。这个接口中对报错的logRevision方法的定 义是：

public abstract void logRevision(long revision, String path)

而查看svnClientAdapter-0.9.32.jar中的ISVNNotifyListener的接口中的定义是：

public abstract void logRevision(long revision)

明显不匹配，于是修改svnant.jar的源代码，修改org.tigris.subversion.svnant.Feedback，象其中添加一个方法如下：

//This method is added by Beegee public void logRevision(long revision) { }   //This method is the original one by SVNANT public void logRevision(long revision, String path) { }

然后重新编译SVNAnt，生成svnant.jar，拷贝替换Ant 的lib目录下的同名jar，重新运行以上SVN Ant测试脚本

 

测试方面自己可以操作~