Compartilhar via

Instalar o Microsoft Build do OpenJDK

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 seu sistema operacional de escolha, conforme descrito na próxima seção.

Instaladores nativos

Para Windows, produzimos um instalador EXE com uma interface gráfica. Para macOS, produzimos um instalador PKG com recursos semelhantes. Esses instaladores tornam automaticamente disponíveis as ferramentas do JDK (Java Development Kit) em sua 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 de Windows, você pode usar o instalador EXE ou o pacote ZIP. No dia Windows 10 ou posterior, você também pode usar o Windows Gerenciador de Pacotes do seu terminal Windows.

Observação

Você deve usar apenas um método de instalação (EXE, MSI ou ZIP) por vez para cada versão do JDK. Se você instalou anteriormente uma determinada versão do JDK LTS (Suporte a Longo Prazo) usando um método (exemplo: MSI) e deseja atualizá-lo usando um método diferente (exemplo: EXE), primeiro desinstale o JDK existente antes de prosseguir com a nova instalação.

Instalar no Windows via EXE

O EXE (Windows executável) fornece métodos de instalação tanto gráfico quanto somente para console. Se você clicar duas vezes no arquivo do instalador, ele iniciará o instalador de aplicativo tradicional Windows , no qual você poderá seguir as instruções na tela.

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

  1. Baixe o .exe arquivo. 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
    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 que o Java da Oracle seja iniciado pelo PATH quando a versão da Microsoft do OpenJDK for desinstalada. Reinstale o Oracle Java se precisar restaurar as chaves do Registro Oracle.

  3. Execute o arquivo EXE na linha de comando. Use os recursos selecionados, conforme mostrado no exemplo a seguir.

    .\<package>.exe /SILENT /SUPPRESSMSGBOXES /ALLUSERS /TASKS="FeatureEnvironment,FeatureJarFileRunWith" /DIR="C:\Program Files\Microsoft\"

    Observação

    Se estiver instalando somente para o usuário atual, use o sinalizador /CURRENTUSER em vez de /ALLUSERS.

    Para suprimir a tela da barra de progresso da instalação, use o sinalizador /VERYSILENT em vez de /SILENT.

    O sinalizador /DIR é opcional. Se omitido, o dir de instalação padrão será usado com base no modo de instalação: /ALLUSERS ou /CURRENTUSER.

Instale em Windows via MSI legada:

Se você tiver problemas com o instalador EXE no JDK 11, JDK 17 ou JDK 21, poderá desinstalar o EXE e usar o MSI herdado (Microsoft Installer) para um método de instalação semelhante, tanto gráfico quanto somente de console. Se você clicar duas vezes no arquivo do instalador, ele iniciará o instalador de aplicativo tradicional Windows , 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 .msi arquivo. Para obter mais informações, confira Baixar o Microsoft Build do OpenJDK.

  2. Escolha as funcionalidades que você deseja instalar na tabela da etapa 2 da Instalação Windows via EXE

    Observação

    FeatureMain é uma opção exclusiva e padrão para MSI que informa ao instalador para executar a instalação principal

    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 msiexec comando 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 PATH e associa arquivos .jar a aplicativos Java e define JAVA_HOME.

Instalar em Windows com o Gerenciador de Pacotes Windows (winget)

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

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

winget search Microsoft.OpenJDK

A saída resultante é semelhante a:

Name                           Id                    Version
--------------------------------------------------------------
Microsoft Build of OpenJDK 25  Microsoft.OpenJDK.25  25.0.1

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

winget install Microsoft.OpenJDK.25

Esse comando produz uma saída semelhante a:

Found Microsoft Build of OpenJDK 25 [Microsoft.OpenJDK.25]
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-25.0.1-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 nos formatos PKG (instalador de pacote para macOS) ou TAR.GZ.

Para instalar a versão mais recente com Homebrew:

brew install --cask microsoft-openjdk

Esse comando produz uma saída semelhante a:

==> Downloading https://aka.ms/download-jdk/microsoft-jdk-25.0.1-macos-x64.pkg
Already downloaded: /Users/foobar/Library/Caches/Homebrew/downloads/c3df619c6411aa15151d0306a6a0f9760ff7ab0b54d0b00daade382500369c81--microsoft-jdk-25.0.1-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 Homebrew:

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

Para instalar no macOS com o pacote TAR.GZ, extraia o arquivo para o local de sua preferência. O JDK está localizado em <location>/jdk-<version>/Contents/Home.

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

Desinstalar no macOS

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

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

Para desinstalar um pacote instalado usando o TAR. Arquivo GZ, exclua a pasta de instalação.

Instalação no Ubuntu

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

# Valid values are only '18.04', '20.04', '22.04', and '24.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-25

Observação

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

Instalar no Debian

Debian 10 - 12

Aviso

A partir de julho de 2024, o suporte oficial para o Debian 10 acabou. Todos os JDKs publicados até julho de 2024 permanecem disponíveis, mas não receberão atualizações ou 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-25

Observação

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

Debian 9

Aviso

A partir de julho de 2024, o suporte oficial para o Debian 9 acabou. Todos os JDKs publicados até julho de 2024 permanecem disponíveis, mas não receberão atualizações ou 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-25

Observação

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

Instalar no SUSE

openSUSE 15

Para instalar no openSUSE 15, abra um terminal e execute os seguintes comandos:

sudo rpm -Uvh https://packages.microsoft.com/config/opensuse/15/packages-microsoft-prod.rpm
sudo zypper update # Note:  This will prompt you to set the desired trust level for the Microsoft repository and package signing key
sudo zypper install msopenjdk-25

SLES 15

Para instalar no SLES (SUSE Linux Enterprise Server) 15, abra um terminal e execute os seguintes comandos:

sudo rpm -Uvh https://packages.microsoft.com/config/sles/15/packages-microsoft-prod.rpm
sudo zypper update # Note:  This will prompt you to set the desired trust level for the Microsoft repository and package signing key
sudo zypper install msopenjdk-25

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
sudo yum install msopenjdk-25

Observação

Pacotes RPM para msopenjdk-25, os quais podem não ser atualizados automaticamente para a última versão secundária. Para verificar se há versões disponíveis, execute yum -v list msopenjdk-25. Em seguida, execute yum install msopenjdk-25-<version> para forçar uma atualização para a versão especificada. Exemplo: yum install msopenjdk-25-25.0.1-1

Instalar no Alpine (TAR.GZ)

Para instalar no Alpine, baixe um pacote tar.gz para Alpine (consulte a página de download) e extraia o pacote para o local desejado.

Observação

Alpine só há suporte para JDK 11 e JDK 17. Não há suporte Alpine para o JDK 21 e versões 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-25-amd64

Para CentOS, você pode usar o alternatives comando para gerenciar versões do Java.

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.

  • Last updated on