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.+"的
2. 用于發布的確定了的描述符
每次發布時,需要另一種模塊描述符來記錄模塊特定發布修訂版本的依賴。處于這個目的,描述符通常需要確定它的依賴不再改變。為了做到這點,被發布的模塊修訂版本獲取固定的明確被解析的依賴。不再容許任何變量。這樣發布友好的靜態的ivy文件被稱為"resolved",因為他們通常產生同樣的結果。確定的ivy文件和發布的制品同樣對比并在倉庫中一起保存。
確定的ivy文件通過
交付任務從他們原始動態的ivy文件中產生。
注意雖然使用動態ivy來發布模塊修訂版本從技術上是可能的,但是這不是一個普遍推薦的做法。
3) 分層索引
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 |