Release Procedure

Release Procedure

Pre-release steps

Check the osmdroidbugs gmail account for any crash logs, review and fix if possible.

Edit gradle.properties and update the version information :

• pom.version (usually just remove SNAPSHOT)
• android.versionCode (it’s probably already okay)

Commit the change and tag with git.
Use the tag name: 'osmdroid-parent-{version}' to keep in line with the previous releases.
git push

Set credentials in gradle.properties

Edit your user gradle.properties (~/.gradle/gradle.properties) and set the following properties :

# Credentials for Maven Central
NEXUS_USERNAME=***
NEXUS_PASSWORD=***
GPG_PATH=***
signing.password=***
signing.keyId=***

# Google Play signing key
android.signingConfigs.release.storeFile=***
android.signingConfigs.release.storePassword=***
android.signingConfigs.release.keyAlias=***
android.signingConfigs.release.keyPassword=***

Build and publish to Nexus (Maven Central)

./release.bat

Be sure to carefully monitor the output. Gradle does not honor process exit codes so the release script cannot detect a build failure or success.

Go to Sonatype, select “staging repositories”, check osmdroid and click “close” and then “release”.

Upload osmdroid-dist release zip on Github

https://github.com/osmdroid/osmdroid/releases/new

Output zip is at osmdroid-dist/build/distributions/

Publish APK to Google Play

https://play.google.com/apps/publish/

Output APK is at OpenStreetMapViewer\build\outputs\apk\OpenStreetMapViewer-{version}-release.apk

Post-release steps

Update readme.md to have the current version number listed.

Edit gradle.properties and update the version information :

• pom.version (next SNAPSHOT)
• android.versionCode (increment by 1)

git commit and push

Wiki updates

Update the change log Update the upgrade guide