Microsoft's Mobile OpenJDK Distribution
This guide describes the steps for switching to an internal distribution of OpenJDK. This distribution is intended for mobile development.
Beginning with Visual Studio 15.9 and Visual Studio for Mac 7.7, Visual Studio Tools for Xamarin has moved from Oracle’s JDK to a lightweight version of the OpenJDK that is intended solely for Android development. This is a required migration as Oracle is ending support for commercial distribution of JDK 8 in 2019, and JDK 8 is a required dependency for all Android development.
The benefits of this move are:
You will always have an OpenJDK version that works for Android development.
Downloading Oracle's JDK 9 or greater won’t affect the development experience.
Reduced download size and footprint.
No more issues with 3rd party servers and installers.
If you’d like to move to the improved experience sooner, builds of the Microsoft Mobile OpenJDK distribution are available for you to test on both Windows and Mac. The setup process is described below, and you can revert back to the Oracle JDK at any time.
The mobile OpenJDK distribution is automatically installed for you if you select the Android SDK packages in the Visual Studio installer on Windows.
On Mac, the mobile OpenJDK will be installed for you as part of the Android workload for new installs. For existing Visual Studio for Mac users, you will be prompted to install it as part of your update. The IDE will prompt you to move to the new JDK, and will switch to using it at the next restart.
If you encounter issues with the setup on Mac or Windows, you can take the following steps for manual setup:
Check if OpenJDK is installed on the machine in the correct location:
- Mac – $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_1.8.0.x
- Windows – C:\Program Files\Android\jdk\microsoft_dist_openjdk_1.8.0.x
Point the IDE to the new JDK:
- Mac – Click Tools > SDK Manager > Locations and change the Java SDK (JDK) Location to the full path of the OpenJDK installation. In the following example, this path is set to $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_22.214.171.124 but your version may be newer.
- Windows – Click Tools > Options > Xamarin > Android Settings and change the Java Development Kit Location to the full path of the OpenJDK installation. In the following example, this path is set to C:\Program Files\Android\jdk\microsoft_dist_openjdk_126.96.36.199, but your version may be newer:
Package 'OpenJDKV1.RegKey,version=188.8.131.52,chip=x64' failed to install
This may be an issue in some corporate environments. OpenJDK is already on the machine - follow the troubleshooting steps above to point your IDE to the correct location. You can follow the status of the issues here.
In this article, you learned how to configure your IDE to use Microsoft's Mobile OpenJDK distribution, and how to troubleshoot should you encounter issues.
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.