@@ -109,10 +109,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
109109
110110Access Approval uses gRPC for the transport layer.
111111
112- ## Java Versions
112+ ## Supported Java Versions
113113
114114Java 7 or above is required for using this client.
115115
116+ Google's Java client libraries,
117+ [ Google Cloud Client Libraries] [ cloudlibs ]
118+ and
119+ [ Google Cloud API Libraries] [ apilibs ] ,
120+ follow the
121+ [ Oracle Java SE support roadmap] [ oracle ]
122+ (see the Oracle Java SE Product Releases section).
123+
124+ ### For new development
125+
126+ In general, new feature development occurs with support for the lowest Java
127+ LTS version covered by Oracle's Premier Support (which typically lasts 5 years
128+ from initial General Availability). If the minimum required JVM for a given
129+ library is changed, it is accompanied by a [ semver] [ semver ] major release.
130+
131+ Java 11 and (in September 2021) Java 17 are the best choices for new
132+ development.
133+
134+ ### Keeping production systems current
135+
136+ Google tests its client libraries with all current LTS versions covered by
137+ Oracle's Extended Support (which typically lasts 8 years from initial
138+ General Availability).
139+
140+ #### Legacy support
141+
142+ Google's client libraries support legacy versions of Java runtimes with long
143+ term stable libraries that don't receive feature updates on a best efforts basis
144+ as it may not be possible to backport all patches.
145+
146+ Google provides updates on a best efforts basis to apps that continue to use
147+ Java 7, though apps might need to upgrade to current versions of the library
148+ that supports their JVM.
149+
150+ #### Where to find specific information
151+
152+ The latest versions and the supported Java versions are identified on
153+ the individual GitHub repository ` github.com/GoogleAPIs/java-SERVICENAME `
154+ and on [ google-cloud-java] [ g-c-j ] .
155+
116156## Versioning
117157
118158
@@ -173,3 +213,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
173213[ enable-api ] : https://console.cloud.google.com/flows/enableapi?apiid=accessapproval.googleapis.com
174214[ libraries-bom ] : https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
175215[ shell_img ] : https://gstatic.com/cloudssh/images/open-btn.png
216+
217+ [ semver ] : https://semver.org/
218+ [ cloudlibs ] : https://cloud.google.com/apis/docs/client-libraries-explained
219+ [ apilibs ] : https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
220+ [ oracle ] : https://www.oracle.com/java/technologies/java-se-support-roadmap.html
221+ [ g-c-j ] : http://github.com/googleapis/google-cloud-java
0 commit comments