@@ -1,4 +1,4 @@
# Cloud Life Sciences Client for Java
# Google Cloud Life Sciences Client for Java
Java idiomatic client for [Cloud Life Sciences ][product-docs].
@@ -20,18 +20,18 @@ If you are using Maven, add this to your pom.xml file:
<dependency >
<groupId >com.google.cloud</groupId >
<artifactId >google-cloud-life-sciences</artifactId >
<version >0.0.0 </version >
<version >0.1.1 </version >
</dependency >
```
If you are using Gradle without BOM, add this to your dependencies
```Groovy
compile 'com.google.cloud:google-cloud-life-sciences:0.0.0 '
compile 'com.google.cloud:google-cloud-life-sciences:0.1.1 '
```
If you are using SBT, add this to your dependencies
```Scala
libraryDependencies + = " com.google.cloud" % " google-cloud-life-sciences" % " 0.0.0 "
libraryDependencies + = " com.google.cloud" % " google-cloud-life-sciences" % " 0.1.1 "
```
## Authentication
@@ -43,7 +43,7 @@ See the [Authentication][authentication] section in the base directory's README.
### Prerequisites
You will need a [Google Cloud Platform Console ][developer-console] project with the Cloud Life Sciences [API enabled ][enable-api].
You will need to [enable billing ][enable-billing] to use Cloud Life Sciences.
You will need to [enable billing ][enable-billing] to use Google Cloud Life Sciences.
[Follow these instructions ][create-project] to get your project set up. You will also need to set up the local development environment by
[installing the Google Cloud SDK ][cloud-sdk] and running the following commands in command line:
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]` .
@@ -56,13 +56,16 @@ to add `google-cloud-life-sciences` as a dependency in your code.
## About Cloud Life Sciences
[Cloud Life Sciences ][product-docs] is an interactive life-sciences environment for Google Cloud
that makes it easy for you to learn and experiment with Google Cloud and manage
your projects and resources from your web browser.
[Cloud Life Sciences ][product-docs] is a suite of services and tools for managing, processing, and transforming life sciences data.
See the [Cloud Life Sciences client library docs ][javadocs] to learn how to
use this Cloud Life Sciences Client Library.
## Troubleshooting
To get help, follow the instructions in the [shared Troubleshooting document ][troubleshooting].
@@ -71,10 +74,50 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
Cloud Life Sciences uses gRPC for the transport layer.
## Java Versions
## Supported Java Versions
Java 7 or above is required for using this client.
Google's Java client libraries,
[Google Cloud Client Libraries ][cloudlibs]
and
[Google Cloud API Libraries ][apilibs],
follow the
[Oracle Java SE support roadmap ][oracle]
(see the Oracle Java SE Product Releases section).
### For new development
In general, new feature development occurs with support for the lowest Java
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
from initial General Availability). If the minimum required JVM for a given
library is changed, it is accompanied by a [semver ][semver] major release.
Java 11 and (in September 2021) Java 17 are the best choices for new
development.
### Keeping production systems current
Google tests its client libraries with all current LTS versions covered by
Oracle's Extended Support (which typically lasts 8 years from initial
General Availability).
#### Legacy support
Google's client libraries support legacy versions of Java runtimes with long
term stable libraries that don't receive feature updates on a best efforts basis
as it may not be possible to backport all patches.
Google provides updates on a best efforts basis to apps that continue to use
Java 7, though apps might need to upgrade to current versions of the library
that supports their JVM.
#### Where to find specific information
The latest versions and the supported Java versions are identified on
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
and on [google-cloud-java ][g-c-j].
## Versioning
@@ -111,7 +154,7 @@ Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
Java is a registered trademark of Oracle and/or its affiliates.
[product-docs ]: https://cloud.google.com/life-sciences/docs/
[product-docs ]: https://cloud.google.com/life-sciences/docs
[javadocs ]: https://googleapis.dev/java/google-cloud-life-sciences/latest/index.html
[kokoro-badge-image-1 ]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-life-sciences/java7.svg
[kokoro-badge-link-1 ]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-life-sciences/java7.html
@@ -135,6 +178,12 @@ Java is a registered trademark of Oracle and/or its affiliates.
[code-of-conduct ]: https://github.com/googleapis/java-life-sciences/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
[license ]: https://github.com/googleapis/java-life-sciences/blob/master/LICENSE
[enable-billing ]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
[enable-api ]: https://console.cloud.google.com/flows/enableapi?apiid=life-sciences .googleapis.com
[enable-api ]: https://console.cloud.google.com/flows/enableapi?apiid=lifesciences .googleapis.com
[libraries-bom ]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
[shell_img ]: https://gstatic.com/cloudssh/images/open-btn.png
[shell_img ]: https://gstatic.com/cloudssh/images/open-btn.png
[semver ]: https://semver.org/
[cloudlibs ]: https://cloud.google.com/apis/docs/client-libraries-explained
[apilibs ]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
[oracle ]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
[g-c-j ]: http://github.com/googleapis/google-cloud-java
