Partilhar via


Instale o Microsoft Build do OpenJDK

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

Pacotes ZIP e TAR.GZ

Para Windows, Linux e macOS, produzimos os pacotes ZIP (Windows) e TAR.GZ (Linux/macOS). Para instalar, extraia um desses pacotes em uma pasta de sua escolha e, em seguida, defina a JAVA_HOME variável de ambiente 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. Estes instaladores disponibilizam automaticamente as ferramentas do JDK (Java Development Kit) no seu PATH.

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

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

Instalar em Windows

Para instalar em qualquer versão de Windows, pode usar o instalador EXE ou o pacote ZIP. No Windows dia 10 ou posterior, também é possível utilizar o Gestor de PacotesWindows a partir do seu Windows Terminal.

Observação

Deves usar apenas um método de instalação (EXE, MSI ou ZIP) de cada vez para cada versão do JDK. Se instalou anteriormente uma versão JDK LTS (Long Term Support) usando um método (exemplo: MSI) e pretende atualizá-la por outro método (exemplo: EXE), deve primeiro desinstalar o JDK existente antes de avançar com a nova instalação.

Instalar em Windows via EXE

O EXE (Windows executável) fornece tanto um método gráfico como um método de instalação exclusivo para consola. Se você clicar duas vezes no arquivo do instalador, ele inicia o instalador do aplicativo tradicional Windows , onde você pode 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. Descarregue o .exe ficheiro. Para obter mais informações, consulte Baixar o Microsoft Build do OpenJDK.

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

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

    Observação

    Você pode usar FeatureOracleJavaSoft para impedir que o Oracle Java seja iniciado a partir do PATH quando o Microsoft Build do OpenJDK for desinstalado. Reinstale o Oracle Java se precisar restaurar as chaves do Registro Oracle.

  3. Executa o ficheiro EXE a partir da linha de comandos. 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 apenas 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.

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

Instale em Windows através de MSI herdado.

Se tiver problemas com o instalador EXE no JDK 11, JDK 17 ou JDK 21, pode desinstalar o EXE e usar o MSI (Microsoft Installer) legado para um método gráfico semelhante e só para consola. Se você clicar duas vezes no arquivo do instalador, ele inicia o instalador do aplicativo tradicional Windows , onde você pode seguir as instruções na tela.

Para uma implementação em larga escala, pode instalar o MSI na linha de comandos usando os seguintes passos:

  1. Descarregue o .msi ficheiro. Para obter mais informações, consulte Baixar o Microsoft Build do OpenJDK.

  2. Escolha as características que pretende instalar a partir da tabela na etapa 2 de Instalar em Windows via EXE

    Observação

    FeatureMain é uma opção única e padrão para o MSI que indica ao instalador que deve executar a instalação principal.

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

    Parâmetro Caraterísticas
    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

    Deves utilizar INSTALLDIR com FeatureMain.

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

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

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

Em seguida, utilize o seguinte comando para procurar pelos pacotes Microsoft Build of 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

Este 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 através de Homebrew ou como downloads autónomos nos formatos PKG (instalador de pacotes macOS) ou TAR.GZ.

Para instalar a versão mais recente com Homebrew:

brew install --cask microsoft-openjdk

Este 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, extrair o arquivo para o local desejado. 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 através do 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. GZ, exclua a pasta de instalação.

Instalar 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 JDK padrão. Veja aqui os detalhes.

Instalar no Debian

Debian 10 - 12

Advertência

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 JDK padrão. Veja aqui os detalhes.

Debian 9

Advertência

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 JDK padrão. Veja aqui os 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

Os pacotes RPM para msopenjdk-25 podem não ser atualizados automaticamente para a versão secundária mais recente. Para verificar as 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 em Alpine (TAR.GZ)

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

Observação

Alpine é suportado apenas para JDK 11 e JDK 17. Não suportamos Alpine para 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 padrão:

Para Debian/Ubuntu:

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

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

Forneça comentários sobre o Microsoft Build do OpenJDK

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 comerciais ou marcas comerciais registadas da Oracle e/ou das suas afiliadas.