原创作者: Sky Ao   阅读:5740次   评论:0条   更新时间:2011-05-26    

1) ant任务

    使用ivy的主要和最频繁的方式是在ant构建文件中。不过,ivy也可以作为独立的应用被调用。

    如果你使用ant版本1.6.0 或更高,你仅仅需要添加ivy的命名空间到你的项目中(你的project标签的属性)

xmlns:ivy="antlib:org.apache.ivy.ant"


    这样你就可以调用ivy任务了。

    如果你想让你的构建处理ivy.jar,不管是在ant的lib目录还是在本地的lib目录。你可以类似这样使用任务定义

< path  id ="ivy.lib.path" >
    
< fileset  dir ="path/to/dir/with/ivy/jar"  includes ="*.jar" />
</ path >
< taskdef  resource ="org/apache/ivy/ant/antlib.xml"
         uri
="antlib:org.apache.ivy.ant"  classpathref ="ivy.lib.path" />


    结合项目命名空间中的antlib定义,它将从你的ant类库或者本地目录(在这个例子中试path/to/dir/with/ivy/jar)装载ivy类。

    如果你使用ant1.5.1或者更高,你不得不定义你在你的构建文件中使用的任务。例如:

< 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-deliver"  classname ="org.apache.ivy.ant.IvyDeliver" />
  
< taskdef  name ="ivy-publish"  classname ="org.apache.ivy.ant.IvyPublish" />


    注意:上面列出的任务并不是详尽。为了完整的有对应类的任务列表,请查看svn中的或者你使用的版本的antlib.xml

    然后你可以使用任务,但是检查他们的名字,下面的例子假设你使用ivy命名空间(ivy:xxx任务),不过对于ant1.5你不能使用命名空间,如果你想遵循上面的任务定义可以使用ivy-xxx任务。

    如果你使用低于1.5.1的ant版本,你不能使用ivy任务...你应该作为外部程序来调用ivy。

    2) 从ant中调用ivy: 开始步骤

    一旦你的构建文件可以调用ivy任务,最简单的使用ivy的任务就是不带任何参数的调用ivy的retrieve任务。

< ivy:retrieve  />


    这将使用默认值调用ivy,在很多项目中是可行的。实际上,它等同于

< target  name ="resolve" >
    
< ivy:configure  />
   
    
< ivy:resolve  file ="${ivy.dep.file}"  conf ="${ivy.configurations}"   />
   
    
< ivy:retrieve  pattern ="${ivy.retrieve.pattern}"  conf ="${ivy.configurations}"   />
</ target >


    这三个任务遵循ivy获取依赖过程的3个主要步骤:

    * 首先configure任务通过给出一个xml配置文件的路径来讲述怎样找到依赖。
    * 然后resolve任务实际解析ivy文件描述的依赖,并将这些依赖放置到ivy缓存(在配置文件中配置的一个目录)
    * 最后retrieve任务从缓存中复制依赖到任何你想要的文件系统中。随后你可以用这些依赖用标准ant路径来构造你的classpath。

    为了更准确的理解ivy任务的行为,需要要知道在configure被调用的开始ivy装载了一个属性文件。这个属性文件包含以下属性:

ivy.project.dir = ${basedir}
ivy.lib.dir = ${ivy.project.dir}/lib
ivy.build.artifacts.dir = ${ivy.project.dir}/build/artifacts
ivy.distrib.dir = ${ivy.project.dir}/distrib
   
ivy.resolver.default.check.modified = false
ivy.default.always.check.exact.revision = true

ivy.configurations = *
ivy.resolve.default.type.filter = *
ivy.status = integration
ivy.dep.file = ivy.xml
ivy.settings.file = ivysettings.xml
ivy.retrieve.pattern = ${ivy.lib.dir}/[artifact]-[revision].[ext]
ivy.deliver.ivy.pattern = ${ivy.distrib.dir}/[type]s/[artifact]-[revision].[ext]
ivy.publish.src.artifacts.pattern = ${ivy.distrib.dir}/[type]s/[artifact]-[revision].[ext]

ivy.report.output.pattern = [organisation]-[module]-[conf].[ext]

ivy.buildlist.ivyfilepath = ivy.xml

ivy.checksums=sha1,md5


    这些属性的最新版本你可以检查svn版本。

    2.0之后,在调用第一个ivy任务后,属性ivy.version将可用并包含被使用的ivy类库的版本。

    2) ivy任务属性: 概论
    任务属性的值可能通过不同位置提供。这三个可能的位置是:

   1. 任务属性
   2. 实例
   3. 项目属性

    位置被要求使用这种顺序,因此任务在任务属性中设置的值将覆盖在ivy实例中发现的值,例如。

    这里考虑的ivy实例是类Ivy的一个实例,通过调用configure任务建立,并且随后被其他任务重用。因为大部分任务需要ivy实例,他们首先检查是否有实例可用(例如 configure已经被调用),如果没有一个可用,则调用默认的configure,将得到的ivy实例结果用于后面的任务(除非另外一个configure被调用)。

    通常理解这些不是必须的,但是如果你忘记在其他任务前调用configure而在你的环境中configure步骤是必须的,这将导致一些问题。

    3) 主要任务的通常周期



    4) 示例

    这里有一个使用ivy的更加复杂的构建文件的例子:

< project  xmlns:ivy ="antlib:org.apache.ivy.ant"  name ="sample"  default ="resolve" >

    
< target  name ="resolve" >
        
< ivy:configure  file ="../ivysettings.xml"   />
        
        
< ivy:resolve  file ="my-ivy.xml"  conf ="default, myconf"   />
        
    
</ target >
    
    
< target  name ="retrieve-default"  depends ="resolve" >
        
< ivy:retrieve  pattern ="lib/default/[artifact]-[revision].[ext]"  conf ="default"   />
    
</ target >

    
< target  name ="retrieve-myconf"  depends ="resolve" >
        
< ivy:retrieve  pattern ="lib/myconf/[artifact]-[revision].[ext]"  conf ="myconf"   />
    
</ target >

    
< target  name ="retrieve-all"  depends ="resolve" >
        
< ivy:retrieve  pattern ="lib/[conf]/[artifact]-[revision].[ext]"  conf ="*"   />
    
</ target >

    
< target  name ="deliver"  depends ="retrieve-all" >
        
< ivy:deliver  deliverpattern ="distrib/[artifact]-[revision].[ext]"
                     pubrevision
="1.1b4"  pubdate ="20050115123254"  status ="milestone"   />
    
</ target >

    
< target  name ="publish"  depends ="deliver" >
        
< ivy:publish  resolver ="internal"  
                     artifactspattern
="distrib/[artifact]-[revision].[ext]"  
                     pubrevision
="1.1b4"   />
    
</ target >
</ project >


    所有的ivy任务在随后的页面中介绍。

 

 

 

评论 共 0 条 请登录后发表评论

发表评论

您还没有登录,请您登录后再发表评论

文章信息

  • skydream在2009-09-02创建
  • skydream在2011-05-26更新
  • 标签: ivy, 中文参考文档, ant任务
Global site tag (gtag.js) - Google Analytics