共用方式為


安裝 OpenJDK 的 Microsoft 組建

本文說明如何安裝 OpenJDK Microsoft組建。 若要取得本文所述的檔案,請參閱 下載 openJDK Microsoft組建。

ZIP 和 TAR。GZ 套件

對於 WindowsLinux 和 macOS,我們生產 ZIP (Windows) 和 TAR。GZ (Linux/macOS) 套件。 若要安裝,請在您選擇的資料夾中擷取其中一個套件,然後將環境變數設定 JAVA_HOME 為該資料夾。

或者,您可以針對您選擇的作業系統使用原生安裝程式,如下一節所述。

原生安裝程式

對於 Windows,我們會產生一個帶有圖形介面的 EXE 安裝程式。 針對macOS,我們會產生具有類似功能的 PKG 安裝程式。 這些安裝程式會自動在你的 PATH 中使 Java 開發工具包 (JDK) 工具可用。

針對 Linux,我們會產生 DEB 和 RPM 套件,以搭配 aptrpm使用。

下列各節提供這些安裝程式的指示。

安裝於 Windows

要安裝在任何版本的 Windows上,你可以使用 EXE 安裝程式或 ZIP 套件。 在Windows 10 或更高版本上,您還可以在終端機中使用Windows包管理器

注意

每個 JDK 版本一次只使用一種安裝方式(EXE、MSI 或 ZIP)。 如果你之前用一種方法安裝了某個 JDK LTS(長期支援)版本(例如:MSI),想用其他方法更新它(例如:EXE),你必須先卸載現有的 JDK,才能進行新安裝。

在Windows通過 EXE 安裝

EXE(Windows 可執行檔)同時提供圖形化安裝與僅主控台安裝的方式。 如果雙擊安裝程式檔案,它會啟動傳統的 Windows 應用程式安裝程序,您可以在其中按照螢幕上的指示進行操作。

針對大規模部署,您可以使用下列步驟在命令列上安裝 EXE:

  1. 下載檔案 .exe 。 如需詳細資訊,請參閱 下載 OpenJDK Microsoft組建。

  2. 從下表選擇您要安裝的功能:

    功能 描述
    FeatureEnvironment PATH更新環境變數。 (預設值)
    FeatureJarFileRunWith 將.jar檔案與 Java 應用程式產生關聯。 (預設值)
    FeatureJavaHome JAVA_HOME更新環境變數。
    FeatureOracleJavaSoft 更新登入機碼 HKLM\SOFTWARE\JavaSoft\

    注意

    您可以使用 FeatureOracleJavaSoft 來防止在卸載 Microsoft Build 的 OpenJDK 後 Oracle Java 從 PATH 啟動。 如果您需要還原 Oracle 登錄機碼,請重新安裝 Oracle Java。

  3. 從命令列執行 EXE 檔案。 使用選取的功能,如下列範例所示。

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

    注意

    如果只為目前使用者安裝,請使用旗標 /CURRENTUSER 而不是 /ALLUSERS

    若要隱藏安裝的進度列畫面,請使用旗標 /VERYSILENT ,而不是 /SILENT

    /DIR 旗標是可選的。 如果省略,則會根據安裝模式使用預設安裝 dir: /ALLUSERS/CURRENTUSER

透過傳統的 MSI 在 Windows 上安裝

如果你在 JDK 11、JDK 17 或 JDK 21 上遇到 EXE 安裝程式的問題,可以先卸載 EXE,改用舊版 MSI(Microsoft Installer)來做類似的圖形化且只在控制台安裝。 如果雙擊安裝程式檔案,它會啟動傳統的 Windows 應用程式安裝程序,您可以在其中按照螢幕上的指示進行操作。

若要大規模部署,您可以透過以下步驟在命令列安裝 MSI:

  1. 下載檔案 .msi 。 如需詳細資訊,請參閱 下載 OpenJDK Microsoft組建。

  2. 從「透過 EXE 安裝」Windows步驟 2 的表格中選擇您要安裝的功能

    注意

    FeatureMain 是 MSI 獨特的預設選項,會告訴安裝程式執行核心安裝

    您可以使用選擇性參數,將部分功能分組在一起,如下列範例所示:

    參數 功能
    INSTALLLEVEL=1 FeatureMain,FeatureEnvironment,FeatureJarFileRunWith
  3. 在目標工作站上執行指令 msiexec 。 使用選取的功能,如下列範例所示。

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

    注意

    您必須搭配 INSTALLDIR使用 FeatureMain

    此範例會以無訊息方式安裝 OpenJDK 的 Microsoft Build、更新 PATH、將 .jar 檔案與 Java 應用程式相關聯,以及定義 JAVA_HOME

Windows使用套件管理器 (winget) 安裝Windows

若要使用套件管理員安裝 Windows ,請先 安裝 winget,然後開啟 Windows 終端機。

接下來,使用下列命令來搜尋 OpenJDK 套件Microsoft組建:

winget search Microsoft.OpenJDK

產生的輸出類似於:

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

您現在可以使用以下命令參照 Id來安裝套件:

winget install Microsoft.OpenJDK.25

此命令會產生類似以下內容的輸出:

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

在 macOS 上安裝

macOS 的套件可透過 Homebrew 或以 PKG(macOS 套件安裝程式)或 TAR.GZ 格式單獨下載。

若要使用 Homebrew 安裝最新版本:

brew install --cask microsoft-openjdk

此命令會產生類似下列的輸出:

==> 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!

注意

microsoft-openjdk套件指向最新版的 Microsoft OpenJDK 組建。

若要使用 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

要在 macOS 上使用 TAR.GZ 套件進行安裝,請將檔案解壓縮到您想要的位置。 JDK 位於 <location>/jdk-<version>/Contents/Home

若要使用 PKG 安裝程式進行安裝,請開啟安裝程式並遵循指示。 依預設,JDK 會安裝在 /Library/Java/JavaVirtualMachines/microsoft-25.jdk/Contents/Home

在macOS上卸載

若要解除安裝透過 Homebrew 或 PKG 安裝的 Microsoft Build of OpenJDK,請使用下列命令:

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

要解除安裝使用 TAR.GZ 檔案安裝的套件,請刪除安裝資料夾。

在 Ubuntu 上安裝

若要在Ubuntu 18.04、20.04、22.04和24.04 LTS版本上安裝 ,請開啟終端機並執行下列命令:

# 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

新增存放庫之後,請執行下列命令來安裝 openJDK Microsoft組建:

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

注意

您可能必須更新預設 JDK 選項。 詳情請參見 此處

在 Debian 上安裝

Debian 10 - 12 版

警告

截至 2024 年 7 月, Debian 10 的官方支援已經結束。 截至 2024 年 7 月,所有已發佈的 JDK 仍可使用,但不會收到持續的更新或支援。

若要在 Debian 10 到 12 上安裝,請開啟終端機並執行下列命令:

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

新增存放庫之後,請執行下列命令:

sudo apt update
sudo apt install msopenjdk-25

注意

您可能必須更新預設 JDK 選項。 詳情請參見 此處

Debian 9

警告

截至 2024 年 7 月,對 Debian 9 的官方支援已經結束。 截至 2024 年 7 月,所有已發佈的 JDK 仍可使用,但不會收到持續的更新或支援。

若要在 Debian 9 上安裝,請開啟終端機並執行下列命令:

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

新增存放庫之後,請執行下列命令:

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

注意

您可能必須更新預設 JDK 選項。 詳情請參見 此處

在 SUSE 上安裝

openSUSE 15

若要在 openSUSE 15 上安裝,請開啟終端機並執行下列命令:

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

要在 SLES(SUSE Linux Enterprise Server)15 上安裝,請開啟終端機並執行以下指令:

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

在 CentOS 7 上安裝 (RPM)

若要在 CentOS 7 上安裝,請開啟終端機並執行下列命令:

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install msopenjdk-25

注意

RPM msopenjdk-25 套件可能不會自動更新至最新的次要版本。 若要檢查可用的版本,請執行 yum -v list msopenjdk-25。 然後,執行 yum install msopenjdk-25-<version> 以強制更新至指定的版本。 範例: yum install msopenjdk-25-25.0.1-1

安裝在 Alpine (TAR.GZ)

若要在 Alpine 中安裝,請下載一個套件 tar.gz 用於 Alpine (請參閱 下載 頁面),並將其解壓縮至您所需的位置。

注意

Alpine 僅支援JDK 11和JDK 17。 我們不支援 Alpine JDK 21 和更新版本。

變更 Linux 上的預設 JDK

如果您的系統上已安裝數個版本的 OpenJDK,請使用下列命令,將 OpenJDK 建置Microsoft設定為預設值:

針對 Debian/Ubuntu:

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

對於 CentOS,您可以使用該 alternatives 命令來管理 Java 版本。

提供 OpenJDK Microsoft組建的意見反應

將您的意見、想法和想法傳送給我們,以協助我們改善 OpenJDK 的Microsoft組建。 請流覽 GitHub 上的 OpenJDK 討論頁面,以傳送意見反應給我們。

Java 和 OpenJDK 是 Oracle 和/或其關係企業的商標或注冊商標。