@@ -74,10 +74,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
74
74
75
75
Area 120 Tables uses gRPC for the transport layer.
76
76
77
- ## Java Versions
77
+ ## Supported Java Versions
78
78
79
79
Java 7 or above is required for using this client.
80
80
81
+ Google's Java client libraries,
82
+ [ Google Cloud Client Libraries] [ cloudlibs ]
83
+ and
84
+ [ Google Cloud API Libraries] [ apilibs ] ,
85
+ follow the
86
+ [ Oracle Java SE support roadmap] [ oracle ]
87
+ (see the Oracle Java SE Product Releases section).
88
+
89
+ ### For new development
90
+
91
+ In general, new feature development occurs with support for the lowest Java
92
+ LTS version covered by Oracle's Premier Support (which typically lasts 5 years
93
+ from initial General Availability). If the minimum required JVM for a given
94
+ library is changed, it is accompanied by a [ semver] [ semver ] major release.
95
+
96
+ Java 11 and (in September 2021) Java 17 are the best choices for new
97
+ development.
98
+
99
+ ### Keeping production systems current
100
+
101
+ Google tests its client libraries with all current LTS versions covered by
102
+ Oracle's Extended Support (which typically lasts 8 years from initial
103
+ General Availability).
104
+
105
+ #### Legacy support
106
+
107
+ Google's client libraries support legacy versions of Java runtimes with long
108
+ term stable libraries that don't receive feature updates on a best efforts basis
109
+ as it may not be possible to backport all patches.
110
+
111
+ Google provides updates on a best efforts basis to apps that continue to use
112
+ Java 7, though apps might need to upgrade to current versions of the library
113
+ that supports their JVM.
114
+
115
+ #### Where to find specific information
116
+
117
+ The latest versions and the supported Java versions are identified on
118
+ the individual GitHub repository ` github.com/GoogleAPIs/java-SERVICENAME `
119
+ and on [ google-cloud-java] [ g-c-j ] .
120
+
81
121
## Versioning
82
122
83
123
@@ -141,3 +181,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
141
181
[ enable-api ] : https://console.cloud.google.com/flows/enableapi?apiid=area120tables.googleapis.com
142
182
[ libraries-bom ] : https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
143
183
[ shell_img ] : https://gstatic.com/cloudssh/images/open-btn.png
184
+
185
+ [ semver ] : https://semver.org/
186
+ [ cloudlibs ] : https://cloud.google.com/apis/docs/client-libraries-explained
187
+ [ apilibs ] : https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
188
+ [ oracle ] : https://www.oracle.com/java/technologies/java-se-support-roadmap.html
189
+ [ g-c-j ] : http://github.com/googleapis/google-cloud-java
0 commit comments