Updating READMEs and bumping to 1.2.0.

Author: Craigacp

MIGRATING.md

@@ -1,9 +1,10 @@
 # Migrating Between TensorFlow Java Releases
 
-TensorFlow Java is still in an alpha stage, therefore is subject to contain breaking changes between the different releases. This guide explain in detail
-how to migrate your code from a previous version to a new one that includes some changes that are not backward compatible.
+This guide explains in detail how to migrate your code from a pre-1.0 release to a 1.0 or newer release. Post 1.0
+releases have API stability as much as possible, though upstream TensorFlow does remove ops from time to time and
+consequently those ops will be removed from TensorFlow-Java
 
-## Migrating to 1.0.0
+## Migrating to 1.0.0 or newer
 
 TensorFlow-Java 1.0.0 requires Java 11 or later.
 

README.md

@@ -28,7 +28,8 @@ The following describes the layout of the repository and its different artifacts
   * Intended audience: neural network developers
   * For more information: [tensorflow-framework/README.md](tensorflow-framework/README.md)
 
-*Note: The NdArray Library module has now its own [repository](https://github.com/tensorflow/java-ndarray) and has been moved out of TensorFlow Java.*
+* `tensorflow-ndarray`
+  * API for creating and manipulating n-dimensional arrays, can be used independently from TensorFlow.
 
 ## Communication
 
@@ -60,29 +61,30 @@ only binaries for the following are being **supported and distributed** by this
 - `linux-x86_64-gpu`: Linux platforms on Intel/AMD chips with Cuda GPU support
 - `linux-arm64`: Linux platforms on Arm chips
 - `macosx-arm64`: MacOS X platforms on Apple Silicon chips
-- `windows-x86_64`: Windows platforms on Intel/AMD chips (v1.1.0 and earlier)
 
 Binaries for `macosx-x86_64` are available for TF-Java 1.0 series releases and earlier, they were dropped from
-TF-Java 1.1 and newer as they are no longer supported or released by Google.
+TF-Java 1.1 and newer as they are no longer supported or released by Google. Binaries for `windows-x86_64` are available
+for TF-Java 1.1 and earlier, they were dropped for the 1.2 release and newer as the native binaries are no longer supported or
+released by Google.
 
 For example, for building a JAR that uses TensorFlow and is targeted to be deployed only on Linux
 systems with no GPU support, you should add the following dependencies:
 ```xml
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-api</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.0</version>
 </dependency>
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-native</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.0</version>
   <classifier>linux-x86_64</classifier>
 </dependency>
 ```
 Or Gradle:
 ```groovy
-def tfVersion = '1.1.0'
+def tfVersion = '1.2.0'
 implementation "org.tensorflow:tensorflow-core-api:$tfVersion"
 implementation "org.tensorflow:tensorflow-core-native:$tfVersion:linux-x86_64"
 ```
@@ -93,34 +95,33 @@ native dependencies as follows:
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-api</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.0</version>
 </dependency>
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-native</artifactId>
-  <version>1.1.0</version>
-  <classifier>linux-x86_64-gpu</classifier>
+  <version>1.2.0</version>
+  <classifier>linux-arm64</classifier>
 </dependency>
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-native</artifactId>
-  <version>1.1.0</version>
-  <classifier>macosx-arm64</classifier>
+  <version>1.2.0</version>
+  <classifier>linux-x86_64-gpu</classifier>
 </dependency>
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-native</artifactId>
-  <version>1.1.0</version>
-  <classifier>windows-x86_64</classifier>
+  <version>1.2.0</version>
+  <classifier>macosx-arm64</classifier>
 </dependency>
 ```
 Or Gradle:
 ```groovy
-def tfVersion = '1.1.0'
+def tfVersion = '1.2.0'
 implementation "org.tensorflow:tensorflow-core-api:$tfVersion"
 implementation "org.tensorflow:tensorflow-core-native:$tfVersion:linux-x86_64-gpu"
 implementation "org.tensorflow:tensorflow-core-native:$tfVersion:macosx-arm64"
-implementation "org.tensorflow:tensorflow-core-native:$tfVersion:windows-x86_64"
 ```
 
 Only one dependency can be added per platform, meaning that you cannot add native dependencies to both `linux-x86_64` and 
@@ -135,20 +136,20 @@ For Ubuntu 24.04, you can install them with the following command:
 In some cases, it might be preferable to add a single dependency that includes transitively all the artifacts 
 required to run TensorFlow Java on any [supported platforms](README.md#individual-dependencies)
 
-- `tensorflow-core-platform`: Includes `tensorflow-core-api`, plus native artifacts for `linux-x86_64`, `linux-x86_64-arm64`, `macosx-arm64` and `windows-x86_64`
+- `tensorflow-core-platform`: Includes `tensorflow-core-api`, plus native artifacts for `linux-x86_64`, `linux-arm64`, and `macosx-arm64`
 
 For example, to run TensorFlow Java on any CPU platform for which a binary is being distributed by this project, you can 
 simply add this dependency to your application:
 ```xml
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-platform</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.0</version>
 </dependency>
 ```
 Or Gradle:
 ```groovy
-implementation "org.tensorflow:tensorflow-core-platform:1.1.0"
+implementation "org.tensorflow:tensorflow-core-platform:1.2.0"
 ```
 
 Be aware though that the builds of TensorFlow are quite voluminous and including too many native dependencies may
@@ -177,7 +178,7 @@ to add Sonatype OSS repository in your `pom.xml`, like the following
     <dependency>
         <groupId>org.tensorflow</groupId>
         <artifactId>tensorflow-core-platform</artifactId>
-        <version>1.2.0-SNAPSHOT</version>
+        <version>1.3.0-SNAPSHOT</version>
     </dependency>
 </dependencies>
 ```
@@ -192,10 +193,24 @@ repositories {
 
 dependencies {
     // Example of dependency, see section above for more options
-    implementation "org.tensorflow:tensorflow-core-platform:1.2.0-SNAPSHOT"
+    implementation "org.tensorflow:tensorflow-core-platform:1.3.0-SNAPSHOT"
 }
 ```
 
+## TensorFlow native libraries
+
+TensorFlow-Java is built on top of the native TensorFlow library, and uses [JavaCPP](https://github.com/bytedeco/javacpp)
+to call that library which in turn uses the Java Native Interface (JNI). In [Java 24 and newer](https://openjdk.org/jeps/472) 
+uses of JNI trigger a warning of the form:
+```
+WARNING: A restricted method in java.lang.System has been called
+WARNING: java.lang.System::loadLibrary has been called by org.bytedeco.javacpp.Loader in an unnamed module (file:/.../.m2/repository/org/bytedeco/javacpp/1.5.12/javacpp-1.5.12.jar)
+WARNING: Use --enable-native-access=ALL-UNNAMED to avoid a warning for callers in this module
+WARNING: Restricted methods will be blocked in a future release unless native access is enabled
+```
+This is expected, and adding the `--enable-native-access=ALL-UNNAMED` flag to enable JNI will suppress it. In a future
+Java version this warning may be turned into an error and the flag will be required to use TensorFlow-Java.
+
 ## TensorFlow/Java Version Support
 
 This table shows the mapping between TensorFlow, TensorFlow Java and minimum supported Java versions.
@@ -215,7 +230,8 @@ This table shows the mapping between TensorFlow, TensorFlow Java and minimum sup
 | 1.0.0-rc.2              | 2.16.2             | 11                   |
 | 1.0.0                   | 2.16.2             | 11                   |
 | 1.1.0                   | 2.18.0             | 11                   |
-| 1.2.0-SNAPSHOT          | 2.21.0             | 11                   |
+| 1.2.0                   | 2.21.0             | 11                   |
+| 1.3.0-SNAPSHOT          | 2.21.0             | 11                   |
 
 ## How to Contribute?
 

RELEASE.md

@@ -191,7 +191,7 @@ Some things of note:
    ```
 2. In your local copy, checkout the master branch and increase the next snapshot version.
    ```
-   mvn versions:set -DnewVersion=1.1.0-SNAPSHOT
+   mvn versions:set -DnewVersion=1.3.0-SNAPSHOT
    ```
 3. Update the TensorFlow Java version to reflect the new snapshot at the following locations:
     - https://github.com/tensorflow/java/blob/master/docs/install.md?plain=1#L104

docs/docs/index.md

@@ -26,7 +26,7 @@ The following describes the layout of the repository and its different artifacts
   * **Intended audience**: neural network developers.
   * Primary API for building and training neural networks with TensorFlow.
 
-### [ndarray](https://github.com/tensorflow/java-ndarray)
+### [tensorflow-ndarray](https://github.com/tensorflow/java/tree/master/tensorflow-ndarray)
   * **Intended audience**: any developer who needs a Java n-dimensional array implementation, whether or not they use it with TensorFlow.
   * Generic utility library for n-dimensional data I/O operations.
   * Used by TensorFlow but does not depend on TensorFlow.

docs/docs/install.md

@@ -21,9 +21,12 @@ following platforms:
 *   Ubuntu 20.04 or higher; 64-bit, x86
 *   Ubuntu 22.04 or higher; 64-bit, arm
 *   macOS 14 or higher; 64-bit, arm
+
+Tensorflow Java 1.1 and earlier has binaries for:
+
 *   Windows 10 or higher; 64-bit, x86
 
-TensorFlow Java 1.0 series and earlier releases also have binaries for:
+TensorFlow Java 1.0 series and earlier has binaries for:
 
 *   macOS 12 or higher; 64-bit, x86
 
@@ -63,7 +66,7 @@ For example,
 <dependency>
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-core-platform</artifactId>
-  <version>1.1.0</version>
+  <version>1.2.0</version>
 </dependency>
 ```
 
@@ -106,7 +109,7 @@ snapshots repository in your `pom.xml`.
     <dependency>
         <groupId>org.tensorflow</groupId>
         <artifactId>tensorflow-core-platform</artifactId>
-        <version>1.2.0-SNAPSHOT</version>
+        <version>1.3.0-SNAPSHOT</version>
     </dependency>
 </dependencies>
 ```
@@ -123,7 +126,7 @@ repositories {
 }
 
 dependencies {
-    compile group: 'org.tensorflow', name: 'tensorflow-core-platform', version: '1.0.0'
+    compile group: 'org.tensorflow', name: 'tensorflow-core-platform', version: '1.2.0'
 }
 ```
 
@@ -169,7 +172,7 @@ add the TensorFlow dependency to the project's `pom.xml` file:
         <dependency>
             <groupId>org.tensorflow</groupId>
             <artifactId>tensorflow-core-platform</artifactId>
-            <version>1.1.0</version>
+            <version>1.2.0</version>
         </dependency>
     </dependencies>
 </project>

docs/mkdocs.yml

@@ -2,7 +2,7 @@ site_name: ''
 site_url: https://tensorflow.org
 repo_url: https://github.com/tensorflow/java
 site_description: Documentation of TensorFlow Java API and tools.
-copyright: "© TensorFlow Authors 2025"
+copyright: "© TensorFlow Authors 2026"
 
 theme:
   name: material

pom.xml

@@ -7,7 +7,7 @@
 
   <groupId>org.tensorflow</groupId>
   <artifactId>tensorflow-java</artifactId>
-  <version>1.2.0-SNAPSHOT</version>
+  <version>1.2.0</version>
   <packaging>pom</packaging>
 
   <name>TensorFlow Java Parent</name>
@@ -543,7 +543,7 @@
       <configuration>
           <overview>./docs/overview.md</overview>
           <!--<includeDependencySources>true</includeDependencySources>-->
-          <bottom>Copyright 2015, 2025 The TensorFlow Authors. All Rights Reserved.</bottom>
+          <bottom>Copyright 2015, 2026 The TensorFlow Authors. All Rights Reserved.</bottom>
           <additionalJOptions>
               <additionalJOption>-Xmaxerrs</additionalJOption>
               <additionalJOption>65536</additionalJOption>
@@ -554,7 +554,6 @@
           <minmemory>256m</minmemory>
           <maxmemory>2048m</maxmemory>
           <links>
-              <link>https://tensorflow.github.io/java/javadoc-ndarray/v1.0.0/</link>
               <link>https://protobuf.dev/reference/java/api-docs</link>
               <link>https://bytedeco.org/javacpp/apidocs</link>
           </links>

tensorflow-core/pom.xml

@@ -22,7 +22,7 @@
   <parent>
     <groupId>org.tensorflow</groupId>
     <artifactId>tensorflow-java</artifactId>
-    <version>1.2.0-SNAPSHOT</version>
+    <version>1.2.0</version>
   </parent>
   <artifactId>tensorflow-core</artifactId>
   <packaging>pom</packaging>

tensorflow-core/tensorflow-core-api/pom.xml

@@ -6,7 +6,7 @@
   <parent>
     <groupId>org.tensorflow</groupId>
     <artifactId>tensorflow-core</artifactId>
-    <version>1.2.0-SNAPSHOT</version>
+    <version>1.2.0</version>
   </parent>
   <artifactId>tensorflow-core-api</artifactId>
   <packaging>jar</packaging>

tensorflow-core/tensorflow-core-generator/pom.xml

@@ -5,7 +5,7 @@
   <parent>
     <groupId>org.tensorflow</groupId>
     <artifactId>tensorflow-core</artifactId>
-    <version>1.2.0-SNAPSHOT</version>
+    <version>1.2.0</version>
   </parent>
   <artifactId>tensorflow-core-generator</artifactId>
   <packaging>jar</packaging>