Skip to content

Latest commit

 

History

History
75 lines (67 loc) · 2.95 KB

RELEASING.md

File metadata and controls

75 lines (67 loc) · 2.95 KB
Raw

How To Release

Due to Maven Central's very particular requirements, the release process is a bit elaborate and requires a good deal of local configuration. This guide should walk you through it. It won't do anyone outside of KeepSafe any good, but the workflow is representative of just about any project deploying via Sonatype.

We currently deploy to Maven Central (via Sonatype's OSS Nexus instance).

Prerequisites

  1. A published GPG code-signing key
  2. A Sonatype Nexus OSS account with permission to publish in com.getkeepsafe
  3. Permission to push directly to https://github.com/KeepSafe/TapTargetView

Setup

  1. Add your GPG key to your github profile - this is required for github to know that your commits and tags are "verified".
  2. Configure your code-signing key in ~/.gradle/gradle.properties: 
    signing.keyId=<key ID of your GPG signing key>
signing.password=<your key's passphrase>
signing.secretKeyRingFile=/path/to/your/secring.gpg
  3. Create a token for your Sonatype credentials. Source 
    1. Go to https://oss.sonatype.org/ and login
2. Go to profile
3. Change the pulldown from “Summary” to “User Token”
4. Click on “Access User Token”
  4. Configure your Sonatype credentials in ~/.gradle/gradle.properties: 
    mavenCentralUsername=<nexus username>
mavenCentralPassword=<nexus password>
SONATYPE_STAGING_PROFILE=com.getkeepsafe
  5. Configure git with your codesigning key; make sure it's the same as the one you use to sign binaries (i.e. it's the same one you added to gradle.properties): 
    # Do this for the TapTargetView repo only
git config user.email "your@email.com"
git config user.signingKey "your-key-id"
  6. Add your GPG key to ~/.gnupg

Pushing a build

  1. Edit gradle.properties, update the VERSION property for the new version release
  2. Edit changelog, add relevant changes, note the date and new version (follow the existing pattern)
  3. Add new ## [Unreleased] header for next release
  4. Verify that the everything works: 
    ./gradlew clean check
  5. Make a signed commit: 
    git commit -S -m "Release version X.Y.Z"
  6. Make a signed tag: 
    git tag -s -a X.Y.Z
  7. Publish to Release: 
    ./gradlew :taptargetview:publishAndReleaseToMavenCentral --no-configuration-cache
  8. Wait until that's done. It takes a while to publish and be available in MavenCentral. Monitor until the latest published version is visible.
  9. Hooray, we're in Maven Central now!
  10. Push all of our work to Github to make it official. Check previous releases and edit tag release changes: 
    git push --tags origin master