Maven Snapshots¶

The current live jar published by GeoTools is known as a SNAPSHOT. Projects that want to work directly with GeoTools will depend “SNAPSHOT” rather than specifying a version number.

Grab SNAPSHOT Dependency¶

We depend on a “snapshot” of several projects (usually project GeoTools community members are involved such as ImageIO-EXT). In these cases an email will be sent to the developer list asking people to “update with -U”.

To respond to one of these emails include “-u” in your next build.

Update (for example from upstream):
```
git pull --rebase upstream main
```
Build using the -U option:
```
mvn clean install -U -DskipTests
```

The above example skipped running the tests (which is common when you are trying for a quick update), please note by definition that “-U” is not compatible with the “-o” offline mode.

Publish GeoTools SNAPSHOT¶

If you are working on GeoServer or uDig or another project that depends on the latest greatest GeoTools release you will need to know how to deploy a SNAPSHOT (so members of your developer community do not get compile errors).

The build server build.geoserver.org is watching the repository, and will build and deploy a snapshot. If you really cannot wait:

Update to make sure you are not missing out on anyone’s work:
```
git pull --rebase upstream main
```
Build with tests to make sure your commit is not fatal:
```
mvn clean install
```

Commit - remember to include any Jira issue numbers in your log message:

mvn commit -m "Change to fix shapefile charset handling, see GEOT-1437"

Push the commits back to upstream:
```
mvn push upstream main
```

Ensure your ~/.m2/settings.xml has your webdav credentials.

osgeo - this is the same as your OSGeo credentials

boundlessgeo - ask on the developer email list

The settings.xml should list both:

<?xml version="1.0" encoding="ISO-8859-1"?>
<settings>
    <offline>false</offline>
    <servers>
     <server>
       <id>osgeo</id>
       <username>USERID</username>
       <password>PASSWORD</password>
     </server>
     <server>
       <id>boundlessgeo</id>
       <username>USERID</username>
       <password>PASSWOD</password>
     </server>
    </servers>
</settings>

Deploy for members of your community:
```
mvn deploy -Dmaven.test.skip=true
```
Let your community know via email! (The email can ask them to build with -U).