Merge branch '18732-crunch-run-log-uids'
[arvados.git] / doc / sdk / java-v2 / index.html.textile.liquid
index ee7e6cdb45f4147d64c3675437f56a1ac0467ca4..ad9f0e1a9d1a7e3679f8409a478f47e67faa5d0e 100644 (file)
@@ -10,13 +10,33 @@ Copyright (C) The Arvados Authors. All rights reserved.
 SPDX-License-Identifier: CC-BY-SA-3.0
 {% endcomment %}
 
-The Arvados Java SDK v2 provides a high level API for working with Arvados resources. It is packaged as a single JAR named
-arvados-java-<version>.jar, e.g. arvados-java-2.0.0.jar
-which can be included in your project using Gradle, Maven, or by hand.
+The Arvados Java SDK v2 provides a high level API for working with Arvados resources.
 
 h2. Using the SDK
 
-FIXME - Add intro text here
+The SDK is packaged as a JAR named @arvados-java-<version>.jar@, which is published to Maven Central and can be included using Maven, Gradle, or by hand.
+
+Here is an example @build.gradle@ file that uses the Arvados java sdk:
+
+<pre>
+apply plugin: 'application'
+apply plugin: 'java-library'
+apply plugin: 'maven'
+
+repositories {
+    mavenCentral()
+}
+
+application {
+    mainClassName = "org.arvados.example.CollectionExample"
+}
+
+dependencies {
+    api 'org.arvados:arvados-java-sdk:0.1.1'
+}
+</pre>
+
+See "Java SDK Examples":example.html to get started using the SDK.
 
 h3. Logging
 
@@ -111,17 +131,16 @@ See "Javadoc":javadoc.html
 h2. Building the Arvados SDK
 
 Dependencies:
-* JDK for Java 8 or later https://www.oracle.com/technetwork/java/javase/downloads/index.html
-* Gradle https://gradle.org/install/
+* JDK for Java 8 or later "https://www.oracle.com/technetwork/java/javase/downloads/index.html":https://www.oracle.com/technetwork/java/javase/downloads/index.html
+* Gradle "https://gradle.org/install/":https://gradle.org/install/
 
 
 <notextile>
 <pre>
-$ <code class="userinput">git clone https://github.com/curoverse/arvados.git</code>
+$ <code class="userinput">git clone https://github.com/arvados/arvados.git</code>
 $ <code class="userinput">cd arvados/sdk/java-v2</code>
-$ <code class="userinput">./gradlew test</code>
-$ <code class="userinput">./gradlew jar</code>
+$ <code class="userinput">gradle test</code>
+$ <code class="userinput">gradle jar -Pversion=0.1.1</code>
 </pre>
-This will build the SDK and run all unit tests, then generate an Arvados Java sdk jar file in build/libs/arvados-java-2.0.0.jar
+This will build the SDK and run all unit tests, then generate an Arvados Java sdk jar file in build/libs/arvados-java-0.1.1.jar
 </notextile>
-