Instalar o Microsoft Build do OpenJDK

  • Artigo

Este artigo descreve como instalar o Microsoft Build do OpenJDK. Para obter os arquivos mencionados neste artigo, confira Baixar o Microsoft Build do OpenJDK.

Pacotes ZIP e TAR.GZ

Para Windows, Linux e macOS, produzimos pacotes ZIP (Windows) e TAR.GZ (Linux/macOS). Para instalar, extraia um destes pacotes em uma pasta de sua escolha e defina a variável de ambiente JAVA_HOME para essa pasta.

Como alternativa, você pode usar instaladores nativos para o sistema operacional de sua escolha, conforme descrito na próxima seção.

Instaladores nativos

Para o Windows, produzimos um instalador MSI com uma interface gráfica. Para macOS, produzimos um instalador PKG com recursos semelhantes. Esses instaladores disponibilizarão automaticamente as ferramentas do JDK em seu PATH.

Para Linux, produzimos pacotes DEB e RPM a serem usados com apt e rpm.

As seções a seguir fornecem instruções para esses instaladores.

Instalar no Windows

Para instalar em qualquer versão do Windows, você pode usar os pacotes MSI ou o pacote ZIP. Se você estiver no Windows 10 ou posterior, poderá usar o Gerenciador de Pacotes do Windows no Terminal do Windows.

Instalar no Windows via MSI

O instalador MSI fornece um método de instalação gráfico e somente console. Se você clicar duas vezes no arquivo MSI, ele iniciará o instalador de aplicativos do Windows tradicional, no qual você poderá seguir as instruções na tela.

Para implantação em larga escala, você pode instalar o MSI na linha de comando usando as seguintes etapas:

  1. Baixe o arquivo .msi. Para obter mais informações, confira Baixar o Microsoft Build do OpenJDK.

  2. Escolha os recursos que você deseja instalar na tabela a seguir:

    Recurso Descrição
    FeatureMain Instalação principal (PADRÃO)
    FeatureEnvironment Atualize a variável de ambiente PATH. (PADRÃO)
    FeatureJarFileRunWith Associe arquivos .jar a aplicativos Java. (PADRÃO)
    FeatureJavaHome Atualize a variável de ambiente JAVA_HOME.
    FeatureOracleJavaSoft Atualiza as chaves do Registro HKLM\SOFTWARE\JavaSoft\.

    Observação

    Você pode usar FeatureOracleJavaSoft para impedir a inicialização do Oracle Java do PATH quando o Microsoft Build do OpenJDK for desinstalado. Reinstale o Oracle Java se precisar restaurar as chaves do Registro Oracle.

    Você pode usar parâmetros opcionais que agrupam alguns dos recursos, conforme mostrado no exemplo a seguir:

    Parâmetro Recursos
    INSTALLLEVEL=1 FeatureMain,FeatureEnvironment,FeatureJarFileRunWith

  3. Execute o comando msiexec na estação de trabalho de destino. Use os recursos selecionados, conforme mostrado no exemplo a seguir.

    msiexec /i <package>.msi ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith,FeatureJavaHome INSTALLDIR="c:\Program Files\Microsoft\" /quiet

    Observação

    Você deve usar INSTALLDIR com FeatureMain.

    Este exemplo instala silenciosamente o Microsoft Build do OpenJDK, atualiza o PATH, associa os arquivos .jar com aplicativos Java e define JAVA_HOME.

Instalar no Windows com o gerenciador de pacotes do Windows (winget)

Para instalar com o Gerenciador de Pacotes do Windows, primeiro instale o widget e, em seguida, abra o Terminal do Windows.

Em seguida, use o seguinte comando para pesquisar o Microsoft Build de pacotes OpenJDK:

winget search Microsoft.OpenJDK

Você verá uma saída semelhante ao seguinte:

Name                           Id                    Version
--------------------------------------------------------------
Microsoft Build of OpenJDK 21  Microsoft.OpenJDK.21  21.0.0

Agora você pode instalar o pacote fazendo referência ao Id mostrado acima, usando o seguinte comando:

winget install Microsoft.OpenJDK.21

Este comando produz uma saída semelhante à seguinte:

Found Microsoft Build of OpenJDK 21 [Microsoft.OpenJDK.21]
This application is licensed to you by its owner.
Microsoft is not responsible for, nor does it grant any licences to, third-party packages.
Downloading https://aka.ms/download-jdk/microsoft-jdk-21.0.0-windows-x64.msi
  ██████████████████████████████   160 MB /  160 MB
Successfully verified installer hash
Starting package install...
Successfully installed

Instalar no macOS

Os pacotes para macOS estão disponíveis por meio do Homebrew ou como downloads autônomos em formato PKG ou TAR.GZ.

Para instalar a versão mais recente com o Homebrew:

brew install --cask microsoft-openjdk

Este comando produz uma saída semelhante à seguinte:

==> Downloading https://aka.ms/download-jdk/microsoft-jdk-21.0.0-macos-x64.pkg
Already downloaded: /Users/foobar/Library/Caches/Homebrew/downloads/c3df619c6411aa15151d0306a6a0f9760ff7ab0b54d0b00daade382500369c81--microsoft-jdk-21.0.0-macos-x64.pkg
==> Installing Cask microsoft-openjdk
==> Running installer for microsoft-openjdk; your password may be necessary.
Package installers may write to any location; options such as `--appdir` are ignored.
Password:
installer: Package name is Microsoft Build of OpenJDK
installer: Installing at base path /
installer: The install was successful.
🍺  microsoft-openjdk was successfully installed!

Observação

O pacote microsoft-openjdk aponta para a versão mais recente do Microsoft Build do OpenJDK.

Para instalar outras versões principais com o Homebrew:

brew install --cask microsoft-openjdk@11
# OR
brew install --cask microsoft-openjdk@17
# OR
brew install --cask microsoft-openjdk@21

Para instalar no macOS com o pacote TAR.GZ, basta extrair o arquivo em um local. O JDK estará dentro de <location>/jdk-<version>/Contents/Home.

Para instalar usando o instalador PKG, abra o instalador e siga as instruções. Por padrão, o JDK será instalado em /Library/Java/JavaVirtualMachines/microsoft-21.jdk/Contents/Home.

Desinstalar no macOS

Para desinstalar o Microsoft Build do OpenJDK instalado por meio de Homebrew ou PKG, use os seguintes comandos:

sudo rm -rf /Library/Java/JavaVirtualMachines/microsoft-21.jdk
sudo pkgutil --forget com.microsoft.21.jdk

Para desinstalar o pacote instalado por meio do pacote TAR.GZ, basta excluir a pasta.

Instalação no Ubuntu

Para instalar nas versões Ubuntu 18.04, 20.04 e 22.04 LTS, abra um terminal e execute os seguintes comandos:

# Valid values are only '18.04', '20.04', and '22.04'
# For other versions of Ubuntu, please use the tar.gz package
ubuntu_release=`lsb_release -rs`
wget https://packages.microsoft.com/config/ubuntu/${ubuntu_release}/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

Depois que o repositório for adicionado, instale o Microsoft Build do OpenJDK executando os seguintes comandos:

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install msopenjdk-21

Observação

Talvez seja necessário atualizar sua seleção de JDK padrão; confira aqui para obter detalhes.

Instalar no Debian

Debian 10 - 12

Aviso

A partir de julho de 2024, o suporte oficial ao Debian 10 terminou. Todos os JDKs publicados até julho de 2024 permanecem disponíveis, mas não receberão atualizações nem suporte contínuos

Para instalar no Debian 10 a 12, abra um terminal e execute os seguintes comandos:

sudo apt update
sudo apt install wget lsb-release -y
wget https://packages.microsoft.com/config/debian/$(lsb_release -rs)/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

Depois que o repositório for adicionado, execute os seguintes comandos:

sudo apt update
sudo apt install msopenjdk-21

Observação

Talvez seja necessário atualizar sua seleção de JDK padrão; confira aqui para obter detalhes.

Debian 9

Aviso

Desde julho de 2024, o suporte oficial ao Debian 9 terminou. Todos os JDKs publicados até julho de 2024 permanecem disponíveis, mas não receberão atualizações nem suporte contínuos

Para instalar no Debian 9, abra um terminal e execute os seguintes comandos:

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
wget -q https://packages.microsoft.com/config/debian/9/prod.list -O /etc/apt/sources.list.d/microsoft-prod.list

Depois que o repositório for adicionado, execute os seguintes comandos:

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install msopenjdk-21

Observação

Talvez seja necessário atualizar sua seleção de JDK padrão; confira aqui para obter detalhes.

Instalar no CentOS 7 (RPM)

Para instalar no CentOS 7, abra um terminal e execute o seguinte comando:

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm

Depois que o repositório for adicionado, execute o seguinte comando:

sudo yum install msopenjdk-21

Observação

Os pacotes RPM para msopenjdk-21 podem não ser atualizados automaticamente para a versão secundária mais recente. Para verificar as versões disponíveis/mais recentes, execute yum -v list msopenjdk-21. Em seguida, execute yum install msopenjdk-21-<version> para forçar a atualização para a versão especificada. Exemplo: yum install msopenjdk-21-21.0.0-1

Instalar no Alpine (TAR.GZ)

Para instalar no Alpine, basta baixar um pacote tar.gz para Alpine (confira a página de download) e extrair a pasta.

Observação

O Alpine só tem suporte para JDK 11 e JDK 17. Não daremos mais suporte ao alpine para JDK21 e posteriores.

Alterar o JDK padrão no Linux

Se você tiver várias versões do OpenJDK instaladas em seu sistema, use o seguinte comando para definir o Microsoft Build do OpenJDK como o padrão:

Para Debian/Ubuntu:

sudo update-java-alternatives --set msopenjdk-21-amd64

Para CentOS, você pode usar o comando alternative.

Fornecer comentários sobre o Build do OpenJDK da Microsoft

Envie-nos seus comentários, pensamentos e ideias para nos ajudar a melhorar o Microsoft Build do OpenJDK. Visite nossa página de discussões do OpenJDK no GitHub para nos enviar seus comentários.

Java e OpenJDK são marcas ou marcas registradas da Oracle e/ou de suas afiliadas.