Sky's blog

我和我追逐的梦

常用链接

统计

其他链接

友情链接

最新评论

ivy中文参考文档(10)-ivy文件

    1) ivy文件

    ivy的使用完全是基于以"ivy文件"著称的模块描述符。ivy文件是xml文件,通常被称为ivy.xml,包含模块依赖的描述,它发布的制品和它的配置。

    这里有一个最简单的ivy文件:

<ivy-module version="2.0">
  
<info organisation="myorg"
        module
="mymodule"
        
/>
</ivy-module>

    如果你想知道一个使用几乎所有ivy文件可能设置的模块描述符的例子,看这里,带xslt不带xslt.

    在开始参考文档前,要求对在本参考文档的主页面中定义的术语有所了解。

    对于那些熟悉的xml schema,用来验证ivy文件的schema在这里可以找到。对于那些使用xsd的ide,你可以通过在你的ivy文件中声明这些xsd以便从代码自动完成和验证中获益。

<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0"
            xmlns:xsi
="http://www.w3.org/2001/XMLSchema-instance"
            xsi:noNamespaceSchemaLocation
=
                   "http://ant.apache.org/ivy/schemas/ivy.xsd"
>
  
<info organisation="myorg"
        module
="mymodule"
        
/>
</ivy-module>

    2)动态或固定的ivy文件

    模块描述符(ivy文件)在模块的每个修订版本发布前后都需要。根据这种情况,模块描述符可以使动态或者固定的:

    1. 用于模块开发的动态描述符

    在模块开发的时间中,在发布之间,描述符帮助管理模块的所有可能改变的依赖。处于这个目的,在开发时间ivy文件可以申明动态依赖来容许最大限度的使用灵活性。类似"latest.integration" 或 "1.0.+"的动态修订版本是可能的并可以在不同时间解析为不同的制品。变量可以用于更多的灵活性。开发时间ivy文件之所以被称为"动态",因为随着时间的推移他们能产生不同的结果。动态ivy文件一般被当成源文件处理并和他们保持在一起(在SCM控制下)。

    2. 用于发布的确定了的描述符

    每次发布时,需要另一种模块描述符来记录模块特定发布修订版本的依赖。处于这个目的,描述符通常需要确定它的依赖不再改变。为了做到这点,被发布的模块修订版本获取固定的明确被解析的依赖。不再容许任何变量。这样发布友好的静态的ivy文件被称为"resolved",因为他们通常产生同样的结果。确定的ivy文件和发布的制品同样对比并在仓库中一起保存。

    确定的ivy文件通过交付任务从他们原始动态的ivy文件中产生。

    注意虽然使用动态ivy来发布模块修订版本从技术上是可能的,但是这不是一个普遍推荐的做法。

    3) 分层索引

ivy-module

info

license

ivyauthor

repository

description

configurations

conf

publications

artifact

conf

dependencies

dependency

conf

mapped

artifact

conf

include

conf

exclude

conf

exclude

override

conflict

conflicts

manager


    4) ivy-module

    标签:ivy-module

    每个ivy文件的root标签(模块描述符).

属性

属性描述要求
version ivy文件规格的版本 - 当前版本应该是'2.0' 必须

子元素

元素描述基数
info  包含被描述的模块的信息
1
configurations  配置元素的容器
0..1
publications  发布制品元素的容器
0..1
dependencies  依赖元素的容器 0..1
conflicts  配置使用的冲突管理器的章节
0..1


posted on 2009-07-22 22:21 sky ao 阅读(1627) 评论(1)  编辑  收藏 所属分类: project building

评论

# re: ivy中文参考文档(10)-ivy文件 2009-07-24 13:06 施华洛世奇

8683  回复  更多评论   


只有注册用户登录后才能发表评论。


网站导航: