Posted on 2007-12-23 23:22
切爾斯基 閱讀(5938)
評論(0) 編輯 收藏
基本上, 搭建一個本地的ivy倉庫, 包含兩件獨立的事情: 搭建倉庫本身, 和配置如何使用這個倉庫
倉庫本身
Ivy的Repository是由一個個Module組成的, Module則包含自身的artifacts(通常是jar文件)和描述文件.
Module的描述文件是ivy的核心, 里面記錄了這個module包含哪些artifacts和這個module對其它module的依賴. 這樣就能順藤摸瓜,
牽出所有的依賴來
<ivy-module
version="1.0">
<info
organisation="your.company"
module="your.project"
/>
<configurations>
<conf
name="release"
/>
<conf
name="testing"
extends="release"
/>
</configurations>
<publications>
<artifact
name="common"
/>
<artifact
name="client"
/>
<artifact
name="server"
/>
</publications>
<dependencies
defaultconf="release->default">
<dependency
name="ant"
rev="1.7.0"
/>
<dependency
name="antlr"
rev="2.7.6"
/>
<dependency
name="xstream"
rev="1.2.2"
/>
</dependencies>
</ivy-module>
倉庫在文件系統上的結構, 可以由你自己決定, 只要在使用這個倉庫時, 把它的布局信息用配置文件描述出來告訴使用者就可以了
如何使用這個倉庫
基本上, 我們借助 Ant 來使用ivy, 那么我們需要告訴 Ant 一些repository相關的信息 : Where is the local repository,
and How it looks like
<property
name="ivy.local.default.root"
location="/your/local/ivy/repository/folder"
/>
<ivy:settings
id="ivy.instance"
file="${ivy.local.default.root}/ivy.repository.settings.xml"
/>
那個ivy.repository.settings.xml就是來描述repository的布局的:
<ivysettings>
<settings
defaultResolver="local"
/>
<resolvers>
<filesystem
name="local"
checkmodified="true">
<artifact
pattern="${ivy.local.default.root}/[module]/[artifact].jar"
/>
<artifact
pattern="${ivy.local.default.root}/[module]/[artifact]-[revision].jar"
/>
<ivy
pattern="${ivy.local.default.root}/[module]/[module]-dependencies.xml"
/>
</filesystem>
</resolvers>
</ivysettings>
然后你告訴 Ant 你的項目的依賴和artifacts, Ant就可以幫你獲得依賴和發布artifacts了
<property
name="ivy.dep.file"
location="${basedir}/my-module-dependencies.xml"
/>
<ivy:retrieve
/>
<!--
retrieve dependencies first, then
compile, package, ... then publish-->
<ivy:publish
resolver="local"
pubrevision="1.0"
overwrite="true"
forcedeliver="true">
<artifacts
pattern="${build.dir}/dist/[artifact].[ext]"
/>
<artifacts
pattern="${basedir}/my-module-dependencies.xml"
/>
</ivy:publish>
那個my-module-dependencies.xml就是你的項目的依賴描述符,
事實上ivy也將它看作一個module,和repository里的module一視同仁. 參考最開始的例子.
Ivy 如何解決我們的問題
Q: 我的項目在開發環境和產品環境有不同的依賴, 怎么辦?
A: Ivy 提供了"configuration" 的概念. 在那個my-module-dependencies.xml中,
你可以為你的module定義development和product兩種配置, 可以指定每個artifact隸屬于哪個配置, 指定每個dependency屬于哪個配置.
注意這是一個遞歸定義, 因為你依賴的module也有可能定義了多個配置, 你需要指定你依賴于依賴的哪個配置,所以這是一個映射. 比如你的產品在運行環境中依賴于spring的產品環境:
<ivy-module
version="1.0">
<info
organisation="your.company"
module="your.project"
/>
<configurations>
<conf
name="product"
/>
<conf
name="development"
/>
</configurations>
<dependencies
defaultconf="product->default">
<dependency
name="spring"
rev="1.7.0"
conf="release->product"
/>
<dependency
name="antlr"
rev="2.7.6"
conf="development->debug"
/>
<dependency
name="junit"
rev="4.4"
conf="development->release"
/>
</dependencies>
</ivy-module>
ivy 的各個Ant task允許你指定在哪個 configuration 上操作;
如為product配置取得所有依賴:
<ivy:retrieve
conf="product"
/>
Q: 我的項目在開發環境和產品環境有太多相同的依賴, 事實上開發環境包含產品環境所有的依賴, 額外再加上junit,jmock等; 如何消除重復的依賴描述呢?
A: Ivy 提供了配置之間 "extends" , 也就是"繼承"的概念, 你可以讓開發環境的配置繼承自產品環境的配置, 這樣就可以復用產品環境的配置
<configurations>
<conf
name="product"
/>
<conf
name="development"
extends="product"
/>
</configurations>
Q: 缺省ivy總是從緩存中讀取配置, 這樣我的依賴配置更新后卻得不到反映; 怎么禁止從cache中讀取配置?
A: <filesystem
name="local"
checkmodified="true">