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

核心提示：1) ivy文件ivy的使用完全是基于以"ivy文件"著称的模块描述符，ivy文件是xml文件，ivy中文参考文档(10)-ivy文件，通常被称为ivy.xml，包含模块依赖的描述，确定的ivy文件通过交付任务从他们原始动态的ivy文件中产生，注意虽然使用动态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