ivy中文參考文檔(15)-ant任務(3)-retrieve

1) retrieve

retrieve任務復制解析好的依賴到你的文件系統的任何位置。

這是一個post resolve任務，帶有所有post resolve任務共有的所有的行為和屬性。

從1.4起 這個任務甚至可以根據依賴解析的結果用實際應該存在的東西來同步目標目錄。這意味著如果設置sync為"true"，ivy不僅將 復制必要的文件，而且它還會刪除那些不再需要在那裡的文件。

同步實際上是刪除root目標目錄下不再是retrieve任務必須的所有文件和目錄。

root目標目錄是 在目標正則表達式中的標示為第一級別的第一個標記的目錄。

例如:

pattern: lib/[conf]/[artifact].[ext]

root: lib

2) 屬性

屬性 描述 必要 pattern the pattern to use to copy the dependencies

用來復制依賴的正則表達式 No. 默認為 ${ivy.retrieve.pattern} ivypattern the pattern to use to copy the ivy files of dependencies since 1.3

從1.3起用來復制依賴的ivy文件的正 則表達式 No. 默認不獲取依賴的ivy文件 conf a comma separated list of the configurations to retrieve

用於獲取的配置的列表，逗號分隔 No.默認為被最後一次resolve調用解析好的配置，或者在沒有顯示調用resoleve時的* sync true to synchronize the destination, false to just make a copy since 1.4

從1.4起 true 同步目錄路徑， false僅僅復制 No. 默認為 false type comma separated list of accepted artifact types since 1.4

從1.4起 可接受的制品類型列表，逗號分隔 No. 默認所有制品類型都被接受 symlink true to create symbolic links, false to copy the artifacts. The destination of the symbolic links depends on the value of the useOrigin attribute (since 2.0)

true 創建符號鏈接，false復制制品。符號鏈接的目的地取決於 useOrigin屬性的值(從2.0起) No. 默認為 false settingsRef A reference to the ivy settings that must be used by this task (since 2.0)

必須被這次任務使用的iry設 置的引用 No, 默認使用'ivy.instance' log the log setting to use during the resolve and retrieve process. (since 2.0)

Available options are the same as for resolve when used to trigger resolve automatically (see postresolvetask), or the following for the retrieve process only:

default

the default log settings, where all usual messages are output to the console

quiet

disable all usual messages, making the whole retrieve process quiet unless errors occur No, defaults to 'default'.

3) 示例

1.

<ivy:retrieve　/>

使用默認參數獲取依賴。這通常獲取最後一次解析調用的所有依賴到lib目錄中。

2.

<ivy:retrieve　pattern="${lib.dir}/[conf]/[artifact].[ext]"/>

獲取最後一次解析調用的所有依賴到lib目錄中，依賴將分隔在按照組織命名的目錄中，每個conf目錄包含對應的不帶修訂版本的制品 。

例如，如果ivy文件聲明了兩個配置default和test，結果lib目錄將會像這樣：

lib
　　 default
　　　　 commons-lang.jar
　　　　 commons-logging.jar
　　 test
　　　　 junit.jar

注意如果一個依賴被兩個配置要求，它將被復制到兩個目錄中。這個依賴的下載將只在resolve的時候進行一次。

3.

<ivy:retrieve　pattern="${lib.dir}/[conf]/[artifact].[ext]"　sync="true"　/>

和前面相同，但是開啟同步。

例如，如果ivy文件聲明了兩個配置default和test，結果lib目錄將會像這樣：

lib
　　 default
　　　　 commons-lang.jar
　　　　 commons-logging.jar
　　 test
　　　　 junit.jar

現在假設commons-logging 不再是默認配置的一部分，然後新的retrieve調用將會產生如下結果：

lib
　　 default
　　　　 commons-lang.jar
　　 test
　　　　 junit.jar

如果不開啟同步，commons-logging將不會被這次調用刪除。

4.

<ivy:retrieve　pattern="${lib.dir}/[type]/[artifact]-[revision].[ext]"　conf="runtime"/>

僅僅獲取配置runtime依賴到用制品類型命名的目錄中。結果lib目錄將類似這樣：

lib
　　 jar
　　　　 commons-lang-1.0.jar
　　　　 looks-1.1.jar
　　 source
　　　　 looks-1.1.zip

5.

<ivy:retrieve　organisation="foo"　module="bar"　inline="true"　pattern="${my.install.dir}/[artifact]. [ext]"/>