with the following features, which you can deselect, if necessary:

• Add the installation to the PATH environment variable
• Associate .jar files with Java applications

Additional features can be selected by clicking on the directory tree where you see a check mark (x). These features include:

• Updating the JAVA_HOME environment variable
• Installing IcedTea-Web (AdoptOpenJDK 8 only)
• Associate .jnlp files with the IcedTea-Web application (AdoptOpenJDK 8 only)

4. When you have chosen the features that you want to install, click Next.

5. Click Install to begin the installation.

6. When the installation is finished, click Finish to close the program.

Command-line installation

A silent installation allows you to install the Windows package with pre-selected features without user interaction, which can be useful for widescale deployment. Follow these steps:

2. Choose the features that you want to install, which are shown in the following table:

Note: FeatureOracleJavaSoft can be used to prevent Oracle Java launching from PATH when AdoptOpenJDK is uninstalled. Reinstall Oracle Java if you need to restore the Oracle registry keys.

Optional parameters can be used that group some of the features together:

3. Run the command on the target workstation.

The following example silently installs AdoptOpenJDK, updates the PATH, associates .jar files with Java applications and defines JAVA_HOME:

Note: You must use INSTALLDIR with FeatureMain.

The following example silently installs all the features for INSTALLLEVEL=1:

If you want to launch an interactive installation in another language you can use the Windows installer TRANSFORMS option to set your language choice. For example, to set the UI language to German, use code 1031, which must be preceded by a :.

For a list of supported codes, see the Language list.

Reinstalling or upgrading

To reinstall AdoptOpenJDK in silent mode with default features, run the following command:

If you want to upgrade AdoptOpenJDK in silent mode, run the following command:

• a: Force all files to be installed regardless of checksum or version
• m: Rewrite all required registry entries from the Registry Table that go to the HKEY_LOCAL_MACHINE
• o: Reinstall if the file is missing or is an older version
• u: Rewrite all required registry entries from the Registry Table that go to the HKEY_CURRENT_USER or HKEY_USERS
• s: Reinstall all shortcuts and re-cache all icons overwriting any existing shortcuts or icons

Note: REINSTALL=ALL automatically sets REINSTALLMODE=omus

Upgrade limitation:

Upgrading .msi files works only for the first 3 digits of the build number due to an MSI limitation:

• Upgrading 8.0.2.1 to 8.0.3.1 works.
• Upgrading 8.0.2.1 to 8.0.2.2 does not work. Uninstall the previous .msi and install the new one.
• Upgrading 8.0.2.1 to 8.1.2.1 works.
• Upgrading 8.0.2.1 to 11.0.2.1 does not work. AdoptOpenJDK does not provide upgrades for major versions. Either keep both installations or uninstall the older one.

Reference reading

macOS PKG installer packages

AdoptOpenJDK macOS installer packages are available as standard .pkg files, which can be run with an interactive user interface or run silently from the Terminal command line.

GUI installation

Instructions for running an interactive installation using the macOS PKG installer.

2. Navigate to the folder that contains the file and open it to launch the installation program or drag the icon to your Application folder.

3. The Introduction screen indicates the target location for the installation, which you can change later in the install process. Click Continue.

4. Read the license, click Continue and accept the license if you are happy with the terms.

5. Change the target location for the installation. Click Install to complete the installation.

Command-line installation

A silent installation allows you to install the macOS package without user interaction, which can be useful for widescale deployment. You must have administrator privileges. Follow these steps:

2. Launch the Terminal app (terminal.app).

3. Run the following command:

4. Enter the Administrator password.

5. AdoptOpenJDK installs to /Library/Java/JavaVirtualMachines/AdoptOpenJDK- . /

Linux RPM and DEB installer packages

AdoptOpenJDK RPM and DEB packages are available for installing on your favourite Linux distribution.

Deb installation on Debian or Ubuntu

You need the codename of your Debian or Ubuntu version. It is usually recorded in /etc/os-release and can be extracted on Debian by running cat /etc/os-release | grep VERSION_CODENAME | cut -d = -f 2 and on Ubuntu by running cat /etc/os-release | grep UBUNTU_CODENAME | cut -d = -f 2 .

1. Ensure the necessary packages are present:
2. Import the AdoptOpenJDK GPG key:
3. Configure AdoptOpenJDK's apt repository by replacing the values in angle brackets:
4. Refresh the package indexes:
5. To see which variants of AdoptOpenJDK are available, run
6. To install a variant of AdoptOpenJDK, run apt-get install

Deb installation on Raspberry Pi OS, Linux Mint and other Debian-based distributions

Raspberry Pi OS (formerly known as Raspbian), Linux Mint and other Debian- and Ubuntu-based distributions are usually based on a specific Debian or Ubuntu release. For example, Linux Mint 20.04 (Ulyanna) is based on Ubuntu 20.04 (Focal Fossa), Raspberry Pi OS 10 is based on Debian GNU/Linux 10 (Buster). Because AdoptOpenJDK only offers repositories for Debian and Ubuntu, you need to find out which Debian or Ubuntu version your distribution is based on. This is usually recorded in /etc/os-release and can usually be extracted on Debian-based distributions by running cat /etc/os-release | grep VERSION_CODENAME | cut -d = -f 2 and on Ubuntu-based distributions by running cat /etc/os-release | grep UBUNTU_CODENAME | cut -d = -f 2 .

1. Ensure the necessary packages are present:
2. Import the AdoptOpenJDK GPG key:
3. Configure AdoptOpenJDK's apt repository by replacing the values in angle brackets:
4. Refresh the package indexes:
5. To see which variants of AdoptOpenJDK are available, run
6. To install a variant of AdoptOpenJDK, run apt-get install

RPM installation

RPM packages are maintained in artifactory for various Linux distributions. For a full list (with artifactory baseurl values), see Supported RPM versions.

RPM installation on Centos, RHEL, or Fedora

The following steps describe how to install an RPM package for Centos. To install an RPM for RHEL or Fedora update the baseurl value accordingly.

1. Add the appropriate RPM repository to your /etc/yum.repos.d/adoptopenjdk.repo file, by running the following command:

2. Install your choice of OpenJDK. For example, to install AdoptOpenJDK version 8 with OpenJ9, run:

RPM installation on openSUSE or SLES

The following steps describe how to install an RPM package on openSUSE v15. To install an RPM for SLES, or to install a different version of openSUSE, switch the baseurl value.

1. Add the appropriate RPM repository to your /etc/yum.repos.d/adoptopenjdk.repo file, by running the following command:

2. Install your choice of OpenJDK. For example, to install AdoptOpenJDK version 8 with OpenJ9, run:

Дистрибутив OpenJDK от Майкрософт для разработки мобильных приложений Microsoft's Mobile OpenJDK Distribution

В этом руководстве описываются шаги по переходу на внутренний дистрибутив OpenJDK. Этот дистрибутив предназначен для разработки мобильных приложений. This guide describes the steps for switching to an internal distribution of OpenJDK. This distribution is intended for mobile development.

Обзор Overview

Начиная с версий Visual Studio 15.9 и Visual Studio для Mac 7.7 решение "Инструменты Visual Studio для Xamarin" более не использует пакет JDK от Oracle и перешло на облегченную версию OpenJDK, предназначенную исключительно для разработки на Android. 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. Это обязательная миграция, так как Oracle прекращает поддержку коммерческих дистрибутивов JDK 8 в 2019 г., а JDK 8 является обязательной зависимостью для разработки приложений Android. 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:

У вас всегда будет версия OpenJDK, которая подходит для разработки приложений Android. You will always have an OpenJDK version that works for Android development.

Скачивание JDK 9 или более поздней версии от Oracle не повлияет на интерфейс разработки. 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.

Если вы хотите быстрее перейти на обновленную версию, доступны сборки OpenJDK от Майкрософт для разработки мобильных приложений, которые вы можете опробовать на Windows и Mac. 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. Процесс установки описан ниже. Вернуться на JDK от Oracle можно в любое время. The setup process is described below, and you can revert back to the Oracle JDK at any time.

Скачать Download

Дистрибутив OpenJDK для мобильных приложений установится автоматически, если вы выберете пакеты SDK для Android в Visual Studio Installer в Windows. The mobile OpenJDK distribution is automatically installed for you if you select the Android SDK packages in the Visual Studio installer on Windows.

На Mac пакет OpenJDK для мобильных приложений будет установлен в рамках рабочей нагрузки Android для новых установок. On Mac, the mobile OpenJDK will be installed for you as part of the Android workload for new installs. Существующие пользователи Visual Studio для Mac получат приглашение установить его в составе обновления. For existing Visual Studio for Mac users, you will be prompted to install it as part of your update. Среда IDE предложит вам перейти на новый пакет JDK и станет использовать его после перезапуска. The IDE will prompt you to move to the new JDK, and will switch to using it at the next restart.

Устранение неполадок Troubleshooting

Если возникли проблемы с установкой на Mac или Windows, вы можете выполнить установку вручную. If you encounter issues with the setup on Mac or Windows, you can take the following steps for manual setup:

Для этого проверьте, установлен ли пакет OpenJDK на компьютере в правильном расположении: Check if OpenJDK is installed on the machine in the correct location:

• Mac — $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_1.8.0.xMac – $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_1.8.0.x
• Windows — C:\Program Files\Android\jdk\microsoft_dist_openjdk_1.8.0.xWindows – C:\Program Files\Android\jdk\microsoft_dist_openjdk_1.8.0.x

Укажите в IDE новый пакет JDK: Point the IDE to the new JDK:

• Mac — щелкните Tools > SDK Manager > Locations (Инструменты > Диспетчер пакетов SDK > Расположения) и в поле Java SDK (JDK) Location (Расположение пакета SDK для Java) укажите полный путь установки OpenJDK. Mac – Click Tools > SDK Manager > Locations and change the Java SDK (JDK) Location to the full path of the OpenJDK installation. В следующем примере указан такой путь: $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_1.8.0.9. У вас может быть установлена более новая версия. In the following example, this path is set to $HOME/Library/Developer/Xamarin/jdk/microsoft_dist_openjdk_1.8.0.9 but your version may be newer.

• Windows — щелкните Инструменты > Параметры > Xamarin > Параметры Android и в поле Расположение пакета Java Development Kit укажите полный путь установки OpenJDK. Windows – Click Tools > Options > Xamarin > Android Settings and change the Java Development Kit Location to the full path of the OpenJDK installation. В следующем примере указан такой путь: C:\Program Files\Android\jdk\microsoft_dist_openjdk_1.8.0.9. У вас может быть установлена более новая версия. In the following example, this path is set to C:\Program Files\Android\jdk\microsoft_dist_openjdk_1.8.0.9, but your version may be newer:

Известные проблемы Known Issues

Не удалось установить пакет "OpenJDKV1.RegKey,version=1.8.0.25,chip=x64". Package 'OpenJDKV1.RegKey,version=1.8.0.25,chip=x64' failed to install

Возможно, возникла проблема в некоторых корпоративных средах. This may be an issue in some corporate environments. Пакет OpenJDK уже установлен на компьютере. Следуйте шагам по устранению неполадок выше, чтобы указать в IDE правильное расположение. 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.

Сводка Summary

В этой статье вы узнали, как настроить в IDE использование дистрибутива OpenJDK от Майкрософт для разработки мобильных приложений и как устранять неполадки. 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.