Sky's blog

ivy中文参考文档(11)-ant任务

    1) ant任务

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

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


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

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


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

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


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

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

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

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

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


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


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

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

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


    这些属性的最新版本你可以检查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的更加复杂的构建文件的例子：


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

posted on 2009-07-23 08:21 sky ao 阅读(2197) 评论(0)  编辑  收藏 所属分类: project building