Skip to content

Commit

Permalink
Update JDK links in installation guides (#1261)
Browse files Browse the repository at this point in the history
* Update JDK links in installation guides

* Clarify jdk-installer options
  • Loading branch information
Redande committed May 22, 2024
1 parent fcdd373 commit 9261395
Show file tree
Hide file tree
Showing 8 changed files with 115 additions and 75 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,14 @@ Follow the instructions below to install

### Installing Java <a name="javan-asentaminen"></a>

Download AdoptOpenJDK11, open development environment for Java 11, from [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).

Select OpenJDK 11 (LTS) and HotSpot. Then click "Latest release" to download Java.
1. Download OpenJDK11, open development environment for Java 11, from [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=windows&version=11&package=jdk).
- The page should be filtered to only show installation packages for Windows, for package type JDK and version 11 - LTS.
- Select the correct installer for your operating system's architecture type
- x64 for 64-bit operating system
- x86 for 32-bit operating system
- You can check which architecture type your operating system is from the Start menu by selecting Settings --> System --> About. Under Device specifications you should find "System type".

2. Download the installation file with the .msi-button.

**NB!** When installing Java with the installation file you just downloaded, in the Custom Setup phase set both "Set JAVA_HOME variable" and "JavaSoft (Oracle) registry keys" to "Entire feature will be installed on local hard drive" (see the images below).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,14 @@ Seuraa allaolevia ohjeita ja asenna koneellesi

### Javan asentaminen <a name="javan-asentaminen"></a>

Lataa Java 11:n avoin kehitysympäristö AdoptOpenJDK11 osoitteesta [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).

Valitse sivulta OpenJDK 11 (LTS) ja HotSpot. Sitten voit painaa Latest release -nappia ladataksesi Javan.
1. Lataa Java 11:n avoin kehitys- ja suoritusympäristö OpenJDK11 osoitteesta [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=windows&version=11&package=jdk).
- Sivulla pitäisi olla valmiiksi suodatettuna vain Windows-käyttöjärjestelmälle pakettityypin JDK versio 11 - LTS.
- Valitse asennettavista paketeista oman käyttöjärjestelmäsi arkkitehtuurin mukainen asennuspaketti
- x64 jos käyttöjärjestelmäsi on 64-bittinen.
- x86 jos käyttöjärjestelmäsi on 32-bittinen.
- Voit tarkistaa käyttöjärjestelmäsi version painamalla Start-nappia, valitsemalla Settings --> System --> About. Device specifications:in alta pitäisi löytyä "System type".

2. Lataa asennustiedosto .msi-napista.

**HUOM!** Kun asennat Javaa lataamastasi asennustiedostosta, aseta Custom Setup -vaiheessa sekä "Set JAVA_HOME variable" että "JavaSoft (Oracle) registry keys" -kohtiin "Entire feature will be installed on local hard drive". (katso allaolevat kuvat)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,9 +30,13 @@ Follow the instructions below to install

### 1.Installing Java <a name="javan-asentaminen"></a>

1. Download the open development environment for Java 11, AdoptOpenJDK11, from [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).
1. Download the open development environment for Java 11, OpenJDK11, from [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=mac&version=11&package=jdk).
- The page should be filtered to only show installation packages for macOS, for package type JDK and version 11 - LTS.
- Select the aarch64 or x64 installer based on your macOS version. You can determine the correct version from the Apple icon menu --> choose "About This Mac"
- If your Chip is M1, M2 or M3 then you should select the aarch64 installer.
- If your Chip is Intel, then you should select the x64 installer.

2. Select OpenJDK 11 (LTS) and HotSpot. Then click the "Latest release" button to download Java.
2. Download the installation file with the .pkg-button.

3. When the download is complete, open the installation file.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,13 @@ Seuraa allaolevia ohjeita ja asenna koneellesi

### 1.Javan asentaminen <a name="javan-asentaminen"></a>

1. Lataa Java 11:n avoin kehitysympäristö AdoptOpenJDK11 osoitteesta [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).
1. Lataa Java 11:n avoin kehitysympäristö OpenJDK11 osoitteesta [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=mac&version=11&package=jdk).
- Sivulla pitäisi olla valmiiksi suodatettuna vain macOS-käyttöjärjestelmälle pakettityypin JDK versio 11 - LTS.
- Valitse aarch64 tai x64 asennustiedosto macOS-versiosi perusteella. Voit varmistaa oikean version Apple-valikosta --> valitse "About This Mac"
- Jos Chip-kohdassa lukee M1, M2 tai M3, valitse aarch64-asennustiedosto.
- Jos Chip-kohdassa lukee Intel, valitse x64-asennustiedosto.

2. Valitse sivulta OpenJDK 11 (LTS) ja HotSpot. Sitten voit painaa Latest release -nappia ladataksesi Javan.
2. Lataa asennustiedosto .pkg-napista.

3. Kun olet ladannut asennustiedoston, avaa se.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,26 +14,26 @@ import TableOfContents from "/public/md_pages/installation/sisallysluettelo_vsco


<ContentBox>
Follow the instructions below to download Visual Studio Code (VS Code) and TestMyCode (TMC) extension for VS Code.
Follow the instructions below to download Visual Studio Code (VS Code) and TestMyCode (TMC) extension for VS Code.

You need to have administrator priviledges on your computer to install the necessary programs.
You need to have administrator priviledges on your computer to install the necessary programs.
If you are using a computer provided by the computer science department you can skip directly to [Installing TestMyCode extension](#installing-tmc) section.

### Installing Visual Studio Code <a name="installing-vscode"></a>

Please install Visual Studio Code from the link below. Visual Studio Code is not the same program as Microsoft Visual Studio.
Please install Visual Studio Code from the link below. Visual Studio Code is not the same program as Microsoft Visual Studio.

1. Download the Windows installation file from [https://code.visualstudio.com/download](https://code.visualstudio.com/download).
2. Once download is completed, double-click the file to open it.
3. Follow the instructions of the installation file.

### Installing TestMyCode Extension for VS Code <a name="installing-tmc"></a>

1. Open Visual Studio Code.
2. At the left you can see icons, choose the Extension view (see picture point 1).
3. Type **TestMyCode** in the search field (see picture point 2).
1. Open Visual Studio Code.
2. At the left you can see icons, choose the Extension view (see picture point 1).
3. Type **TestMyCode** in the search field (see picture point 2).
4. Press the search result **TestMyCode**.
5. Press "Install" (see picture point 3).
5. Press "Install" (see picture point 3).

The first initilization of the extension will download some necessary components (this will take a while).
![Installing the TMC extension for VS Code](vscode/download_extension.webp)
Expand All @@ -44,14 +44,14 @@ The first initilization of the extension will download some necessary components

### Installing Python environment <a name="installing-python"></a>

For courses using Python you will need Python and Python Extension for VS Code to run your source code.
For courses using Python you will need Python and Python Extension for VS Code to run your source code.
Please install Python following the instructions below.

#### Installing Python <a name="python3"></a>

1. Go to [https://www.python.org/downloads/](https://www.python.org/downloads/)
2. Download the latest version of Python 3.
3. Double-click the installation file to start the installation.
3. Double-click the installation file to start the installation.
4. Make sure you choose "Add Python 3.x to PATH" (see picture point 1).
5. Choose "Install now" (see picture point 2).
6. Once installation is completed, you can close the install window.
Expand All @@ -73,15 +73,21 @@ Please install Python following the instructions below.

### Installing Java environment <a name="java-environment"></a>

For courses using Java you will need Java Development kit & Runtime Environment, Java Extension Pack for Visual Studio Code and Maven to build and run your source code.
For courses using Java you will need Java Development kit & Runtime Environment, Java Extension Pack for Visual Studio Code and Maven to build and run your source code.
Please install Java following the instructions below.

#### Installing Java <a name="adopt-open-jdk"></a>

1. Download AdoptOpenJDK11, open development and runtime environment for Java 11, from [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).
2. Select OpenJDK 11 (LTS) and HotSpot. Then click "Latest release" to download Java.
1. Download OpenJDK11, open development environment for Java 11, from [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=windows&version=11&package=jdk).
- The page should be filtered to only show installation packages for Windows, for package type JDK and version 11 - LTS.
- Select the correct installer for your operating system's architecture type
- x64 for 64-bit operating system
- x86 for 32-bit operating system
- You can check which architecture type your operating system is from the Start menu by selecting Settings --> System --> About. Under Device specifications you should find "System type".

**NB!** When installing Java with the installation file you just downloaded, in the Custom Setup phase set both "Set JAVA_HOME variable" (pic 1, step 1) and "JavaSoft (Oracle) registry keys" (pic 2, step 2) to "Entire feature will be installed on local hard drive" (see the images below).
2. Download the installation file with the .msi-button.

**NB!** When installing Java with the installation file you just downloaded, in the Custom Setup phase set both "Set JAVA_HOME variable" (pic 1, step 1) and "JavaSoft (Oracle) registry keys" (pic 2, step 2) to "Entire feature will be installed on local hard drive" (see the images below).
Once you have chosen these, press "Next" (pic 2, step 3).

![Custom Setup phase of AdoptOpenJDK installer, where Set JAVA_HOME variable is set to Entire feature will be installed on local hard drive.](vscode/adoptopenjdk-set-java-home.webp)
Expand All @@ -104,20 +110,20 @@ You will need Java Extension Pack for Visual Studio Code to compile and run your

#### Installing Maven and configuring settings <a name="maven-configuring"></a>

You can install Maven by following the instructions below.
You can install Maven by following the instructions below.

1. Download the latest Binary zip archive, `apache-maven-3.x.y-bin.zip`, from [https://maven.apache.org/download.cgi](https://maven.apache.org/download.cgi).
2. Extract the archive to your desired location, e.g. `C:\Program Files\`, this will create automatically a folder named `apache-maven-3.x.y`.
3. If you installed the Java Extension Pack in VS Code, it comes with `Maven for Java`. Set Maven path in this extension as below:
* Open Visual Studio Code
* Press at top left "File -> Preferences -> Settings" or use the hotkey: `CTRL + ,`
* Find `maven.executable.path` (pic below 1.) and set Maven path (pic below 2.) as:
`<your extracted location\apache-maven-3.x.y\bin\mvn.cmd`
for example with version 3.6.3 of Maven extracted to C:\Program Files the path would be:
* Find `maven.executable.path` (pic below 1.) and set Maven path (pic below 2.) as:
`<your extracted location\apache-maven-3.x.y\bin\mvn.cmd`
for example with version 3.6.3 of Maven extracted to C:\Program Files the path would be:
`C:\Program Files\apache-maven-3.6.3\bin\mvn.cmd`

![Setting the Maven executable path](vscode/maven_executable_path.webp)

</ContentBox>

<StartingProgrammingGuide />
<StartingProgrammingGuide />
Original file line number Diff line number Diff line change
Expand Up @@ -13,24 +13,24 @@ import TableOfContents from "/public/md_pages/installation/sisallysluettelo_vsco
</ContentBox>

<ContentBox>
Seuraa alla olevia ohjeita asentaaksesi Visual Studio Code (VS Code) ja TestMyCode (TMC) -laajennus VS Codeen.
Seuraa alla olevia ohjeita asentaaksesi Visual Studio Code (VS Code) ja TestMyCode (TMC) -laajennus VS Codeen.

Tarvitset järjestelmävalvojaoikeudet tietokoneellesi asentaaksesi tarvittavat ohjelmat.
Tarvitset järjestelmävalvojaoikeudet tietokoneellesi asentaaksesi tarvittavat ohjelmat.
Mikäli sinulla on käytössäsi Tietojenkäsittelytieteen osaston laite, voit siirtyä suoraan [TestMyCode -laajennuksen asentamiseen](#TestMyCode-asentaminen).

### isual Studio Coden asentaminen <a name="VSCoden-asentaminen"></a>
### Visual Studio Coden asentaminen <a name="VSCoden-asentaminen"></a>

Kurssia varten tulisi asentamaan Visual Studio Code alla olevan linkin takaa. Visual Studio Code ei ole sama ohjelma kuin Microsoft Visual Studio.
Kurssia varten tulisi asentamaan Visual Studio Code alla olevan linkin takaa. Visual Studio Code ei ole sama ohjelma kuin Microsoft Visual Studio.

1. Lataa Windowsin asennusohjelma osoitteesta [https://code.visualstudio.com/download](https://code.visualstudio.com/download)
2. Kun tiedoston lataaminen on valmis, tuplaklikkaa tiedostoa avataksesi asennusohjelma.
3. Tämän jälkeen seuraa ruudulle tulevia ohjeita.

### TestMyCode-laajennuksen asentaminen VS Codeen <a name="TestMyCode-asentaminen"></a>

1. Avaa Visual Studio Code ohjelma.
2. Ohjelman vasemmassa sivupalkissa näkyy ikoneita, valitse sieltä Extensions -näkymä (kuvassa kohta 1).
3. Kirjoita hakukenttään **TestMyCode** (kuvassa kohta 2).
1. Avaa Visual Studio Code ohjelma.
2. Ohjelman vasemmassa sivupalkissa näkyy ikoneita, valitse sieltä Extensions -näkymä (kuvassa kohta 1).
3. Kirjoita hakukenttään **TestMyCode** (kuvassa kohta 2).
4. Valitse **TestMyCode** hakutuloksesta.
5. Paina "Install" -painiketta (kuvassa kohta 3).

Expand All @@ -44,14 +44,14 @@ Ensimmäisen käynnistyksen yhteydessä laajennus lataa sen tarvitsemat komponen

### Python-ympäristön asentaminen <a name="python-asentaminen"></a>

Python-ohjelmointikursseilla tarvitset Python3:a ja Python-laajennusta Visual Studio Codeen suorittaaksesi lähdekoodia.
Python-ohjelmointikursseilla tarvitset Python3:a ja Python-laajennusta Visual Studio Codeen suorittaaksesi lähdekoodia.
Saat asennettua nämä käyttöösi seuraamalla näitä ohjeita.

#### Pythonin asentaminen <a name="python3"></a>

1. Mene osoitteeseen [https://www.python.org/downloads/](https://www.python.org/downloads/)
2. Lataa viimeisin saatavilla oleva versio Python 3:sta.
3. Käynnistä asennus tuplaklikkaamalla asennustiedostoa.
3. Käynnistä asennus tuplaklikkaamalla asennustiedostoa.
4. Valitse asennusvaiheessa "Add Python 3.x to PATH" (kuvassa kohta 1).
5. Valitse "Install now" (kuvassa kohta 2).
6. Kun asennus on valmis, voit sulkea asennusikkunan.
Expand All @@ -73,15 +73,21 @@ Saat asennettua nämä käyttöösi seuraamalla näitä ohjeita.

### Java-ympäristön asentaminen <a name="javan-asentaminen"></a>

Java ohjelmointikursseilla tarvitset Java kehitys- ja suoritusympäristön, Java laajennuksen Visual Studio Codeen ja Mavenin.
Java ohjelmointikursseilla tarvitset Java kehitys- ja suoritusympäristön, Java laajennuksen Visual Studio Codeen ja Mavenin.
Saat asennettua nämä käyttöösi seuraamalla ohjeita alla.

#### Javan asentaminen <a name="adopt-open-jdk"></a>

1. Lataa Java 11:n avoin kehitys- ja suoritusympäristö AdoptOpenJDK11 osoitteesta [https://adoptopenjdk.net](https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot).
2. Valitse sivulta OpenJDK 11 (LTS) ja HotSpot. Sitten voit painaa Latest release -nappia ladataksesi Javan.
1. Lataa Java 11:n avoin kehitys- ja suoritusympäristö OpenJDK11 osoitteesta [https://adoptium.net/](https://adoptium.net/temurin/releases/?os=windows&version=11&package=jdk).
- Sivulla pitäisi olla valmiiksi suodatettuna vain Windows-käyttöjärjestelmälle pakettityypin JDK versio 11 - LTS.
- Valitse asennettavista paketeista oman käyttöjärjestelmäsi arkkitehtuurin mukainen asennuspaketti
- x64 jos käyttöjärjestelmäsi on 64-bittinen.
- x86 jos käyttöjärjestelmäsi on 32-bittinen.
- Voit tarkistaa käyttöjärjestelmäsi version painamalla Start-nappia, valitsemalla Settings --> System --> About. Device specifications:in alta pitäisi löytyä "System type".

**HUOM!** Kun asennat Javaa lataamastasi asennustiedostosta, aseta Custom Setup -vaiheessa sekä "Set JAVA_HOME variable" (kuva 1, kohta 1) että "JavaSoft (Oracle) registry keys" -kohtiin (kuva 2, kohta 2) "Entire feature will be installed on local hard drive".
2. Lataa asennustiedosto .msi-napista.

**HUOM!** Kun asennat Javaa lataamastasi asennustiedostosta, aseta Custom Setup -vaiheessa sekä "Set JAVA_HOME variable" (kuva 1, kohta 1) että "JavaSoft (Oracle) registry keys" -kohtiin (kuva 2, kohta 2) "Entire feature will be installed on local hard drive".
Kun nämä on asetettu, paina "Next" (kuva 2, kohta 3).

![AdoptOpenJDK:n asennusohjelman Custom Setup -vaihe, jossa asetetaan Set JAVA_HOME variable -kohtaan vaihtoehto Entire feature will be installed on local hard drive](vscode/adoptopenjdk-set-java-home.webp)
Expand All @@ -105,16 +111,16 @@ Tarvitset Java-laajennuksen Visual Studio Codessa, jotta voit kääntää ja suo

#### Mavenin asentaminen ja asetusten määrittäminen <a name="maven-ja-asetukset"></a>

Saat asennettua Mavenin seuraamalla alla olevia ohjeita.
Saat asennettua Mavenin seuraamalla alla olevia ohjeita.

1. Lataa viimeisin Binary zip archive, `apache-maven-3.x.y-bin.zip`, osoitteesta [https://maven.apache.org/download.cgi](https://maven.apache.org/download.cgi).
2. Pura arkisto haluaamaasi paikkaan, esim. `C:\Program Files\`, tämä luo automaattisesti kansion `apache-maven-3.x.y` purkamaasi paikkaan.
3. Mikäli asensit Java laajennuksen VS Codeen, tämän mukana tulee `Maven for Java` lisäosa. Aseta Maven polku kyseisen lisäosan asetuksiin seuraavasti:
* Avaa Visual Studio Code
* Paina ylhäältä "File -> Preferences -> Settings" tai näppäimistössä pikanäppäintä kyseiselle toiminnallisuudelle: `CTRL + ,`
* Etsi `maven.executable.path` (kuvassa 1) ja aseta Maven polku (kuvassa 2) seuraavasti:
`<purkamasi paikka>\apache-maven-3.x.y\bin\mvn.cmd`
esim. Versio 3.6.3 Mavenista purettuna C:\Program Files\ alle olisi asetettuna seuraavasti:
* Etsi `maven.executable.path` (kuvassa 1) ja aseta Maven polku (kuvassa 2) seuraavasti:
`<purkamasi paikka>\apache-maven-3.x.y\bin\mvn.cmd`
esim. Versio 3.6.3 Mavenista purettuna C:\Program Files\ alle olisi asetettuna seuraavasti:
`C:\Program Files\apache-maven-3.6.3\bin\mvn.cmd`

![Mavenin tiedostopolun asettaminen](vscode/maven_executable_path.webp)
Expand Down
Loading

0 comments on commit 9261395

Please sign in to comment.