Liberica JDK 12.0.2 Release Notes

The full version string for this binary release of OpenJDK is 12.0.2+12, and the version number is 12.

Liberica JDK 12.0.2

Liberica is a certified, Java SE 12-compliant distribution of OpenJDK 12 which works on server (Linux x86_64, Linux ARM64, Solaris SPARC, Solaris x64, Windows 64), desktop (Windows 64, Windows 32, Mac, Linux x86_64, Linux x86), and embedded devices (Linux x86, Linux ARM64, Linux ARMv7, including Raspberry Pi 2 & 3 (ARMv6 hardfloat). It has the following notable additions:

  • Linux & Windows x86_64 binaries contain experimental support for Shenandoah GC, Linux x86_64 version contains experimental support for ZGC.
  • Linux x86_64, ARMv8 and ARMv7 distributions include a choice of Client VM, Server VM and Minimal VM.
  • Alpine Linux x86_64 version is build with musl support.
  • Windows x86_64, Windows x86, Mac, Linux x86_64 and Linux ARMv7 distributions contain OpenJFX 12.
  • Linux ARMv7 distribution contains Device IO API compiled for Raspberry Pi.

Please refer to the Oracle JDK 12.0.2 release notes for further information on JDK 12 features. This document further outlines the peculiarities of Liberica distribution as compared to Oracle JDK 12 distribution.

Supported Server and Desktop configurations

Liberica is supported on the following OSes:

  • Ubuntu Linux 16.04, 18.04 (x86, x86_64, ARMv8)
  • Debian Linux 8, 9 (x86, x86_64, ARMv8)
  • Red Hat, Oracle Linux and CentOS 7.x (x86, x86_64, ARMv8)
  • Alpine Linux 3.7+
  • SUSE Linux Enterprise 12, 15 and tumbleweed (x86_64, ARMv8)
  • Apple macOS 10.11+
  • Solaris 11.1+ (SPARC and x64)
  • Microsoft Windows 2019, Windows 2016, Windows 2012 R2, Windows 10, Windows 8, Windows 7 (64 and 32 bit)

It is also known to work on other Linux distributions and Windows versions.

Note: The minimum supported Linux kernel version is 2.6.18 and GLIBC version 2.6. LibericaFX works on all supported Ubuntu versions, Red Hat Linux family starting from 7.x and SUSE versions with GTK2 backend.

Supported Embedded configurations

Liberica is tested and certified on Raspberry Pi 2 & 3 running the following OSes:

  • Raspbian OS (armhf)
  • OpenSUSE (armv8)

It is also known to work with Debian (armhf) and Ubuntu (armhf).

Liberica JDK 12.0.2 distribution

Liberica JDK 12.0.2 is distributed as .msi, .zip, .deb, .rpm and .tar.gz packages. Please select the one which is most appropriate for your purposes.

Liberica 12.0.2 introduced all new features supported by OpenJDK 12.

With the introduction of the Jigsaw feature in JDK 9 and Minimal VM it is now possible to create a Runtime that is sufficient to run your application and trim down the size of the Runtime. To generate a Runtime with just the Minimal VM, add --vm=minimal to jlink options.

By default, the Liberica uses Server VM. Server VM and Client VM can be enabled with -server and -client command line options, respectively. In case the deployment requires to minimize the footprint, it may be beneficial to use Minimal VM, which emphasises on a minimal footprint. It has C1 JIT compiler only, Serial GC and no serviceability features.

LibericaFX for the Raspberry Pi

Liberica JDK comes with a bundled LibericaFX implementation, which is based on OpenJFX. The following tables lists Java FX modules status of Liberica distribution

  • Java FX Graphics - works.
  • Java FX Controls - works.
  • Java FX Media - does not work.
  • Java FX Webkit - does not work.

The following pipelines are known to work: EGL, SW (direct framebuffer) and GTK. By default, Liberica tries to use the accelerated EGL pipeline, which requires the presence of EGL libraries. If they are not found, the implementation falls back to software rendering.

Use the following command line options to specify the rendering pipeline:

  • -Dprism.order=sw forces the use of software rendering pipeline.
  • -Dprism.order=es2 forces the use of EGL pipeline and hardware acceleration.
  • -Djavafx.platform=gtk if you would like to launch a LibericaFX application using Liberica from X11.

Please refer to the following wiki for more information.

Device IO API for the Raspberry Pi

Liberica JDK comes with a bundled OpenJDK Device I/O (DIO) API implementation module. DIO provides a Java API for accessing Raspberry PI GPIO pins and for communicating with peripheral devices:

  • General Purpose Input/Output (GPIO).
  • Inter-Integrated Circuit Bus (I2C), Serial Peripheral Interface (SPI).
  • Universal Asynchronous Receiver/Transmitter (UART).

Please refer to the following wiki for more information.

Security Baselines

BellSoft Liberica follows the security baselines for Oracle Java SE. Please refer to the Oracle documentation for a list of issues fixed in a given release.

Known Issues

LibericaFX and EGL on Raspbian

As of 2017, the default location of Broadcom and has changed in Raspbian OS. If you'd like to leverage hardware EGL acceleration available from Broadcom video drivers in LibericaFX while running a recent Raspbian OS, run the following command:

cd /opt/vc/lib
sudo ln -s
sudo ln -s

Issues fixed

Issue Description
JDK-8170494 JNI exception pending in PlainDatagramSocketImpl.c
JDK-8188133 C2: Static field accesses in clinit can trigger deoptimizations
JDK-8205432 Replace the placeholder Japanese era name
JDK-8209901 Canonical file handling
JDK-8210782 Upgrade HarfBuzz to the latest 2.3.1
JDK-8211936 Better String parsing
JDK-8212328 Exceptional throw cases
JDK-8213431 Improve file protocol handling
JDK-8213432 Better copies of CopiesList
JDK-8214235 arm32: assertion in collectedHeap.cpp: attempt to clean empty remainder
JDK-8215367 Better Collection of References
JDK-8215472 (zipfs) Cleanups in implementation classes of jdk.zipfs and tests
JDK-8215982 (tz) Upgrade time-zone data to tzdata2018i
JDK-8216381 More limited privilege usage
JDK-8217563 Improve realm maintenance
JDK-8217647 JFR: recordings on 32-bit systems unreadable
JDK-8217737 Change the milestone to ea for jdk-12.0.2+1 build
JDK-8217737 Change the release version from 12.0.1 to 12.0.2
JDK-8217879 hs_err should print more instructions in hex dump
JDK-8218152 [javac] fails and exits with no error if a bad annotation processor provided
JDK-8218453 More dynamic RMI interactions
JDK-8218469 JSlider display issue with slider for GTKLookAndFeel
JDK-8218473 JOptionPane display issue with GTKLookAndFeel
JDK-8218479 JTextPane display issue with GTKLookAndFeel
JDK-8218781 Localized names for Japanese era Reiwa in COMPAT provider
JDK-8218863 Better endpoint checks
JDK-8218873 Improve JSSE endpoint checking
JDK-8218876 Improve PNG support options
JDK-8219448 split-if update_uses accesses stale idom data
JDK-8219775 Certificate validation improvements
JDK-8220166 Performance regression in deserialization (4-6% in SPECjbb)
JDK-8220495 Update GIFlib library to the 5.1.8
JDK-8220517 Enhanced GIF support
JDK-8220625 tools/javac/classreader/8171132/ failed with "did not see expected error"
JDK-8221345 Better Poly1305 support
JDK-8221437 assert(java_lang_invoke_ResolvedMethodName::vmtarget(resolved_method()) == m()) failed: Should not change after link resolution
JDK-8221518 Normalize normalization
JDK-8221530 Caller sensitive methods not handling caller = null when invoked by JNI code with no java frames on stack
JDK-8221639 [i386] expand_exec_shield_cs_limit workaround is undefined code after JDK-8199717
JDK-8221880 Better customization for Windows RC properties FileDescription and ProductName
JDK-8221924 get(null) on single-entry unmodifiable Map returns null instead of throwing NPE
JDK-8222027 java/util/logging/LogManager/ generates intermittent ClassCastException
JDK-8222078 test/jdk/java/lang/reflect/exeCallerAccessTest/exeCallerAccessTest.c build fails after 8221530
JDK-8222082 Build of test/jdk/java/lang/reflect/exeCallerAccessTest/exeCallerAccessTest.c still failing on Windows
JDK-8222086 CodeCache::UnloadingScope needs to preserve and restore previous IsUnloadingBehavior
JDK-8222111 exeCallerAccessTest.c fails to build: control reaches end of non-void function
JDK-8222136 Remove two Comodo root CA certificates that are expiring
JDK-8222137 Remove T-Systems root CA certificate
JDK-8222262 change milestone to fcs for jdk 12.0.2 build 2 on jdk12.0.2 repos
JDK-8222397 x86_32 tests with UseSHA1Intrinsics SEGV due to garbled registers
JDK-8222403 Shenandoah: Remove ShenandoahAlwaysTrueClosure, use AlwaysTrueClosure instead
JDK-8222410 java/nio/file/attribute/BasicFileAttributeView/UnixSocketFile hangs when "nc" does not accept "-U"
JDK-8222425 Shenandoah: Move commonly used closures to separate files
JDK-8222522 Add configure options for Mac Bundle creation
JDK-8222532 (zipfs) Performance regression when writing ZipFileSystem entries in parallel
JDK-8222678 Improve TLS negotiation
JDK-8222838 Shenandoah: SEGV on accessing cset bitmap for NULL ptr
JDK-8222843 Print Shenandoah cset map addresses in hs_err
JDK-8222930 ConcurrentSkipListMap.clone() shares size variable between original and clone
JDK-8223003 SunMSCAPI keys are not cleaned up
JDK-8223427 [TESTBUG] Disable JTReg Shenandoah tests when Graal is enabled
JDK-8223437 Backout JDK-8219974 Restore static callsite resolution for the current class
JDK-8223446 Shenandoah breaks alignment with some HumongousThreshold values
JDK-8223447 Stabilize gc/shenandoah/TestStringDedupStress test
JDK-8223472 volatile long field corruption on x86_32
JDK-8223499 Remove two DocuSign root certificates that are expiring
JDK-8223555 Cleanups in cacerts tests
JDK-8223570 Shenandoah needs to acquire lock before CLDG::clear_claimed_marks
JDK-8223597 jdk/nio/zipfs/ RuntimeException: CHECK_FAILED! (getAttribute.crc failed 6af4413c vs 0 ...)
JDK-8223651 Build fails with --with-jvm-features=-jfr and --disable-precompiled-headers
JDK-8223759 Shenandoah should allow arbitrarily low initial heap size
JDK-8223762 Shenandoah: overflows in calculations involving heap capacity
JDK-8223767 Shenandoah fails to build on Solaris x86_64
JDK-8223980 Shenandoah: Refactor and fix ObjArrayChunkedTask verification
JDK-8224907 Backout JDK-8209901 from JDK 11u-cpu and 12u-cpu
JDK-8227230 Backout JDK-8215367 from update releases