Using SVN With Ant

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测试脚本，结果如下：
　　

　　OK！
　　－end－