This repository was archived by the owner on Sep 16, 2023. It is now read-only.

File tree

2 files changed

+48
-2
lines changed

2 files changed

+48
-2
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
docker:
22
image: gcr.io/repo-automation-bots/owlbot-java:latest
3-
digest: sha256:2e88a4a7fe3377cf8de1fa5982134f6ef2768980fa2f94edcc1ba6604ae2e7ca
3+
digest: sha256:69045edb77ff7c78fdfad02eae2b4493b2c358cd9778ab5b6dba0c2b578df0ec
Original file line numberDiff line numberDiff line change
@@ -71,10 +71,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
7171

7272
Service Usage uses gRPC for the transport layer.
7373

74-
## Java Versions
74+
## Supported Java Versions
7575

7676
Java 7 or above is required for using this client.
7777

78+
Google's Java client libraries,
79+
[Google Cloud Client Libraries][cloudlibs]
80+
and
81+
[Google Cloud API Libraries][apilibs],
82+
follow the
83+
[Oracle Java SE support roadmap][oracle]
84+
(see the Oracle Java SE Product Releases section).
85+
86+
### For new development
87+
88+
In general, new feature development occurs with support for the lowest Java
89+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
90+
from initial General Availability). If the minimum required JVM for a given
91+
library is changed, it is accompanied by a [semver][semver] major release.
92+
93+
Java 11 and (in September 2021) Java 17 are the best choices for new
94+
development.
95+
96+
### Keeping production systems current
97+
98+
Google tests its client libraries with all current LTS versions covered by
99+
Oracle's Extended Support (which typically lasts 8 years from initial
100+
General Availability).
101+
102+
#### Legacy support
103+
104+
Google's client libraries support legacy versions of Java runtimes with long
105+
term stable libraries that don't receive feature updates on a best efforts basis
106+
as it may not be possible to backport all es.
107+
108+
Google provides updates on a best efforts basis to apps that continue to use
109+
Java 7, though apps might need to upgrade to current versions of the library
110+
that supports their JVM.
111+
112+
#### Where to find specific information
113+
114+
The latest versions and the supported Java versions are identified on
115+
the individual repository `.com/GoogleAPIs/java-SERVICENAME`
116+
and on [google-cloud-java][g-c-j].
117+
78118
## Versioning
79119

80120

@@ -135,3 +175,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
135175
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=serviceusage.googleapis.com
136176
[libraries-bom]: https://.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
137177
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
178+
179+
[semver]: https://semver.org/
180+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
181+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
182+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
183+
[g-c-j]: http://.com/googleapis/google-cloud-java

0 commit comments

Comments
 (0)