<b>Tag:</b> caches

<span class="tagdoc" id="ivysettings.caches">Configures the Ivy cache system.</span> <span class="since">since 2.0</span>.
See <a href="../concept.html#cache">cache concept</a> for details on the Ivy cache concept.

By default, Ivy defines one repository cache instance, called 'default-cache', which uses the default cache settings defined using attributes on this tag. This default instance is defined as long as you don't define your own default cache using the 'default' attribute, and have at least one dependency resolver which doesn't specify which cache instance to use.

<em>defaultCacheDir</em> is the default directory used for both the resolution and repository cache(s). It usually points to a directory in your filesystem. If you want to isolate resolution cache from repository cache, we recommend setting both the resolutionCacheDir and repositoryCacheDir attributes on this tag instead of using defaultCacheDir.

Since repository cache implementations are pluggable, you can either define new cache instances based on the default implementation provided in Ivy using the [[settings/caches/cache]] child element, or use custom cache implementations using child elements as you have defined using [[settings/typedef]].

<em>ivyPattern</em> and <em>artifactPattern</em> are used to configure the default way Ivy stores ivy files and artifacts in repository cache(s). Usually you do not have to change this, unless you want to use the cache directly from another tool, which is not recommended. These patterns are relative to the repository cache base directory.

<em>checkUpToDate</em> indicates to ivy if it must check date of artifacts before retrieving them (i.e. copying them from
cache to another place in your filesystem). Usually it is a good thing to check date to avoid unnecessary copy, even if it's most of the time a local copy.

<h1>Attributes</h1>
<table class="ivy-attributes">
<thead>
    <tr><th class="ivy-att">Attribute</th><th class="ivy-att-desc">Description</th><th class="ivy-att-req">Required</th></tr>
</thead>
<tbody>
    <tr><td>default</td><td>the name of the default cache to use on all resolvers not defining the cache instance to use</td>
        <td>No, defaults to a default cache manager instance named 'default-cache'</td></tr>
    <tr><td>defaultCacheDir</td><td>a path to a directory to use as default basedir for both resolution and repository cache(s)</td>
        <td>No, defaults to .ivy2/cache in the user's home directory</td></tr>
    <tr><td>resolutionCacheDir</td><td>the path of the directory to use for all resolution cache data</td>
        <td>No, defaults to defaultCacheDir</td></tr>
    <tr><td>repositoryCacheDir</td><td>the path of the default directory to use for repository cache data. <strong>This should not point to a directory used as a repository!</strong></td>
        <td>No, defaults to defaultCacheDir</td></tr>
    <tr><td>ivyPattern</td><td>default pattern used to indicate where ivy files should be put in the repository cache(s)</td>
        <td>No, defaults to [organisation]/[module]/ivy-[revision].xml</td></tr>
    <tr><td>artifactPattern</td><td>default pattern used to indicate where artifact files should be put in the repository cache(s)</td>
        <td>No, defaults to [organisation]/[module]/[type]s/[artifact]-[revision].[ext]</td></tr>
    <tr><td><s>checkUpToDate</s></td><td>Indicates if date should be checked before retrieving artifacts from cache.
    	<i>Deprecated, we recommend using overwriteMode on the [[use/retrieve]] task instead</i></td>
        <td>No, defaults to true</td></tr>
    <tr><td>useOrigin</td><td>the default value to use for useOrigin for caches in which it isn't specifically defined.
    	Use true to avoid the copy of local artifacts to the cache and use directly their original location.</td>
        <td>No, defaults to false</td></tr>
    <tr><td>lockStrategy</td><td>the name of the default [[settings/lock-strategies lock strategy]] to use when accessing repository cache(s)</td>
        <td>No, defaults to <em>no-lock</em></td></tr>
</tbody>
</table>
<h1>Child elements</h1>
<table class="ivy-children">
<thead>
    <tr><th class="ivy-chld">Element</th><th class="ivy-chld-desc">Description</th><th class="ivy-chld-card">Cardinality</th></tr>
</thead>
<tbody>
    <tr><td><a href="caches/cache.html">cache</a></td><td>defines a new repository cache instance, based on the default repository cache implementation</td>
        <td>0..n</td></tr>
</tbody>
</table>
<h1>Examples</h1>
<code type="xml">
<caches>
  <cache name="mycache" basedir="path/to/my/cache/1" />
  <cache name="mycache2" basedir="path/to/my/cache/2" />
</caches> 
</code>
Define 2 cache instances, named mycache and mycache2, using two different directories as base directory, and using the default patterns and lock strategies. The default cache instance will still be defined as long as at least one dependency resolver does not declare which cache manager to use.
<hr/>