@@ -71,10 +71,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
|
71 | 71 |
|
72 | 72 | Service Usage uses gRPC for the transport layer.
|
73 | 73 |
|
74 |
| -## Java Versions |
| 74 | +## Supported Java Versions |
75 | 75 |
|
76 | 76 | Java 7 or above is required for using this client.
|
77 | 77 |
|
| 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 | + |
78 | 118 | ## Versioning
|
79 | 119 |
|
80 | 120 |
|
@@ -135,3 +175,9 @@ Java is a registered trademark of Oracle and/or its affiliates.
|
135 | 175 | [enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=serviceusage.googleapis.com
|
136 | 176 | [libraries-bom]: https://.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
|
137 | 177 | [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