Project Lanai Early-Access Builds

These builds are intended for developers looking to test and provide feedback on using Project Lanai, which implements a new Java 2D graphics rendering pipeline for macOS. Since this is a macOS-specific project, only macOS builds are provided. Updated EA builds will be provided periodically, usually when there is a sufficient set of important updates since the previous EA.

Warning:

These builds are based upon the latest state of the current in development JDK, and so may contain new features and unresolved bugs unrelated to Project Lanai.

EA 10 Build 17-lanai+3-133 (2021/3/2)

These early-access builds are provided under the GNU General Public License, version 2, with the Classpath Exception.

macOS / x64 tar.gz (sha256) 182769827

macOS / x64	tar.gz (sha256)	182769827

Documentation

Project Lanai JEP: http://openjdk.java.net/jeps/382
Project Lanai Wiki: https://wiki.openjdk.java.net/display/lanai/Main

Notes

This is the last planned EA release of Project Lanai, which is now proposed-to-target to JDK17.
To enable the metal pipeline you must specify -Dsun.java2d.metal=true on the command line. No message will be printed in this case. To receive positive confirmation that metal was enabled capitalise the value as thus : -Dsun.java2d.metal=True eg :
```
java -Dsun.java2d.metal=True MyApp.jar

Metal pipeline enabled on screen <screen id>
    
```
Setting the following two environment variables enables Metal API validation. These have proved useful in locating usage sequences that are incorrect.
```
    export METAL_DEVICE_WRAPPER_TYPE=1
    export MTL_SHADER_VALIDATION=1
    
```
Caution: If this validation finds a problem it deliberately causes a crash. If you test using these flags and find such a crash please report it to us describing how to reproduce it along with any JDK / hotspot error log. Do not use these flags when measuring performance since they cause Metal to run significantly slower.
Known open EA P2 or higher EA issues can be found here :- https://bugs.openjdk.java.net/browse/JDK-8262882?filter=39210

List of fixed bugs since EA 9

Feedback

Please send feedback via e-mail to lanai-dev@openjdk.java.net. To send e-mail to this address you must first subscribe to the mailing list.

Disclaimers

Early-access (EA) functionality might never make it into a general-availability (GA) release.
EA functionality might be changed or removed at any time.
The existence of EA builds does not imply that the functionality being tested will be present in any particular GA release.
The platforms supported and the packaging options available for a GA build might be different than those available for EA builds.
EA builds are not tested to the same level to which Oracle tests GA builds. EA builds are produced for the purpose of gathering feedback. Use for any other purpose is at your own risk.
EA builds might be missing security-vulnerability fixes that are available in GA builds or in other OpenJDK projects.
Oracle does not provide support for EA builds.

International use restrictions

Due to limited intellectual property protection and enforcement in certain countries, the source code may only be distributed to an authorized list of countries. You will not be able to access the source code if you are downloading from a country that is not on this list. We are continuously reviewing this list for addition of other countries.