• VS Code er koderedigeringsverktøyet (IDE) vi skal bruke i TDT4100. 

• Java Development Kit (JDK) er nødvendig for å kompilere java-kode. Vi anbefaler java-versjon 1721.

Installasjon

...

Det er flere aktører som har laget sin egen versjon av java, og det spiller ikke så stor roller hvilken dere installerer, så lenge det er Java 1721.

Vi anbefaler Java versjon 1721. For eksempel kan man bruke Adoptium sin Eclipse Temurin 1721:

1. Gå til https://adoptium.net/
2. Last ned installasjonsfilen som passer til ditt operativsystem.
3. 
4. Kjør installasjonsfilen.
5. Sørg for at installasjonen setter JAVA_HOME-variablen:
   
6. Fullfør installasjonen ved å klikke videre. 
7. Start PCen på nytt for å sørge for at JAVA_HOME-variabelen blir oppdattert.
8. Sjekk om variabelen JAVA_HOME ble satt ved å kjøre en av følgende:

   1. CMD:

      Code Block
      language bash
      echo %JAVA_HOME%

      

   2. Powershell:

      Code Block
      language powershell
      echo $Env:JAVA_HOME

      

9. Dersom JAVA_HOME ikke finnes har det skjedd noe galt under installasjonen (eller du glemte å velge at JAVA_HOME skulle bli satt.

...

1. Gå til https://maven.apache.org/download.cgi
2. Last ned binary zip archive:
   
3. Pakk ut filene: 
   
4. Kopier den utpakkede mappen:
   
   
5. Lim inn mappen i C:\Program Files  (krever admin-rettigheter):
   
   
6. Trykk på Windows-knappen og søk på 
   1. Engelsk Windows: "Environment variables"
      Velg Edit the system environment variables
      
   2. Norsk Windows: "System"
      
      Velg Rediger systemvariabler
      
   
   
   
7. Klikk på "Environment Variables"-knappen (Miljøvariabler)
   
8. Under "System Variables", klikk New:
   
9. Lag en variabel som heter MAVEN_HOME. Verdien er fil-stien til mappen inni mappen du limte inn i program files.
   
   
10. Lag enda en variabel som heter M2_HOME som har samme verdi som MAVEN_HOME
11. Klikk på "Path", og klikk "Edit" (rediger):
    
12. Klikk new:
    
13. Lim inn fil-stien til bin-mappen som ligger inni mappen fra MAVEN_HOME-variabelen:
    
14. Klikk Ok

15. Åpne en terminal og kjør:

    Code Block
    language powershell
    mvn -version

    Sjekk at kommandoen fungerte og ikke ga feilmelding:
    

16. Gratulerer, nå er du klar til å gå videre til . 

macOS

Installer Homebrew

Vi anbefaler at dere bruker Homebrew for installasjon av utviklingsverktøy på macOS. Dette er en "package manager" som lar deg laste ned programmer og lignende ved hjelp av enkle terminal-kommandoer, og sparer deg generelt for veldig mye jobb. Les hvordan man installerer Homebrew på nettsiden deres. Du kan sjekke om du allerede har installert Homebrew ved å kjøre følgende kommando i terminalen:

brew --version

For å åpne terminalen bruk Spotlight (COMMAND ⌘ + SPACE) og søk på "terminal")

Hvis du får en feilmelding betyr det at Homebrew ikke er installert. For å installere, følg instruksjonene på nettsiden deres. 

Installer Java

Kjør følgende kommandoer i terminalen for å installere Java 1721:

brew tap homebrew/cask-versions
brew install --cask temurin17temurin21

For å verifisere at Java har blitt installert kan du kjøre følgende kommando:

java --version

Installer VS Code

Kjør følgende kommandoer Hvis du ikke har VS Code fra før av kjør følgende kommando i terminalen for å installere VS Code:

brew install --cask visual-studio-code

Alternativt kan man laste ned VS Code fra nettsiden deres.

Installer Maven (valgfritt, men anbefales)

Maven er et verktøy for Java som gjør det lettere å håndtere prosjekter. Maven er valgfritt, men siden installasjon av Maven er såpass enkelt på macOS så anbefaler vi at man gjør det uansett. 

Kjør følgende kommandoer i terminalen for å installere Maven:

brew install maven

Etter at alle stegene i denne seksjonen er fullført kan du gå videre til installere tillegg lengre ned på siden.

Linux/Windows med WSL

Dersom du har Linux installert antar vi at du greier å installere Java, Maven og VSCode på egenhånd. Dersom du bruker Windows og WSL har du gjerne installert Ubuntu. Vi inkluderer lenker til sider som har guides for installasjon av det dere trenger, men det er ikke sikkert de dekker alle ulike distroer etc. Om du bruker noe mer eksotisk er du på egenhånd

Installer Java

Kjør følgende kommandoer i terminalen for å installerere Java

...

21:

sudo apt install wget apt-transport-https

wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null

echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list

sudo apt update # update if you haven't already
sudo apt install temurin-21-jdk

Alternativt kan du følge Følg guiden her.

Installer VS Code

Se installasjonsside fra Microsoft her. 

(Se bort fra dette steget hvis du bruker WSL, da kan du følge Windows-guiden for VS Code.)

Installer Maven (valgfritt)

For Ubuntu++ skal dette bare være å kjøre

sudo apt install maven

Om det ikke fungerer, se Apache Mavens installasjonsside.

Anchor
installere_tillegg installere_tillegg

Installere tillegg (gjelder for alle plattformer)

Vi ønsker å bruker noen tilleggspakker som gjør det enklere å bruke VS Code til java-programmering.

1. Åpne VS Code
2. Søk på Extension Pack for Java i extensions marketplace: 
   
3. Klikk install

Gratulerer, du er nå ferdig med å installere alt og kan gå videre til konfigurering!

...

Konfigurering

Alle innstillinger forklart i denne seksjonen er valgfrie, men kan være lure likevel for å gjøre det lettere å jobbe med Java i VS Code.

Når ønskede innstillinger er endret kan man gå videre til å Sette opp øvingsprosjekt.

Force build instilling

En standardinnstilling for tilleggspakken Debugger for Java sjekker om hele prosjektet bygger feilfritt før man kjører koden. Dette er ikke alltid ønskelig i øvingsprosjektet, siden de fleste oppgavene ikke avhenger av andre. Hvis man ikke endrer denne innstillingen får man denne meldingen hver gang man prøver å kjøre noe kode dersom det er en feil hvor som helst i hele prosjektet:

...

1. Åpne VS Code
2. Åpne settings.json ved Ctrl + Shift + P og søk på user settings:
   Image RemovedImage Added

3. Legg til denne linjen i settings.json:

   Code Block
   language yml
   "java.debug.settings.forceBuildBeforeLaunch": false

Potensielle problemer med JAVA_HOME

Før du sjekker disse innstillingene anbefaler vi å prøve å Sette opp øvingsprosjekt, og se om koden fungerer som den skal. Om alt fungerer skal det ikke være noe behov for å endre på JAVA_HOME.

Sjekk at JAVA_HOME-variabelen i VS Code peker til riktig plass (dersom innstilingen eksiterer). 

...

Feilsøking

Hvis du fremdeles har problemer med å kjøre kode etter å ha fulgt instruksjonene for å Sette opp øvingsprosjekt, så kan denne seksjonen være til hjelp.

Generelt tips som kan løse mange problemer: Clean Java Language Server Workspace

Veldig ofte så er det så enkelt og greit som å bare laste inn et åpent prosjekt i VS Code på nytt for å løse feilmeldinger. Dette gjøres ved å åpne command palette (Shift+Command+P på Mac og Ctrl+Shift+P på Windows/Linux) og søke etter Java: Clean Java Language Server Workspace. 

 Image Added.

Trykk deretter på Reload and Delete (ikke vær redd, dette sletter ikke noe kode).

Image Added

Etter dette vil VS Code bruke ca. 5-10 sekunder på å laste inn prosjektet på nytt. 

Module *** not found (gjelder Mac)

Image AddedImage Added

Hvis du får module *** not found feilmeldinger, så kan en vanlig årsak være at en av foreldre-mappene til prosjektet har et navn som inneholder noen uvanlige tegn. Eksempelvis så liker ikke Java skråstreker i mappenavn, så følgende lokasjon Users → bruker → Studie → 1/2. semester → tdt4100-students-24 kan forårsake problemer.

Image Added 
 

Potensielle problemer med JAVA_HOME

Om det ikke er noen "java.jdt.ls.java.home" i settings.json går det sannsynligvis fint, da VS Code vil lete etter JAVA_HOME environment-variabelen på PCen din. Om det oppstår feilmeldinger knyttet til JAVA_HOME, kan det være lurt å ta en kikk om denne innstillingen er satt til feil Java-versjon (kan fort skje om flere Java-versjoner er installert på PCen).

1. Åpne VS Code
2. Åpne settings.json ved Ctrl + Shift + P og søk på user settings:
   Image RemovedImage Added
3. Sjekk at "java.jdt.ls.java.home" er den samme plassen der JDK ble installert.
   Image Removed
   EDIT: "Java.home" er nå utdatert, bruk "java.jdt.ls.java.home" i stedet.Image Added