1
0
mirror of https://github.com/square/okhttp.git synced 2025-11-23 06:42:24 +03:00
Files
okhttp/docs/releasing.md
2021-12-23 10:56:33 -05:00

64 lines
1.7 KiB
Markdown

Releasing
=========
### Prerequisite: Sonatype (Maven Central) Account
Create an account on the [Sonatype issues site][sonatype_issues]. 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][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][github_actions] to build and publish.
8. Visit [Sonatype Nexus][sonatype_nexus] to promote (close then release) the releases. Or drop it
if there is a problem!
[github_actions]: https://github.com/square/okhttp/actions
[sonatype_issues]: https://issues.sonatype.org/
[sonatype_nexus]: https://s01.oss.sonatype.org/