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