Versions
This page shows the additional information about our Versioning Policy and lifecycles.
Table of Contents
Versioning Policy
The major version of this project defines which spring-boot version we are compatible with.
- 1.x.x versions are EOL and won’t receive any updates
- 2.x.x is the current version and will be updated if there are spring-boot or gRPC releases.
- 3.x.x is the current version and will be updated if there are spring-boot or gRPC releases.
The minor version defines the feature version of this project. Every time we bump spring-boot’s or gRPC’s version, we will also increment our feature version. The same applies if we add/change major features. In most cases you will not get any incompatibilities by upgrading, but since gRPC evolves just like its API, this cannot be ruled out. We try to minimize such influences, but can’t rule them out. If you don’t use advanced features, you won’t usually notice.
We usually don’t release patch versions, but include these patches in the next release. If you need a patched version, please open an issue.
Version Table
This table shows the spring and gRPC version that this library ships. In most cases you can upgrade to newer versions, but especially gRPC changes its API more frequently. Please report any issues to our repo.
Note
If you are using the non-shaded netty (and related libraries) please stick exactly to the version that is documented by gRPC. (grpc-netty-shaded avoids these issues by keeping these versions in sync.)
Version 3.x
Current version.
| Version | spring-boot | spring-cloud | gRPC | Date |
|---|---|---|---|---|
| 3.1.0 | 3.2.4 | 2023.0.0 | 1.63.0 | Apr, 2024 |
| 3.0.0 | 3.2.2 | 2023.0.0 | 1.60.1 | Feb, 2024 |
(* Future versions)
The listed dependency versions here are only used during the build process and may be replaced. grpc-spring-boot-starter is usually also compatible with newer or older versions than the listed ones. If you encounter an incompatibility with a newer version, please let us know so we can update this project!
Version 2.x
| Version | spring-boot | spring-cloud | gRPC | Date |
|---|---|---|---|---|
| 2.15.0 | 2.7.16 | 2021.0.8 | 1.58.0 | Sep, 2023 |
| 2.14.0 | 2.6.13 | 2021.0.5 | 1.51.0 | Nov, 2022 |
| 2.13.1 | 2.5.8 | 2020.0.5 | 1.42.2 | Jan, 2022 |
| 2.13.0 | 2.5.7 | 2020.0.4 | 1.42.1 | Nov, 2021 |
| 2.12.0 | 2.4.5 | 2020.0.2 | 1.37.0 | Mai, 2021 |
| 2.11.0 | 2.3.8 | Hoxton | 1.35.0 | Feb, 2021 |
| 2.10.1 | 2.3.3 | Hoxton | 1.31.1 | Aug, 2020 |
| 2.10.0 | 2.3.3 | Hoxton | 1.31.1 | Aug, 2020 |
| 2.9.0 | 2.3.1 | Hoxton | 1.30.0 | Jun, 2020 |
| 2.8.0 | 2.2.7 | Hoxton | 1.29.0 | Jun, 2020 |
| 2.7.0 | 2.2.4 | Hoxton | 1.27.1 | Feb, 2020 |
| 2.6.2 | 2.2.1 | Hoxton | 1.25.0 | Jan, 2020 |
| 2.6.1 | 2.2.1 | Hoxton | 1.25.0 | Nov, 2019 |
| 2.6.0 | 2.2.1 | Hoxton | 1.24.2 | Nov, 2019 |
| 2.5.1 | 2.1.6 | Greenwich | 1.22.2 | Aug, 2019 |
| 2.5.0 | 2.1.6 | Greenwich | 1.22.1 | Aug, 2019 |
| 2.4.0 | 2.1.5 | Finchley | 1.20.0 | Jun, 2019 |
| 2.3.0 | 2.1.4 | Finchley | 1.18.0 | Apr, 2019 |
| 2.2.1 | 2.0.7 | ? | 1.17.1 | Jan, 2019 |
| 2.2.0 | 2.0.6 | ? | 1.17.1 | Dec, 2018 |
| 2.1.0 | 2.0.? | ? | 1.14.0 | Oct, 2018 |
| 2.0.1 | 2.0.? | ? | 1.14.0 | Aug, 2018 |
| 2.0.0 | 2.0.? | ? | 1.13.1 | Aug, 2018 |
Version 1.x
End of life - No more updates planned.
| Version | spring-boot | gRPC | Date |
|---|---|---|---|
| 1.4.2 | 1.?.? | 1.12.0 | Jun, 2019 |
| 1.4.1 | 1.?.? | 1.12.0 | Jun, 2018 |
| … | 1.?.? | N/A |
Upgrading Dependencies
If you upgrade any of the versions we strongly recommend doing so using a bom:
Release Notes
Refer to the release notes for more information on the changes for each version: