This document describes the steps to release a new version of DNSimple/Java.
- You have commit access to the repository
- You have push access to the repository
- You have a GPG key configured for signing tags
-
Determine the new version using Semantic Versioning
VERSION=X.Y.Z
- MAJOR version for incompatible API changes
- MINOR version for backwards-compatible functionality additions
- PATCH version for backwards-compatible bug fixes
-
Run tests and confirm they pass
./gradlew clean test(use
gradlew.batin Windows instead) -
Update the version files with the new version
Edit
dnsimple.java:public interface Dnsimple { public static final String VERSION = "$VERSION"; //... }
Edit
build.gradle(setting the proper version):version = '$VERSION'
Edit
VERSION(setting the proper version):$VERSION -
Update the changelog with the new version
Finalize the
## mainsection inCHANGELOG.mdassigning the version. -
Commit the new version
git commit -a -m "Release $VERSION" -
Push the changes
git push origin main
-
Wait for CI to complete
-
Create a signed tag
git tag -a v$VERSION -s -m "Release $VERSION" git push origin --tags
GitHub will take the new tag and release it automatically into Maven Central.
- Verify the new version appears on Maven Central
- Verify the GitHub release was created
- Announce the release if necessary