You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by hi...@apache.org on 2010/12/13 19:32:02 UTC
svn commit: r1045278 [2/32] - in /ant/ivy/site/target/history/2.2.0-rc1: ./
configuration/ configuration/caches/ configuration/macrodef/
configuration/namespace/ dev/ ivyfile/ js/ resolver/ samples/ settings/
settings/caches/ settings/macrodef/ setting...
Modified: ant/ivy/site/target/history/2.2.0-rc1/book.html
URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0-rc1/book.html?rev=1045278&r1=1045277&r2=1045278&view=diff
==============================================================================
--- ant/ivy/site/target/history/2.2.0-rc1/book.html (original)
+++ ant/ivy/site/target/history/2.2.0-rc1/book.html Mon Dec 13 18:31:56 2010
@@ -24,7 +24,7 @@
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
-<title>Documentation (2.2.0-rc1) | Ivy @version@</title>
+<title>Documentation (2.2.0-rc1) | Apache Ivy™ @version@</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="style/print-style.css" />
@@ -127,104 +127,11 @@ The corresponding build file contains a
As you can see, it's very easy to call Ivy to resolve and retrieve dependencies: all you need if Ivy is properly <a href="install.html">installed</a> is to define an XML namespace in your Ant file (xmlns:ivy="antlib:org.apache.ivy.ant"). Then all the <a href="ant.html">Ivy ant tasks</a> will be available in this namespace.<br class="xooki-br"/><br class="xooki-br"/>Here we use only one task: the <a href="use/retrieve.html">retrieve</a> task. With no attributes, it will use default settings and look for a file named ivy.xml for dependency definition. That's exactly what we want, so we need nothing more than that.<br class="xooki-br"/><br class="xooki-br"/>Note that in this case we define a "resolve" target and call the <a href="use/retrieve.html">retrieve</a> task. This may sound confusing, actually the retrieve task performs a <a href="use/resolve.html">resolve</a> (which resolves dependencies and downloads them to a cache) followed by a retrieve (a copy of those file in a l
ocal project directory). Check the <a href="principle.html">How does it work ?</a> page for details about that.<br class="xooki-br"/><h1>Running the project</h1>
Ok, now that we have seen the files involved, let's run the sample to see what happens. Open a shell (or command line) window, and enter the hello-ivy example directory.<br class="xooki-br"/>Then, at the command prompt, run 'ant':
<div class="shell"><pre>
-[ivy@apache:/ivy/hello-ivy]$ ant
-Buildfile: /ivy/hello-ivy/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: url = jar:file:///home/ivy/ivy.jar!/org/apache/ivy/core/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#hello-ivy;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in public
-[ivy:retrieve] found commons-cli#commons-cli;1.0 in public
-[ivy:retrieve] found commons-logging#commons-logging;1.0 in public
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0-javadoc.jar ...
-[ivy:retrieve] .......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:retrieve] ................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ (467kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar(javadoc) (4056ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0-sources.jar ...
-[ivy:retrieve] ............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ (245kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar(source) (2621ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0.jar ...
-[ivy:retrieve] ........................................................................................................................................................................................................................................................................................................................................... (165kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar (1809ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-cli/commons-cli/1.0/commons-cli-1.0.jar ...
-[ivy:retrieve] ........................................................ (29kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-cli#commons-cli;1.0!commons-cli.jar (1638ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-cli/commons-cli/1.0/commons-cli-1.0-javadoc.jar ...
-[ivy:retrieve] ............................................................................................................................................................................................. (92kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-cli#commons-cli;1.0!commons-cli.jar(javadoc) (2403ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-cli/commons-cli/1.0/commons-cli-1.0-sources.jar ...
-[ivy:retrieve] ...................................................................................................... (48kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-cli#commons-cli;1.0!commons-cli.jar(source) (2106ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-logging/commons-logging/1.0/commons-logging-1.0.jar ...
-[ivy:retrieve] ........................................... (21kB)
-[ivy:retrieve] ... (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-logging#commons-logging;1.0!commons-logging.jar (1825ms)
-[ivy:retrieve] :: resolution report :: resolve 9314ms :: artifacts dl 16520ms
-[ivy:retrieve] :: evicted modules:
-[ivy:retrieve] commons-lang#commons-lang;1.0 by [commons-lang#commons-lang;2.0] in [default]
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 4 | 3 | 3 | 1 || 7 | 7 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#hello-ivy
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 7 artifacts copied, 0 already retrieved (1069kB/62ms)
-
-run:
- [mkdir] Created dir: /ivy/hello-ivy/build
- [javac] /ivy/hello-ivy/build.xml:53: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/hello-ivy/build
- [java] standard message : hello ivy !
- [java] capitalized by org.apache.commons.lang.WordUtils : Hello Ivy !
-
-BUILD SUCCESSFUL
-Total time: 28 seconds
</pre></div>
<h1>What happened ?</h1>
Without any settings, Ivy retrieves files from the maven 2 repository. That's what happened here. <br class="xooki-br"/>The resolve task has found the commons-lang and commons-cli modules in the maven 2 repository, identified that commons-cli depends on commons-logging and so resolved it as a transitive dependency. Then Ivy has downloaded all corresponding artifacts in its cache (by default in your user home, in a .ivy2/cache directory). Finally, the retrieve task copies the resolved jars from the ivy cache to the default library directory of the project: the lib dir (you can change this easily by setting the pattern attribute on the <a href="use/retrieve.html">retrieve</a> task).<br class="xooki-br"/><br class="xooki-br"/>You might say that the task took a long time just to write out a "Hello Ivy !" message. But remember that a lot of time was spent downloading the required files from the web. Let's try to run it again:
<div class="shell"><pre>
-[ivy@apache:/ivy/hello-ivy]$ ant
-Buildfile: /ivy/hello-ivy/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: url = jar:file:///home/ivy/ivy.jar!/org/apache/ivy/core/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#hello-ivy;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in public
-[ivy:retrieve] found commons-cli#commons-cli;1.0 in public
-[ivy:retrieve] found commons-logging#commons-logging;1.0 in public
-[ivy:retrieve] :: resolution report :: resolve 203ms :: artifacts dl 16ms
-[ivy:retrieve] :: evicted modules:
-[ivy:retrieve] commons-lang#commons-lang;1.0 by [commons-lang#commons-lang;2.0] in [default]
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 4 | 0 | 0 | 1 || 7 | 0 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#hello-ivy
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 0 artifacts copied, 7 already retrieved (0kB/0ms)
-
-run:
- [javac] /ivy/hello-ivy/build.xml:53: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [java] standard message : hello ivy !
- [java] capitalized by org.apache.commons.lang.WordUtils : Hello Ivy !
-
-BUILD SUCCESSFUL
-Total time: 1 second
</pre></div>
Great! the cache was used, no download was needed and the build was instantaneous.<br class="xooki-br"/><br class="xooki-br"/>And now, if you want to generate a report detailing all the dependencies of your module, you can call the report target, and check the generated file in the build directory. You should obtain something looking like <a href="../samples/apache-hello-ivy-default.html">this</a>.<br class="xooki-br"/><br class="xooki-br"/>As you can see, using Ivy to resolve dependencies stored in the maven 2 repository is extremely easy. Now you can go on with the next tutorials to learn more about <a href="tutorial/conf.html">how to use module configurations</a> which is a very powerful Ivy specific feature. Other tutorials are also available where you will learn how to use Ivy settings to leverage a possibly complex enterprise repository. It may also be a good time to start reading the <a href="reference.html">reference documentation</a>, and especially the introduction
material which gives a good overview of Ivy. The <a href="bestpractices.html">best practices</a> page is also a must read to start thinking about how to use Ant+Ivy to build a clean and robust build system.<hr/><div class='toc-title toc-title-3'>Adjusting default settings</div><br class="xooki-br"/>Ivy comes bundled with some default settings which makes it pretty simple to use in common environment. This tutorial, which is close to a reference documentation, explains what are those default settings and how they can be adjusted to your needs. <br class="xooki-br"/><br class="xooki-br"/>To fully understand the concept of settings and what you can do with them, we suggest reading other tutorial related to settings (like <a href="tutorial/multiple.html">Multiple Resolvers</a> and <a href="tutorial/dual.html">Dual Resolver</a>) or the <a href="settings.html">Settings Files</a> reference documentation.<br class="xooki-br"/><br class="xooki-br"/><h1>Concept</h1>
@@ -349,45 +256,6 @@ In almost all examples, we provide a cle
<h2>step 3: run the project</h2>
Go to chainedresolvers-project directory. And simply run <b>ant</b>.<br class="xooki-br"/>
<div class="shell"><pre>
-[ivy@apache:/ivy/chained-resolvers/chainedresolvers-project]$ ant
-Buildfile: /ivy/chained-resolvers/chainedresolvers-project/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/chained-resolvers/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#chained-resolvers;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in ibiblio
-[ivy:retrieve] found org.apache#test;1.0 in libraries
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0.jar ...
-[ivy:retrieve] .......................................................................................................................................................................................................................................................................................................................
-[ivy:retrieve] ............. (165kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar (3495ms)
-[ivy:retrieve] downloading /ivy/chained-resolvers/settings/repository/test-1.0.jar ...
-[ivy:retrieve] .. (1kB)
-[ivy:retrieve] [SUCCESSFUL ] org.apache#test;1.0!test.jar (15ms)
-[ivy:retrieve] :: resolution report :: resolve 4181ms :: artifacts dl 3510ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 2 | 2 | 1 | 0 || 2 | 2 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#chained-resolvers
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 2 artifacts copied, 0 already retrieved (166kB/31ms)
-
-run:
- [mkdir] Created dir: /ivy/chained-resolvers/chainedresolvers-project/build
- [javac] /ivy/chained-resolvers/chainedresolvers-project/build.xml:58: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/chained-resolvers/chainedresolvers-project/build
- [java] standard message :example world !
- [java] capitalized by org.apache.commons.lang.WordUtils : Example World !
- [java] upperCased by test.StringUtils : EXAMPLE WORLD !
-
-BUILD SUCCESSFUL
-Total time: 11 seconds
</pre></div></div>
@@ -440,52 +308,6 @@ This will clean up the entire project di
<h2>step 3 : run the project</h2>
Goto project directory. And simply run <b>ant</b>.
<div class="shell"><pre>
-[ivy@apache:/ivy/dual/project]$ ant
-Buildfile: /ivy/dual/project/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/dual/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#hello-ivy;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-httpclient#commons-httpclient;2.0.2 in ivys
-[ivy:retrieve] found commons-logging#commons-logging;1.0.4 in ibiblio
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in ibiblio
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-httpclient/commons-httpclient/2.0.2/commons-httpclient-2.0.2.jar ...
-[ivy:retrieve] ......................................................................................................................................................................................................................................................................................................................................................................................................................................................... (220kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-httpclient#commons-httpclient;2.0.2!commons-httpclient.jar (3557ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0.jar ...
-[ivy:retrieve] ................................................................................................................................................................................................................................................................................................................................................. (165kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar (2418ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-logging/commons-logging/1.0.4/commons-logging-1.0.4.jar ...
-[ivy:retrieve] ......................................................................... (37kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-logging#commons-logging;1.0.4!commons-logging.jar (1794ms)
-[ivy:retrieve] :: resolution report :: resolve 889ms :: artifacts dl 7769ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 3 | 3 | 1 | 0 || 3 | 3 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#hello-ivy
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 3 artifacts copied, 0 already retrieved (423kB/47ms)
-
-run:
- [mkdir] Created dir: /ivy/dual/project/build
- [javac] /ivy/dual/project/build.xml:58: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/dual/project/build
- [java] standard message : hello ivy !
- [java] capitalized by org.apache.commons.lang.WordUtils : Hello Ivy !
- [java] head status code with httpclient: 200
- [java] now check if httpclient dependency on commons-logging has been realized
- [java] found logging class in classpath: interface org.apache.commons.logging.Log
-
-BUILD SUCCESSFUL
-Total time: 11 seconds
</pre></div></div>
<br/>
@@ -556,50 +378,6 @@ On the prompt type: ant<br class="xooki-
<h2>step 3: publication of dependee project</h2>
Go to dependee directory and publish the project
<div class="shell"><pre>
-[ivy@apache:/ivy/dependence/dependee]$ ant publish
-Buildfile: /ivy/dependence/dependee/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/dependence/settings/ivysettings.xml
-[ivy:retrieve] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/dependence/settings/ivysettings.xml)
-[ivy:retrieve] :: resolving dependencies :: org.apache#dependee;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in libraries
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/2.0/commons-lang-2.0.jar ...
-[ivy:retrieve] ........................................................................................................................................................................................................................................................................................................................................... (165kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-lang#commons-lang;2.0!commons-lang.jar (2465ms)
-[ivy:retrieve] :: resolution report :: resolve 452ms :: artifacts dl 2465ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 1 | 1 | 0 | 0 || 1 | 1 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#dependee
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 1 artifacts copied, 0 already retrieved (165kB/15ms)
-
-compile:
- [mkdir] Created dir: /ivy/dependence/dependee/build/classes
- [javac] /ivy/dependence/dependee/build.xml:60: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/dependence/dependee/build/classes
-
-jar:
-[propertyfile] Creating new property file: /ivy/dependence/dependee/build/classes/version.properties
- [jar] Building jar: /ivy/dependence/dependee/build/dependee.jar
-
-publish:
-[ivy:publish] :: delivering :: org.apache#dependee;working@apache :: 1 :: release :: Tue Jun 29 22:58:14 CEST 2010
-[ivy:publish] delivering ivy file to /ivy/dependence/dependee/build/ivy.xml
-[ivy:publish] :: publishing :: org.apache#dependee
-[ivy:publish] published dependee to /ivy/dependence/settings/repository/dependee-1.jar
-[ivy:publish] published ivy to /ivy/dependence/settings/repository/dependee-1.xml
- [echo] project dependee released with version 1
-
-BUILD SUCCESSFUL
-Total time: 5 seconds
</pre></div>
What we see here:
@@ -621,48 +399,6 @@ Both are mere copy of files found in the
<h2>step 4: running the depender project</h2>
Go to directory depender and run ant
<div class="shell"><pre>
-[ivy@apache:/ivy/dependence/depender]$ ant
-Buildfile: /ivy/dependence/depender/build.xml
-
-clean:
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/dependence/settings/ivysettings.xml
-[ivy:retrieve] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/dependence/settings/ivysettings.xml)
-[ivy:retrieve] :: resolving dependencies :: org.apache#depender;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found org.apache#dependee;1 in projects
-[ivy:retrieve] [1] org.apache#dependee;latest.integration
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in libraries
-[ivy:retrieve] downloading /ivy/dependence/settings/repository/dependee-1.jar ...
-[ivy:retrieve] .. (1kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] org.apache#dependee;1!dependee.jar (16ms)
-[ivy:retrieve] :: resolution report :: resolve 343ms :: artifacts dl 16ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 2 | 1 | 1 | 0 || 2 | 1 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#depender
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 2 artifacts copied, 0 already retrieved (167kB/15ms)
-
-compile:
- [mkdir] Created dir: /ivy/dependence/depender/build/classes
- [javac] /ivy/dependence/depender/build.xml:71: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/dependence/depender/build/classes
-
-run:
- [java] you are using version 1 of class standalone.Main
- [java] standard message : i am depending.Main and standalone.Main will do the job for me
- [java] [standalone.Main] capitalizing string "i am depending.Main and standalone.Main will do the job for me" using org.apache.commons.lang.WordUtils
- [java] capitalized message : I Am Depending.main And Standalone.main Will Do The Job For Me
-
-BUILD SUCCESSFUL
-Total time: 2 seconds
</pre></div>
What we see here:
@@ -677,45 +413,6 @@ What we see here:
<h2>step 5: new version of dependee project</h2>
Like we did before in step 3, publish again the dependee project. This will result as a new version of the project.
<div class="shell"><pre>
-[ivy@apache:/ivy/dependence/dependee]$ ant publish
-Buildfile: /ivy/dependence/dependee/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/dependence/settings/ivysettings.xml
-[ivy:retrieve] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/dependence/settings/ivysettings.xml)
-[ivy:retrieve] :: resolving dependencies :: org.apache#dependee;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in libraries
-[ivy:retrieve] :: resolution report :: resolve 156ms :: artifacts dl 16ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 1 | 0 | 0 | 0 || 1 | 0 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#dependee
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 0 artifacts copied, 1 already retrieved (0kB/16ms)
-
-compile:
- [javac] /ivy/dependence/dependee/build.xml:60: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
-
-jar:
-[propertyfile] Updating property file: /ivy/dependence/dependee/build/classes/version.properties
- [jar] Building jar: /ivy/dependence/dependee/build/dependee.jar
-
-publish:
- [delete] Deleting: /ivy/dependence/dependee/build/ivy.xml
-[ivy:publish] :: delivering :: org.apache#dependee;working@apache :: 2 :: release :: Tue Jun 29 22:58:20 CEST 2010
-[ivy:publish] delivering ivy file to /ivy/dependence/dependee/build/ivy.xml
-[ivy:publish] :: publishing :: org.apache#dependee
-[ivy:publish] published dependee to /ivy/dependence/settings/repository/dependee-2.jar
-[ivy:publish] published ivy to /ivy/dependence/settings/repository/dependee-2.xml
- [echo] project dependee released with version 2
-
-BUILD SUCCESSFUL
-Total time: 1 second
</pre></div>
Now if you look in your repository folder, you will find 2 version published of the dependee project.<br class="xooki-br"/>Let's look at it:
@@ -731,44 +428,6 @@ What do we expect about running again th
</ul>
Let's go!!!
<div class="shell"><pre>
-[ivy@apache:/ivy/dependence/depender]$ ant
-Buildfile: /ivy/dependence/depender/build.xml
-
-clean:
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: file = /ivy/dependence/settings/ivysettings.xml
-[ivy:retrieve] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/dependence/settings/ivysettings.xml)
-[ivy:retrieve] :: resolving dependencies :: org.apache#depender;working@apache
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] found org.apache#dependee;1 in projects
-[ivy:retrieve] [1] org.apache#dependee;latest.integration
-[ivy:retrieve] found commons-lang#commons-lang;2.0 in libraries
-[ivy:retrieve] :: resolution report :: resolve 94ms :: artifacts dl 16ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 2 | 0 | 0 | 0 || 2 | 0 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#depender
-[ivy:retrieve] confs: [default]
-[ivy:retrieve] 2 artifacts copied, 0 already retrieved (167kB/15ms)
-
-compile:
- [mkdir] Created dir: /ivy/dependence/depender/build/classes
- [javac] /ivy/dependence/depender/build.xml:71: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/dependence/depender/build/classes
-
-run:
- [java] you are using version 1 of class standalone.Main
- [java] standard message : i am depending.Main and standalone.Main will do the job for me
- [java] [standalone.Main] capitalizing string "i am depending.Main and standalone.Main will do the job for me" using org.apache.commons.lang.WordUtils
- [java] capitalized message : I Am Depending.main And Standalone.main Will Do The Job For Me
-
-BUILD SUCCESSFUL
-Total time: 2 seconds
</pre></div>
Ok we have the result expected as the run target shows that we are using the version 2 of the main class of dependee project. If we take a look at the resolve target results, we can see that one artifact has been downloaded to the ivy cache. In fact this file is the version 2 of the dependee project that was taken from the repository, you can now retrieve it in the ivy-cache directory.
@@ -847,36 +506,11 @@ This target is used when you don't want
Generates both an html report and a graphml report.<br class="xooki-br"/><br class="xooki-br"/>For example, to generate a graph like the one shown at the beginning of this tutorial, you just have to follow the instructions given <a href="yed.html">here</a> with the graphml file you will find in <pre>projects/console/build/</pre> after having called report in the console project, and that's it, you have a clear overview of all your app dependencies !<br class="xooki-br"/><br class="xooki-br"/><h1>Playing with the projects</h1>
To play with this tutorial you can use regular ant commands. Begin in the base directory of the tutorial (src/example/multi-project), and run ant -p:
<div class="shell"><pre>
-[ivy@apache:/ivy/multi-project]$ ant -p
-Buildfile: /ivy/multi-project/build.xml
-
-Main targets:
-
- clean clean tutorial: delete repository, ivy cache, and all projects
- clean-all clean all projects
- publish-all compile, jar and publish all projects in the right order
</pre></div>
This gives you an idea of what you can do here. To make sure you have at least one version of all your modules published in your repository (required to build modules having dependencies on the others), you can run ant publish-all (example log <a href="log/multi-project-general-publishall.txt">here</a>).<br class="xooki-br"/><br class="xooki-br"/>You will see that Ivy calls the publish target on all the modules, following the order of the dependencies, so that a dependee is always built and published before its depender. Feel free to make changes in the source code of a module (changing a method name for instance) and in the module using the method, then call publish-all to see how the change in the dependee is compiled first, published, and then available to the depender which can compile successfully.<br class="xooki-br"/><br class="xooki-br"/>Then you can go in one of the example project directory (like projects/find for instance), and run ant -p:
<div class="shell"><pre>
-[ivy@apache:/ivy/multi-project/projects/find]$ ant -p
-Buildfile: /ivy/multi-project/projects/find/build.xml
-
-Main targets:
-
- clean --> clean the project
- clean-build --> clean the project built files
- clean-lib --> clean the project libraries directory (dependencies)
- clean-local --> cleans the local repository for the current module
- compile --> compile the project
- jar --> make a jar file for this project
- publish --> publish this project in the ivy repository
- publish-local --> publish this project in the local ivy repository
- report --> generates a report of dependencies
- resolve --> resolve and retrieve dependencies with ivy
- run --> compile and run the project
-Default target: compile
</pre></div>
@@ -893,76 +527,6 @@ The first project we defined in this tut
As you can see we defined 3 public configurations and a private one (defined junit dependency for testing).<br class="xooki-br"/>The 2 implementations conf <b>homemade-impl</b>, <b>cc-impl</b> extends <b>api</b> configuration so artifacts defined in api will also be required in its extending conf.<br class="xooki-br"/>In the publications tag we defined the artifacts we produce (here it's jars) and we affect them a configuration.<br class="xooki-br"/>Later when others will use our library they will have a very flexible way to define what they need.<br class="xooki-br"/><br class="xooki-br"/><h2>See it in action</h2>
The library project is build using ant. Open a shell in the root directory of the project and type <b>ant</b>.
<div class="shell"><pre>
-[ivy@apache:/ivy/configurations/multi-projects/filter-framework]$ ant
-Buildfile: /ivy/configurations/multi-projects/filter-framework/build.xml
-
-clean:
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: url = jar:file:///home/ivy/ivy.jar!/org/apache/ivy/core/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#filter-framework;working@apache
-[ivy:retrieve] confs: [api, homemade-impl, cc-impl, test]
-[ivy:retrieve] found commons-collections#commons-collections;3.1 in public
-[ivy:retrieve] found junit#junit;3.8 in public
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/commons-collections/commons-collections/3.1/commons-collections-3.1.jar ...
-[ivy:retrieve] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:retrieve] ......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... (546kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] commons-collections#commons-collections;3.1!commons-collections.jar (4992ms)
-[ivy:retrieve] downloading http://repo1.maven.org/maven2/junit/junit/3.8/junit-3.8.jar ...
-[ivy:retrieve] ............................................................................................................................................................................................................................................ (118kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] junit#junit;3.8!junit.jar (2465ms)
-[ivy:retrieve] :: resolution report :: resolve 7473ms :: artifacts dl 7457ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | api | 0 | 0 | 0 | 0 || 0 | 0 |
- | homemade-impl | 0 | 0 | 0 | 0 || 0 | 0 |
- | cc-impl | 1 | 1 | 1 | 0 || 1 | 1 |
- | test | 2 | 2 | 2 | 0 || 2 | 2 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#filter-framework
-[ivy:retrieve] confs: [api, homemade-impl, cc-impl, test]
-[ivy:retrieve] 3 artifacts copied, 0 already retrieved (1211kB/62ms)
-
-build:
- [mkdir] Created dir: /ivy/configurations/multi-projects/filter-framework/build
- [mkdir] Created dir: /ivy/configurations/multi-projects/filter-framework/distrib
- [javac] /ivy/configurations/multi-projects/filter-framework/build.xml:57: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 4 source files to /ivy/configurations/multi-projects/filter-framework/build
- [javac] Note: Some input files use unchecked or unsafe operations.
- [javac] Note: Recompile with -Xlint:unchecked for details.
- [jar] Building jar: /ivy/configurations/multi-projects/filter-framework/distrib/filter-api.jar
- [jar] Building jar: /ivy/configurations/multi-projects/filter-framework/distrib/filter-hmimpl.jar
- [jar] Building jar: /ivy/configurations/multi-projects/filter-framework/distrib/filter-ccimpl.jar
-
-test:
- [mkdir] Created dir: /ivy/configurations/multi-projects/filter-framework/build/test-report
- [mkdir] Created dir: /ivy/configurations/multi-projects/filter-framework/build/test-classes
- [javac] /ivy/configurations/multi-projects/filter-framework/build.xml:82: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 3 source files to /ivy/configurations/multi-projects/filter-framework/build/test-classes
- [junit] Running filter.ccimpl.CCFilterTest
- [junit] Tests run: 5, Failures: 0, Errors: 0, Time elapsed: 0,109 sec
- [junit] Running filter.hmimpl.HMFilterTest
- [junit] Tests run: 5, Failures: 0, Errors: 0, Time elapsed: 0,062 sec
-
-publish:
-[ivy:publish] :: delivering :: org.apache#filter-framework;working@apache :: 1.3 :: release :: Tue Jun 29 22:58:46 CEST 2010
-[ivy:publish] delivering ivy file to /ivy/configurations/multi-projects/filter-framework/distrib/ivy.xml
-[ivy:publish] :: publishing :: org.apache#filter-framework
-[ivy:publish] published filter-api to /home/ivy/.ivy2/local/org.apache/filter-framework/1.3.part/jars/filter-api.jar
-[ivy:publish] published filter-hmimpl to /home/ivy/.ivy2/local/org.apache/filter-framework/1.3.part/jars/filter-hmimpl.jar
-[ivy:publish] published filter-ccimpl to /home/ivy/.ivy2/local/org.apache/filter-framework/1.3.part/jars/filter-ccimpl.jar
-[ivy:publish] published ivy to /home/ivy/.ivy2/local/org.apache/filter-framework/1.3.part/ivys/ivy.xml
-[ivy:publish] publish commited: moved /home/ivy/.ivy2/local/org.apache/filter-framework/1.3.part
-[ivy:publish] to /home/ivy/.ivy2/local/org.apache/filter-framework/1.3
- [echo] project filter-framework released with version 1.3
-
-BUILD SUCCESSFUL
-Total time: 21 seconds
</pre></div>
The ant's default target is publish. <br class="xooki-br"/>This target uses ivy to publish our library binaries in a local repository. <br class="xooki-br"/>As we do not specify any repository path the default one is used. ({home.dir}/.ivy2/local/org.apache/filter-framework/)<br class="xooki-br"/>Now we are ready to use our library.<br class="xooki-br"/><br class="xooki-br"/><h1>The application project</h1>
@@ -992,90 +556,10 @@ When we call this target, Ivy will do a
As you can see for each configuration we have now a set of jars.<br class="xooki-br"/><br class="xooki-br"/>Let's try to launch our app.<br class="xooki-br"/><br class="xooki-br"/><h2>See it in action</h2>
Use ant to run the application.<br class="xooki-br"/>Default ant target is run-cc and will launch application using the Apache commons-collections implementation.
<div class="shell"><pre>
-[ivy@apache:/ivy/configurations/multi-projects/myapp]$ ant
-Buildfile: /ivy/configurations/multi-projects/myapp/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: url = jar:file:///home/ivy/ivy.jar!/org/apache/ivy/core/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#myapp;working@apache
-[ivy:retrieve] confs: [build, noexternaljar, withexternaljar]
-[ivy:retrieve] found org.apache#filter-framework;1.3 in local
-[ivy:retrieve] [1.3] org.apache#filter-framework;latest.integration
-[ivy:retrieve] found commons-collections#commons-collections;3.1 in public
-[ivy:retrieve] downloading /home/ivy/.ivy2/local/org.apache/filter-framework/1.3/jars/filter-api.jar ...
-[ivy:retrieve] .. (1kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] org.apache#filter-framework;1.3!filter-api.jar (31ms)
-[ivy:retrieve] downloading /home/ivy/.ivy2/local/org.apache/filter-framework/1.3/jars/filter-ccimpl.jar ...
-[ivy:retrieve] .. (1kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] org.apache#filter-framework;1.3!filter-ccimpl.jar (32ms)
-[ivy:retrieve] downloading /home/ivy/.ivy2/local/org.apache/filter-framework/1.3/jars/filter-hmimpl.jar ...
-[ivy:retrieve] .. (1kB)
-[ivy:retrieve] .. (0kB)
-[ivy:retrieve] [SUCCESSFUL ] org.apache#filter-framework;1.3!filter-hmimpl.jar (31ms)
-[ivy:retrieve] :: resolution report :: resolve 406ms :: artifacts dl 124ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | build | 1 | 1 | 1 | 0 || 1 | 1 |
- | noexternaljar | 1 | 1 | 1 | 0 || 2 | 2 |
- | withexternaljar | 2 | 1 | 1 | 0 || 3 | 2 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#myapp
-[ivy:retrieve] confs: [build, noexternaljar, withexternaljar]
-[ivy:retrieve] 6 artifacts copied, 0 already retrieved (552kB/110ms)
-
-build:
- [mkdir] Created dir: /ivy/configurations/multi-projects/myapp/build
- [javac] /ivy/configurations/multi-projects/myapp/build.xml:56: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
- [javac] Compiling 1 source file to /ivy/configurations/multi-projects/myapp/build
-
-run-cc:
- [java] Filtering with:class filter.ccimpl.CCFilter
- [java] Result :[two, tree]
-
-BUILD SUCCESSFUL
-Total time: 4 seconds
</pre></div>
Launching application with only home made jars is straightforward.<br class="xooki-br"/>type ant run-hm<br class="xooki-br"/>
<div class="shell"><pre>
-[ivy@apache:/ivy/configurations/multi-projects/myapp]$ ant run-hm
-Buildfile: /ivy/configurations/multi-projects/myapp/build.xml
-
-resolve:
-[ivy:retrieve] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:retrieve] :: loading settings :: url = jar:file:///home/ivy/ivy.jar!/org/apache/ivy/core/settings/ivysettings.xml
-[ivy:retrieve] :: resolving dependencies :: org.apache#myapp;working@apache
-[ivy:retrieve] confs: [build, noexternaljar, withexternaljar]
-[ivy:retrieve] found org.apache#filter-framework;1.3 in local
-[ivy:retrieve] [1.3] org.apache#filter-framework;latest.integration
-[ivy:retrieve] found commons-collections#commons-collections;3.1 in public
-[ivy:retrieve] :: resolution report :: resolve 359ms :: artifacts dl 16ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | build | 1 | 0 | 0 | 0 || 1 | 0 |
- | noexternaljar | 1 | 0 | 0 | 0 || 2 | 0 |
- | withexternaljar | 2 | 0 | 0 | 0 || 3 | 0 |
- ---------------------------------------------------------------------
-[ivy:retrieve] :: retrieving :: org.apache#myapp
-[ivy:retrieve] confs: [build, noexternaljar, withexternaljar]
-[ivy:retrieve] 0 artifacts copied, 6 already retrieved (0kB/47ms)
-
-build:
- [javac] /ivy/configurations/multi-projects/myapp/build.xml:56: warning: 'includeantruntime' was not set, defaulting to build.sysclasspath=last; set to false for repeatable builds
-
-run-hm:
- [java] Filtering with:class filter.hmimpl.HMFilter
- [java] Result :[two, tree]
-
-BUILD SUCCESSFUL
-Total time: 2 seconds
</pre></div>
Nice we got the same result but we can see that implementation classes are different.<br class="xooki-br"/><br class="xooki-br"/><h1>Conclusion</h1>
<b>You should use configurations as often as possible</b><br class="xooki-br"/>Configurations are very important concept in ivy. They allow you to group artifacts by meaning.<br class="xooki-br"/>When you write ivy file for projects that are supposed to be reused, use configurations to allow people to get only they what they need without having to specify it by hand using artifact tag in dependency section. <br class="xooki-br"/><hr/><div class='toc-title toc-title-3'>Building a repository</div><br class="xooki-br"/>The <a href="use/install.html">install</a> task let you copy a module or a set of modules from one repository to another one. This is very useful to build and maintain a enterprise or a team repository. If you don't want to give access to the public maven 2 repository to the developers in your team (to keep control over which modules are in use in your company or your team for instance), it can sometimes become tiresome to answer the developers request to add new
modules or new versions by hand.<br class="xooki-br"/><br class="xooki-br"/>Fortunately the <a href="use/install.html">install</a> task is here to help: you can use specific settings for your repository maintenance build which will be used to maintain your target enterprise repository. These settings will point to another repository (for instance the maven 2 public repository) so that you will just have to ask Ivy to install the modules you want with a simple command line.<br class="xooki-br"/><br class="xooki-br"/>To demonstrate this we will first use some basic ivy settings files to show how it works, and then we will use the advanced <a href="settings/namespaces.html">namespaces</a> feature to demonstrate how to deal with naming mismatch between the source and target repository.<br class="xooki-br"/><br class="xooki-br"/><h1>The project used</h1>
@@ -1097,58 +581,10 @@ Let's have a look at the <em>maven2</em>
</pre>
Pretty simple, we call the [[ant:install] task with the settings we have loaded using <a href="use/settings.html">ivy:settings</a> as usual, we provide fromResolver (source) and toResolver (destination) using properties to ease the maintenance of the script, but it's basically the name of our resolvers: 'libraries' for the source and 'my-repository' for the destination.<br class="xooki-br"/><br class="xooki-br"/>Here is the ant call output :
<div class="shell"><pre>
-[ivy@apache:/ivy/build-a-ivy-repository]$ ant maven2
-Buildfile: /ivy/build-a-ivy-repository/build.xml
-
-load-ivy:
-
-init-ivy:
-
-maven2:
-[ivy:install] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:install] :: loading settings :: file = /ivy/build-a-ivy-repository/settings/ivysettings-basic.xml
-[ivy:install] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/build-a-ivy-repository/settings/ivysettings-basic.xml)
-[ivy:install] :: installing commons-lang#commons-lang;1.0 ::
-[ivy:install] :: resolving dependencies ::
-[ivy:install] found commons-lang#commons-lang;1.0 in libraries
-[ivy:install] :: downloading artifacts to cache ::
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/1.0/commons-lang-1.0-javadoc.jar ...
-[ivy:install] .................................................................................................................................................................................................................................................................................................................................................................. (170kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] commons-lang#commons-lang;1.0!commons-lang.jar(javadoc) (3650ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/1.0/commons-lang-1.0.jar ...
-[ivy:install] ........................................................................................................................... (62kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] commons-lang#commons-lang;1.0!commons-lang.jar (2215ms)
-[ivy:install] :: installing in my-repository ::
-[ivy:install] published commons-lang to /ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/javadocs/commons-lang-1.0.jar
-[ivy:install] published commons-lang to /ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/jars/commons-lang-1.0.jar
-[ivy:install] published ivy to /ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/ivys/ivy-1.0.xml
-[ivy:install] :: install resolution report ::
-[ivy:install] :: resolution report :: resolve 0ms :: artifacts dl 5881ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 1 | 1 | 1 | 0 || 2 | 2 |
- ---------------------------------------------------------------------
-
-BUILD SUCCESSFUL
-Total time: 11 seconds
</pre></div>
The trace tells us that the module definition was found using the "libraries" resolver and that the corresponding artifact was downloaded from maven 2 repository. Then both were published to the filesystem repository (my-repository).<br class="xooki-br"/><br class="xooki-br"/>Let's have a look at our repository :
<div class="shell"><pre>
-[ivy@apache:/]$ find /ivy/build-a-ivy-repository/myrepository/no-namespace -type f -print
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/ivys/ivy-1.0.xml
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/ivys/ivy-1.0.xml.md5
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/ivys/ivy-1.0.xml.sha1
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/jars/commons-lang-1.0.jar
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/jars/commons-lang-1.0.jar.md5
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/jars/commons-lang-1.0.jar.sha1
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/javadocs/commons-lang-1.0.jar
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/javadocs/commons-lang-1.0.jar.md5
-/ivy/build-a-ivy-repository/myrepository/no-namespace/commons-lang/commons-lang/javadocs/commons-lang-1.0.jar.sha1
</div>
We can see that we now have the commons-lang module version 1.0 in our repository, with a generated ivy.xml file, its jar, and all the md5 and sha1 checksums for future consistency checks when developers will use this repository to resolve modules.<br class="xooki-br"/><br class="xooki-br"/><h1>install a module with dependencies</h1>
@@ -1159,309 +595,12 @@ Now let's say that we want to be sure al
If you call this target, you will see that Ivy installs not only the hibernate module but also its dependencies:
<div class="shell"><pre>
-[ivy@apache:/ivy/build-a-ivy-repository]$ ant maven2-deps
-Buildfile: /ivy/build-a-ivy-repository/build.xml
-
-load-ivy:
-
-init-ivy:
-
-maven2-deps:
-[ivy:install] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:install] :: loading settings :: file = /ivy/build-a-ivy-repository/settings/ivysettings-basic.xml
-[ivy:install] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/build-a-ivy-repository/settings/ivysettings-basic.xml)
-[ivy:install] :: installing org.hibernate#hibernate;3.2.5.ga ::
-[ivy:install] :: resolving dependencies ::
-[ivy:install] found org.hibernate#hibernate;3.2.5.ga in libraries
-[ivy:install] found net.sf.ehcache#ehcache;1.2.3 in libraries
-[ivy:install] found commons-logging#commons-logging;1.0.4 in libraries
-[ivy:install] found commons-collections#commons-collections;2.1 in libraries
-[ivy:install] found javax.transaction#jta;1.0.1B in libraries
-[ivy:install] found asm#asm-attrs;1.5.3 in libraries
-[ivy:install] found dom4j#dom4j;1.6.1 in libraries
-[ivy:install] found antlr#antlr;2.7.6 in libraries
-[ivy:install] found cglib#cglib;2.1_3 in libraries
-[ivy:install] found asm#asm;1.5.3 in libraries
-[ivy:install] found commons-collections#commons-collections;2.1.1 in libraries
-[ivy:install] found ant#ant;1.6.5 in libraries
-[ivy:install] found swarmcache#swarmcache;1.0RC2 in libraries
-[ivy:install] found commons-logging#commons-logging;1.0.2 in libraries
-[ivy:install] found jgroups#jgroups-all;2.2.8 in libraries
-[ivy:install] found jboss#jboss-cache;1.2.2 in libraries
-[ivy:install] found jboss#jboss-system;4.0.2 in libraries
-[ivy:install] found jboss#jboss-common;4.0.2 in libraries
-[ivy:install] found slide#webdavlib;2.0 in libraries
-[ivy:install] found xerces#xercesImpl;2.6.2 in libraries
-[ivy:install] found jboss#jboss-minimal;4.0.2 in libraries
-[ivy:install] found jboss#jboss-j2se;200504122039 in libraries
-[ivy:install] found concurrent#concurrent;1.3.4 in libraries
-[ivy:install] found jgroups#jgroups-all;2.2.7 in libraries
-[ivy:install] found c3p0#c3p0;0.9.1 in libraries
-[ivy:install] found javax.security#jacc;1.0 in libraries
-[ivy:install] found opensymphony#oscache;2.1 in libraries
-[ivy:install] found proxool#proxool;0.8.3 in libraries
-[ivy:install] :: downloading artifacts to cache ::
-[ivy:install] downloading http://repo1.maven.org/maven2/org/hibernate/hibernate/3.2.5.ga/hibernate-3.2.5.ga-sources.jar ...
-[ivy:install] ............................................................................................................................
-[ivy:install] ....................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ....................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
.............................................................................................................................................................. (1470kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] org.hibernate#hibernate;3.2.5.ga!hibernate.jar(source) (10826ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/org/hibernate/hibernate/3.2.5.ga/hibernate-3.2.5.ga-javadoc.jar ...
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
............................................................................................................................................................
-[ivy:install] .................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
............................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
....................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
............................................................................................................................................................................................
-[ivy:install] .............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .................................................................................................................................................................................................................................................................................................
-[ivy:install] ......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
...................................................................................................................................................
-[ivy:install] ...
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... (7352kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] org.hibernate#hibernate;3.2.5.ga!hibernate.jar(javadoc) (33836ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/org/hibernate/hibernate/3.2.5.ga/hibernate-3.2.5.ga.jar ...
-[ivy:install] ...................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ............................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ....................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ....................................................................................................................................................................................................................................
-[ivy:install] .............................................................................................................................................................................................
-[ivy:install] .........................................................................................................................................................................................................................................................................................................................................
-[ivy:install] .........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... (2202kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] org.hibernate#hibernate;3.2.5.ga!hibernate.jar (15897ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/net/sf/ehcache/ehcache/1.2.3/ehcache-1.2.3.jar ...
-[ivy:install] ............................................................................................................................................................................................................................................................................................................................................................................................................................ (203kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] net.sf.ehcache#ehcache;1.2.3!ehcache.jar (2215ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-logging/commons-logging/1.0.4/commons-logging-1.0.4.jar ...
-[ivy:install] .......................................................................... (37kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] commons-logging#commons-logging;1.0.4!commons-logging.jar (3291ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/asm/asm-attrs/1.5.3/asm-attrs-1.5.3.jar ...
-[ivy:install] .............................. (16kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] asm#asm-attrs;1.5.3!asm-attrs.jar (1560ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/dom4j/dom4j/1.6.1/dom4j-1.6.1.jar ...
-[ivy:install] .................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... (306kB)
-[ivy:install] ... (0kB)
-[ivy:install] [SUCCESSFUL ] dom4j#dom4j;1.6.1!dom4j.jar (3884ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/antlr/antlr/2.7.6/antlr-2.7.6.jar ...
-[ivy:install] ..................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ......................................................................................................................................................................................................................... (433kB)
-[ivy:install] ... (0kB)
-[ivy:install] [SUCCESSFUL ] antlr#antlr;2.7.6!antlr.jar (3370ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/cglib/cglib/2.1_3/cglib-2.1_3.jar ...
-[ivy:install] .................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. (275kB)
-[ivy:install] ... (0kB)
-[ivy:install] [SUCCESSFUL ] cglib#cglib;2.1_3!cglib.jar (2808ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/asm/asm/1.5.3/asm-1.5.3.jar ...
-[ivy:install] ..................................................... (25kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] asm#asm;1.5.3!asm.jar (1544ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-collections/commons-collections/2.1.1/commons-collections-2.1.1.jar ...
-[ivy:install] .......................................................................................................................................................................................................................................................................................................................... (171kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] commons-collections#commons-collections;2.1.1!commons-collections.jar (2450ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-collections/commons-collections/2.1/commons-collections-2.1.jar ...
-[ivy:install] ..................................................................................................................................................................................................................................................................................................... (161kB)
-[ivy:install] ... (0kB)
-[ivy:install] [SUCCESSFUL ] commons-collections#commons-collections;2.1!commons-collections.jar (2652ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/ant/ant/1.6.5/ant-1.6.5.jar ...
-[ivy:install] ......................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
-[ivy:install] ...............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
......................................................
-[ivy:install] .............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................. (1009kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] ant#ant;1.6.5!ant.jar (5288ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/swarmcache/swarmcache/1.0RC2/swarmcache-1.0RC2.jar ...
-[ivy:install] ........................................................... (29kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] swarmcache#swarmcache;1.0RC2!swarmcache.jar (2340ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/jboss/jboss-cache/1.2.2/jboss-cache-1.2.2.jar ...
-[ivy:install] ........................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... (365kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] jboss#jboss-cache;1.2.2!jboss-cache.jar (2933ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/jgroups/jgroups-all/2.2.8/jgroups-all-2.2.8.jar ...
-[ivy:install] .............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................
[... 245 lines stripped ...]