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
- Gå til https://code.visualstudio.com/
- Last ned versjonen som passer for operativsystemet ditt (MAC/Windows/Linux).
- 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:
- Gå til https://adoptium.net/
- Last ned installasjonsfilen som passer til ditt operativsystem.
- Kjør installasjonsfilen.
- Sørg for at installasjonen setter JAVA_HOME-variablen:
- Fullfør installasjonen ved å klikke videre.
- Start PCen på nytt for å sørge for at JAVA_HOME-variabelen blir oppdattert.
- Sjekk om variabelen JAVA_HOME ble satt ved å kjøre en av følgende:
CMD:
echo %JAVA_HOME%
Powershell:
echo $Env:JAVA_HOME
- 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.
- Gå til https://maven.apache.org/download.cgi
- Last ned binary zip archive:
- Pakk ut filene:
- Kopier den utpakkede mappen:
- Lim inn mappen i C:\Program Files (krever admin-rettigheter):
- Trykk på Windows-knappen og søk på
- Engelsk Windows: "Environment variables"
Velg Edit the system environment variables - Norsk Windows: "System"
Velg Rediger systemvariabler
- Engelsk Windows: "Environment variables"
- Klikk på "Environment Variables"-knappen (Miljøvariabler)
- Under "System Variables", klikk New:
- Lag en variabel som heter MAVEN_HOME. Verdien er fil-stien til mappen inni mappen du limte inn i program files.
- Lag enda en variabel som heter M2_HOME som har samme verdi som MAVEN_HOME
- Klikk på "Path", og klikk "Edit" (rediger):
- Klikk new:
- Lim inn fil-stien til bin-mappen som ligger inni mappen fra MAVEN_HOME-variabelen:
- Klikk Ok
Åpne en terminal og kjør:
mvn -version
Sjekk at kommandoen fungerte og ikke ga feilmelding:
- Gratulerer, nå er du klar til å gå videre.
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 fram før av kjør følgende kommando i terminalen for å installere:
brew install --cask visual-studio-code
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
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
Følg guiden her.
Installer VS Code
Se installasjonsside fra Microsoft her.
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.
- Åpne VS Code
- Søk på Extension Pack for Java i extensions marketplace:
- Klikk install
Konfigurering
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:
- Åpne VS Code
- Åpne settings.json ved Ctrl + Shift + P og søk på settings:
Legg til denne linjen i settings.json:
"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).
Om det ikke er noen "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).
- Åpne VS Code
- Åpne settings.json ved Ctrl + Shift + P og søk på settings:
- Sjekk at "java.home" er den samme plassen der JDK ble installert.
- EDIT: "Java.home" er nå utdatert, bruk "java.jdt.ls.java.home" i stedet.