• 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 21.

Installasjon

Windows

Installere VS Code

1. Gå til https://code.visualstudio.com/
2. Last ned versjonen som passer for operativsystemet ditt (MAC/Windows/Linux).
   
3. Kjør installasjonsfilen.

Installere Java

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 21.

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

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:

      echo %JAVA_HOME%

      

   2. 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.

Installere Maven (valgfritt)

Maven er et verktøy for java som gjør det lettere å håndtere prosjekter. Det er ikke nødvendig i TDT4100, men kan være lurt å bli kjent med.

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:

    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. 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 21:

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

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

java --version

Installer VS Code

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

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 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.

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:

Så må man trykke Proceed for å kjøre koden, som vanligvis kjører helt fint (med mindre det faktisk er feil i den koden du vil kjøre).

For å skru av denne funksjonen, gjør følgende:

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

3. Legg til denne linjen i settings.json:

   "java.debug.settings.forceBuildBeforeLaunch": false

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. 

 .

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

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

Module *** not found (gjelder Mac)

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.

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:
   
3. Sjekk at "java.jdt.ls.java.home" er den samme plassen der JDK ble installert.