ivy中文参考文档(8)-安装

安装ivy主要有两种方式，手工安装或者自动安装。

1) 手工安装

    从这里 下载你想要的版本，在任何你想的地方解开下载的zip文件，并复制ivy的jar文件到你的ant的lib目录(ANT_HOME/lib).

    如果你使用ant 1.6.0或者更高，你可以简单的到src/example/hello-ivy 目录并运行ant: 如果构建成功，你就成功的安装了ivy!

    如果你使用ant1.5.1或者更高，你不得不修改示例里面的build文件。

- 为ivy任务增加任务定义:

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->   < taskdef  name ="ivy-configure"  classname ="org.apache.ivy.ant.IvyConfigure" />
   < taskdef  name ="ivy-resolve"  classname ="org.apache.ivy.ant.IvyResolve" />
   < taskdef  name ="ivy-retrieve"  classname ="org.apache.ivy.ant.IvyRetrieve" />
   < taskdef  name ="ivy-publish"  classname ="org.apache.ivy.ant.IvyPublish" />

- 将 ivy:xxx 任务替换为 ivy-xxx

    你现在可以运行build，如果构建成功，你就成功的安装了ivy!

    如果构建没有成功，检查FAQ 看是ivyrep解析器的什么问题。

    ivy依赖

    ivy的两个二进制版本中有一个不包含可选依赖。为了通过使用ivy下载他们，你所需要做的是运行在分发包中提供的ant构建文件。这将使用ivy自己来下载依赖。然后你可以在ivy的lib目录下看到按照配置被组织的ivy可选依赖(查阅ivy.xml来得知配置的详情)。

2) 自动安装

    如果你想在仅仅在你的ant构建脚本中使用ivy，并且在你构建的时候有internet连接，你可以从自动这个站点下载ivy并使用下载的版本，使用这个简单的构建片段:

<!--<br /> <br /> Code highlighting produced by Actipro CodeHighlighter (freeware)<br /> http://www.CodeHighlighter.com/<br /> <br /> -->
     < property  name ="ivy.install.version"  value ="2.0.0-beta1"   />
     < condition  property ="ivy.home"  value ="${env.IVY_HOME}" >
       < isset  property ="env.IVY_HOME"   />
     </ condition >
     < property  name ="ivy.home"  value ="${user.home}/.ant"   />
     < property  name ="ivy.jar.dir"  value ="${ivy.home}/lib"   />
     < property  name ="ivy.jar.file"  value ="${ivy.jar.dir}/ivy.jar"   />

     < target  name ="download-ivy"  unless ="offline" >

         < mkdir  dir ="${ivy.jar.dir}" />
         <!--  download Ivy from web site so that it can be used even without any special installation  -->
         < get  src ="http://www.apache.org/dist/ant/ivy/${ivy.install.version}/ivy.jar"
            dest ="${ivy.jar.file}"  usetimestamp ="true" />
     </ target >

     < target  name ="init-ivy"  depends ="download-ivy" >
       <!--  try to load ivy here from ivy home, in case the user has not already dropped
              it into ant's lib dir (note that the latter copy will always take precedence).
              We will not fail as long as local lib dir exists (it may be empty) and
              ivy is in at least one of ant's lib dir or the local lib dir.  -->
         < path  id ="ivy.lib.path" >
             < fileset  dir ="${ivy.jar.dir}"  includes ="*.jar" />

         </ path >
         < taskdef  resource ="org/apache/ivy/ant/antlib.xml"
                 uri ="antlib:org.apache.ivy.ant"  classpathref ="ivy.lib.path" />
     </ target >

    然后需要做的仅仅是在你的使用ivy的目标里面增加目标init-ivy的依赖，并增加ivy命名空间到你的构建脚本。关于这个的更多细节请看自包含的示例go-ivy .