The new version 2.0 release comes in 3 flavors:
- com.android.tools:desugar_jdk_libs_nio:2.0.2 – the nio version includes all the desugaring available including the java.nio, java.time, stream, and functions APIs.
- com.android.tools:desugar_jdk_libs:2.0.2 – the default version includes desugaring for the java.time, stream, and functions APIs. It’s similar to version 1.x API desugaring already available, but updated with APIs added up to Android 13.
- com.android.tools:desugar_jdk_libs_minimal:2.0.2 – the minimal version includes only the java.util.function package and bug fixes on concurrent collections. It’s designed for minimal code size overhead.
Opting into more desugaring features will lead to a larger impact on your app’s code size. The minimal specification has, as its name indicates, a minimal impact on the code size of the app. The nio specification has the most impact.
The new java.nio APIs
The new java.nio APIs supported in API desugaring include:
- All the classes and APIs in java.nio.file such as BasicFileAttributes, file manipulation, or usage of java.nio.file.Path.
- Some extensions of java.nio.channels, such as the FileChannel#open methods.
- A few utility methods such as File#toPath.
The following code snippet illustrates how you can now use the new java.nio APIs on all devices, including devices running Android 7 and lower, through the methods of kotlin.io.path which depend on java.nio.file.Files. A temp file can be created, written into, read, and its basic attributes and its existence can be queried using the new java.nio APIs.
import android.util.Log |
// Resulting logcat output. |
A few features however cannot be emulated for devices running Android 7 and lower and instead throw an instance of UnsupportedOperationException or return null. They still work on devices running Android 8 or higher, so existing code guarded by an API level check should work as it used to. See the complete list of APIs available and the known limitations.
The code has been extensively tested, but we are looking for additional inputs from app developers.
Please try out the new version of API desugaring, and let us know how it worked for you!
For additional background see the post Support for newer Java language APIs from when API desugaring was introduced.
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
;Resize=(1180) "WATCH | South Africa agrees to rescue illegal miners sealed for weeks underground")
Discussion about this post