2005-01-19 23:15:26 +00:00
|
|
|
<html>
|
|
|
|
|
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Language" content="en-us">
|
2005-04-29 18:58:16 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
|
2005-01-19 23:15:26 +00:00
|
|
|
<title>Libraries Task</title>
|
|
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
<h2><a name="echo">Libraries</a></h2>
|
|
|
|
|
<h3>Description</h3>
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Extensible library download mechanism, integrated with the
|
|
|
|
|
<a href="http://maven.apache.org/">Maven</a> repository hosted
|
|
|
|
|
at ibiblio.org.
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
This task can:
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
2005-01-21 15:12:54 +00:00
|
|
|
<li>Download publicly published JAR files by version</li>
|
2005-01-19 23:15:26 +00:00
|
|
|
<li>Download JAR files from private file: or http: repositories</li>
|
|
|
|
|
<li>Cache the JAR files in a directory tree</li>
|
|
|
|
|
<li>Check for updates on a regular schedule</li>
|
2005-01-21 15:12:54 +00:00
|
|
|
<li>Build paths for compilation/execution</li>
|
2005-01-19 23:15:26 +00:00
|
|
|
<li>Fail the build if needed libraries are missing</li>
|
|
|
|
|
<li>Force an update of all libraries</li>
|
|
|
|
|
<li>Skip all downloading when offline
|
|
|
|
|
</ol>
|
|
|
|
|
|
|
|
|
|
<h3>Parameters</h3>
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">destDir</td>
|
|
|
|
|
<td valign="top">Destination directory for all downloads
|
|
|
|
|
</td>
|
2005-01-20 15:59:52 +00:00
|
|
|
<td valign="top" align="center">No - default is ${user.home}/.maven/repository</td>
|
2005-01-19 23:15:26 +00:00
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">offline</td>
|
|
|
|
|
<td valign="top">Flag to indicate that the system is offline, and that
|
|
|
|
|
no downloads should take place.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">flatten</td>
|
|
|
|
|
<td valign="top">flag to indicate that files should be flattened when downloaded
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default false</td>
|
|
|
|
|
</tr>
|
2005-01-21 13:15:34 +00:00
|
|
|
<tr>
|
|
|
|
|
<td valign="top">usetimestamp</td>
|
|
|
|
|
<td valign="top">flag to indicate that timestamps should
|
|
|
|
|
be compared when probing for updates.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default false</td>
|
|
|
|
|
</tr>
|
2005-01-19 23:15:26 +00:00
|
|
|
<tr>
|
|
|
|
|
<td valign="top">pathID</td>
|
|
|
|
|
<td valign="top">Name of a path to create containing all
|
|
|
|
|
libraries in this declaration.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">repositoryRef</td>
|
|
|
|
|
<td valign="top">Reference to a predefined repository
|
|
|
|
|
</td>
|
2005-01-20 15:59:52 +00:00
|
|
|
<td valign="top" align="center">No</td>
|
2005-01-19 23:15:26 +00:00
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
2005-01-20 15:59:52 +00:00
|
|
|
<p>
|
|
|
|
|
The default destination is that used by Maven,
|
|
|
|
|
${user.home}/.maven/repository . It can be overridden by setting the
|
|
|
|
|
property <code>ant.maven.repository.dir</code> to a new location.
|
|
|
|
|
</p>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
<h3>Nested Elements</h3>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h4>library</h4>
|
2005-01-21 15:12:54 +00:00
|
|
|
This is the core of the system: a library to (potentially) download.
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">project</td>
|
|
|
|
|
<td valign="top">Name of the project
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">version</td>
|
|
|
|
|
<td valign="top">
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">archive</td>
|
|
|
|
|
<td valign="top">Name of the archive
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">destinationName</td>
|
|
|
|
|
<td valign="top">Filename of downloaded file
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No, default remote name</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">suffix</td>
|
|
|
|
|
<td valign="top">Suffix of the archive
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default ".jar"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">enabled</td>
|
|
|
|
|
<td valign="top">flag to turn on or off specific download/use
|
|
|
|
|
of an archive
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default "true"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h4>Repository</h4>
|
2005-01-20 15:59:52 +00:00
|
|
|
<p>
|
2005-01-21 15:12:54 +00:00
|
|
|
A repository is an Ant datatype that extends the <code>Repository</code>
|
|
|
|
|
type. Ant only ships with one: the mavenrepository. If no repository is
|
2005-01-20 15:59:52 +00:00
|
|
|
declared inline, and no repositoryref attribute set, the task
|
|
|
|
|
will default to the maven repository.
|
|
|
|
|
</p>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">url</td>
|
|
|
|
|
<td valign="top">URL of the repository
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
|
|
|
|
<repository ref="predefined.repository" />
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h4>mavenrepository</h4>
|
|
|
|
|
|
2005-01-20 15:59:52 +00:00
|
|
|
<p>
|
|
|
|
|
This connects to the Maven repository at ibiblio.org, or another
|
|
|
|
|
chosen. Private repositories should copy the existing layout.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
If no <code>url</code> is set, the default URL is
|
|
|
|
|
<code>http://ibiblio.org/maven</code>, unless the property
|
|
|
|
|
<code>ant.maven.repository.url</code> is set to something else.
|
|
|
|
|
|
2005-01-19 23:15:26 +00:00
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">url</td>
|
|
|
|
|
<td valign="top">URL of the repository
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">checkMD5</td>
|
|
|
|
|
<td valign="top">Flag to turn on MD5 checking
|
|
|
|
|
(unimplemented)
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">username</td>
|
|
|
|
|
<td valign="top">HTTP authentication username
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">password</td>
|
|
|
|
|
<td valign="top">HTTP authentication password
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Only if username is set</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<h3>UpdatePolicies</h3>
|
|
|
|
|
|
|
|
|
|
<P>Update policies are an (extensible) means of tuning the download, running
|
|
|
|
|
code before and possibly after a download. They can enable or disable
|
|
|
|
|
checks for individual files, skip the download process, or perform some
|
|
|
|
|
post-download validation.
|
|
|
|
|
</P>
|
|
|
|
|
|
|
|
|
|
<P>All policies have at least the common set of attributes; some may have more,
|
|
|
|
|
in which case an updated attribute list is shown. </P>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">enabled</td>
|
|
|
|
|
<td valign="top">Enabled flag
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default "true"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<P>Policies can be chained by listing them in order. Before an update/download
|
|
|
|
|
takes place, all policies will be executed in order. After the download, the
|
|
|
|
|
policies will be invoked in reverse order. The compound policy in such a
|
|
|
|
|
situation is left to the experimentor, though reading the source will help.
|
|
|
|
|
</P>
|
|
|
|
|
|
|
|
|
|
<p>
|
2005-01-21 15:12:54 +00:00
|
|
|
Developers may add new policies (such as signing incoming files) by adding
|
|
|
|
|
new datatypes extending the <code>LibraryPolicy</code> class. </P>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
<h4>noupdate</h4>
|
|
|
|
|
|
|
|
|
|
<P>This policy will disable remote downloads when enabled. It is the policy
|
|
|
|
|
equivalent of the offline flag.</P>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
2005-01-21 15:12:54 +00:00
|
|
|
<noupdate />
|
2005-01-19 23:15:26 +00:00
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h4>forceupdate</h4>
|
|
|
|
|
|
|
|
|
|
<P>This policy forces all libraries to be downloaded. If any download failed,
|
|
|
|
|
the build will halt.</P>
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
2005-01-21 15:12:54 +00:00
|
|
|
<forceupdate />
|
2005-01-19 23:15:26 +00:00
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h4>timestamp</h4>
|
|
|
|
|
|
|
|
|
|
<P>This policy tells Ant to check the repository to see if the files have changed
|
2005-01-21 13:15:34 +00:00
|
|
|
using timestamp checks. Any files which are up to date will not be downloaded again.
|
|
|
|
|
It is equivalent to setting the <code>useTimestamp</code> flag. </P>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
2005-01-21 15:12:54 +00:00
|
|
|
<timestamp />
|
2005-01-19 23:15:26 +00:00
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h4>scheduledupdate</h4>
|
|
|
|
|
|
|
|
|
|
This policy tells Ant to check the repository to see if the files have changed,
|
|
|
|
|
but only intermittently. An interval of the size of the schedule has to have
|
|
|
|
|
passed, or the set of files to check has to have changed.
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">enabled</td>
|
|
|
|
|
<td valign="top">Enabled flag
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default "true"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">markerFile</td>
|
|
|
|
|
<td valign="top">Name of a file to cache download history
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">Days</td>
|
|
|
|
|
<td valign="top">number of days between update checks
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">Hours</td>
|
|
|
|
|
<td valign="top">number of hours between update checks
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">Minutes</td>
|
|
|
|
|
<td valign="top">number of minutes between update checks
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
2005-01-21 15:12:54 +00:00
|
|
|
<scheduledupdate days="1" hours="3" minutes="17" />
|
2005-01-19 23:15:26 +00:00
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<P>Check for an update every 27 hours, 17 minutes. </P>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h4>assertdownloaded</h4>
|
|
|
|
|
|
|
|
|
|
<P>This policy is really for testing the library. It does not
|
|
|
|
|
alter the download policy, but after any download has taken place,
|
|
|
|
|
it verifies that the number of files downloaded matches the number
|
|
|
|
|
expected.</P>
|
|
|
|
|
|
|
|
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top"><b>Attribute</b></td>
|
|
|
|
|
<td valign="top"><b>Description</b></td>
|
|
|
|
|
<td align="center" valign="top"><b>Required</b></td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">count</td>
|
|
|
|
|
<td valign="top">number of downloaded files expected.
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">Yes</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td valign="top">enabled</td>
|
|
|
|
|
<td valign="top">Enabled flag
|
|
|
|
|
</td>
|
|
|
|
|
<td valign="top" align="center">No -default "true"</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
|
<p>Example:</p>
|
|
|
|
|
<pre>
|
2005-01-21 15:12:54 +00:00
|
|
|
<assertdownloaded count="4" />
|
2005-01-19 23:15:26 +00:00
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
<h3>Examples</h3>
|
|
|
|
|
<pre>
|
|
|
|
|
<!--
|
|
|
|
|
versions.properties says
|
|
|
|
|
xdoclet.version=2.0
|
|
|
|
|
commons-logging.version=1.0.3
|
|
|
|
|
commons-collections.version=3.1
|
|
|
|
|
-->
|
|
|
|
|
<property file="versions.properties" />
|
|
|
|
|
|
|
|
|
|
<libraries destDir="${lib.dir}" pathid="xdoclet.lib" >
|
|
|
|
|
<mavenrepository />
|
|
|
|
|
<library project="xdoclet"
|
|
|
|
|
version="${xdoclet.version}" />
|
|
|
|
|
<library project="commons-logging"
|
|
|
|
|
version="${commons-logging.version}" />
|
|
|
|
|
<library project="commons-collections"
|
|
|
|
|
version="${commons-collections.version}" />
|
|
|
|
|
</libraries>
|
|
|
|
|
</pre>
|
|
|
|
|
|
2005-03-09 17:15:19 +00:00
|
|
|
<p>Load in versions from a file, then download the relevant archives. No
|
2005-01-19 23:15:26 +00:00
|
|
|
update schedule is defined, but a path is created for insertion into a
|
|
|
|
|
classpath. This property file driven dependency model is what we recommend
|
|
|
|
|
over hard coding versions in a build file.
|
2005-03-09 17:15:19 +00:00
|
|
|
</p>
|
|
|
|
|
<pre> <libraries destDir="build/lib" offline="${offline}" flatten="true">
|
2005-01-19 23:15:26 +00:00
|
|
|
<mavenrepository url="${private.server}"/>
|
|
|
|
|
<library project="doomed" archive="dead-code"
|
|
|
|
|
suffix=".war"
|
|
|
|
|
destinationName="product.war"
|
2005-01-21 15:12:54 +00:00
|
|
|
version="LATEST" />
|
2005-01-19 23:15:26 +00:00
|
|
|
<scheduledupdate markerfile="build/lib/marker.properties"
|
|
|
|
|
hours="11" />
|
|
|
|
|
</libraries>
|
2005-03-09 17:15:19 +00:00
|
|
|
</pre>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
2005-03-09 17:15:19 +00:00
|
|
|
<p>Download doomed/dead-code.LATEST.war from a private repository, save it to
|
2005-01-19 23:15:26 +00:00
|
|
|
build/lib/product.war with an update schedule of every eleven hours.
|
2005-03-09 17:15:19 +00:00
|
|
|
</p>
|
|
|
|
|
|
2005-04-29 18:58:16 +00:00
|
|
|
<hr>
|
2005-01-19 23:15:26 +00:00
|
|
|
|
|
|
|
|
<p align="center">Copyright © 2005 The Apache Software Foundation. All rights
|
|
|
|
|
Reserved.</p>
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
|
