Say I have a project A
in development that depends on project B
- which is also currently in development and not yet released.
So, in A
's POM file, I have the following section:
<dependency>
<groupId>com.example</groupId>
<artifactId>project-b</artifactId>
<version>1.0.0-SNAPSHOT</version>
</dependency>
At work, we have a remote repo (Nexus) and a CI box (running Jenkins).
When my colleague makes a change to B
and commits to SVN, Jenkins will pick that change up, compile it and put it into the remote repo. Around that time, I might open B
locally, make a change, compile it and install it into my local repo.
How does Maven now resolve B
when I try to mvn clean install
A
locally?
We got ourselves a bit into a mess the other day, and basically had to manually remove the local repositories to ensure we got the version we were expecting to get. So I'm now trying to figure out what really went on. (Therefore, if you have links to places in the docs that go into detail, that, too, would be much appreciated...) Locally, I sometimes have a few SNAPSHOT builds in my repository folder, one without and a few with what looks like a timestamp after the SNAPSHOT
part of the file name...
Artifacts that you just mvn install
don't get a timestamp. A timestamp is applied once you mvn deploy
to your internal/remote repository. If you look into the maven-metadata-local.xml
in your local ~/.m2/repository/B/1.0.0-SNAPSHOT/
folder you'll see lines with:
<updated>YYYYMMDDHHMMSS</updated>
This is how the Maven dependency resolver decides what the latest snapshot is.
If it happens that you and your colleague deploy to your internal/remote repository within the same second it's up to the repository manager – Nexus in your case – to handle this.
Please note: The paragraphs above rely on my experience with Maven since I haven't seen a docu page where this is described in all details so far. Inputs where to find a reference as well as additions and corrections are highly welcome.
See Maven / Introduction to Repositories for an overview.
If you want to assure that you use the latest snapshots:
declare <updatePolicy>
in your settings.xml
accordingly:
- updatePolicy: This element specifies how often updates should attempt to occur. Maven will compare the local POM’s timestamp (stored in a repository’s maven-metadata file) to the remote. The choices are:
always
,daily
(default),interval:X
(where X is an integer in minutes) ornever.
use the -U
| --update-snapshots
command line option.
$ mvn -h ... -U,--update-snapshots Forces a check for missing releases and updated snapshots on remote repositories ...
„A timestamp after the SNAPSHOT part of the file name“ is unusual to me. AFAIHS it's either the one or the other only. Though this can happen if there is "-SNAPSHOT" in the <artifactId>
in your project's POM.
See also:
Repository - SNAPSHOT Handling, which reads:
This documentation was targetted at Maven 2.0 alpha 1. It is here only for historical reference and to be updated and integrated into the Maven documentation.
but I didn't find any latest documentation so far where this has been integrated.