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 the publish job.

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. Confirm the GitHub Actions publish job succeeded.