okhttp/docs/releasing.md

Releasing

Prerequisite: Sonatype (Maven Central) Account

Create an account on the Sonatype issues site. Ask an existing publisher to open an issue requesting publishing permissions for com.squareup projects.

Cutting a Release

1. Update CHANGELOG.md.

2. Set versions:

   export RELEASE_VERSION=X.Y.Z
   export NEXT_VERSION=X.Y.Z-SNAPSHOT
   

3. Update versions:

   sed -i "" \
     "s/version = \".*\"/version = \"$RELEASE_VERSION\"/g" \
     build.gradle.kts
   sed -i "" \
     "s/\"com.squareup.okhttp3:\([^\:]*\):[^\"]*\"/\"com.squareup.okhttp3:\1:$RELEASE_VERSION\"/g" \
     `find . -name "README.md"`
   sed -i "" \
     "s/\/com.squareup.okhttp3\/\([^\:]*\)\/[^\/]*\//\/com.squareup.okhttp3\/\1\/$RELEASE_VERSION\//g" \
     `find . -name "README.md"`
   

4. Tag the release and push to GitHub.

   git commit -am "Prepare for release $RELEASE_VERSION."
   git tag -a parent-$RELEASE_VERSION -m "Version $RELEASE_VERSION"
   git push && git push --tags
   

5. Wait for GitHub Actions to start building the release.

6. Prepare for ongoing development and push to GitHub.

   sed -i "" \
     "s/version = \".*\"/version = \"$NEXT_VERSION\"/g" \
     build.gradle.kts
   git commit -am "Prepare next development version."
   git push
   

7. Wait for GitHub Actions to build and publish.

8. Visit Sonatype Nexus to promote (close then release) the releases. Or drop it if there is a problem!