Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Java Setup for JDK 17 #3909

Merged
merged 8 commits into from
Mar 14, 2022
39 changes: 18 additions & 21 deletions docs/_articles/en/getting-started/java-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Java Setup
lang: en
---

The Apex Language Server, shipped as part of the Salesforce Apex Extension for VS Code, depends on the Java Platform, Standard Edition Development Kit (JDK). It requires an installation of either JDK version 11 (Recommended) or JDK version 8. By default, the extension attempts to locate your local Java installation by looking for a `JAVA_HOME` or `JDK_HOME` environment variable on your computer. If the extension can't find your Java installation, or if you want it to use a different installation, change the `salesforcedx-vscode-apex.java.home` setting.
The Apex Language Server, shipped as part of the Salesforce Apex Extension for VS Code, depends on the Java Platform, Standard Edition Development Kit (JDK). It requires an installation of either JDK version 17 (Recommended), JDK version 11, or JDK version 8. By default, the extension attempts to locate your local Java installation by looking for a `JAVA_HOME` or `JDK_HOME` environment variable on your computer. If the extension can't find your Java installation, or if you want it to use a different installation, change the `salesforcedx-vscode-apex.java.home` setting.

1. Select **File** > **Preferences** > **Settings** (Windows or Linux) or **Code** > **Preferences** > **Settings** (macOS).
2. Search for `apex`.
Expand All @@ -13,15 +13,14 @@ The Apex Language Server, shipped as part of the Salesforce Apex Extension for V

Below you'll find instructions on how to download and configure different versions of Java.

## AdoptOpenJDK
## Adoptium

[AdoptOpenJDK](https://adoptopenjdk.net/) provides prebuilt OpenJDK binaries for free without authentication or complications.
[Adoptium](https://adoptopenjdk.net/) provides prebuilt OpenJDK binaries for free without authentication or complications.

1. Navigate to [AdoptOpenJDK](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot)
1. Select **OpenJDK 11 (LTS)**
1. Select **HotSpot**
1. Click the **Latest Release** button to download.
1. After the file has downloaded, open it and complete the installation steps.
1. Navigate to [Adoptium](https://adoptium.net/?variant=openjdk11)
2. Select **Temurin 17 (LTS)**
3. Click the **Latest Release** button to download.
4. After the file has downloaded, open it and complete the installation steps.

Inside Visual Studio Code, set `salesforcedx-vscode-apex.java.home` to one of the following values.

Expand Down Expand Up @@ -56,12 +55,13 @@ Linux (Pop! OS 20.04, installation via aptitude):
Zulu Java builds are TCK-tested and free to download and use without restrictions.

1. Navigate to the [Zulu download page](https://www.azul.com/downloads/zulu/)
1. Select version **11**
1. Select your OS
1. Download the installer
1. For macOS download the zip or dmg version.
1. For Windows Download the "11", "JDK", "Client" version.
1. Once the file is downloaded open it and complete the installation steps.
2. Click the **Choose Your Download** button.
3. Select Java Version **Java 17 (LTS)**.
4. Select your OS.
5. Select your Architecture.
6. Select your Java Package (JDK).
7. Download the installer.
8. Once the file is downloaded open it and complete the installation steps.

Inside Visual Studio Code, set `salesforcedx-vscode-apex.java.home` to one of the following values.

Expand All @@ -86,13 +86,10 @@ Windows:
## Oracle Java 11 (Officially Tested)

1. Navigate to the [download page](https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html)
1. Click the **Download** button for **Java SE 11.x.y (LTS)**
1. Accept the license agreement
1. Click the download link that applies to your OS
1. For macOS download the dmg version.
1. For Windows Download exe version.
1. If prompted to log in, use your Oracle account.
1. Once the file is downloaded open it and complete the installation steps.
2. Navigate to **Java SE Development Kit 17.0.2 downloads**.
3. Click the download link that applies to your OS
4. If prompted to log in, use your Oracle account.
5. Once the file is downloaded open it and complete the installation steps.

Inside Visual Studio Code, set `salesforcedx-vscode-apex.java.home` to one of the following values.

Expand Down