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.
Table of Contents |
---|
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 Development Kit
Vi kommer til å bruke Java 17 i 2022.
Linux / WSL / MacOS
For unix-systemer kan vi bruke SDKMAN for å installere Java og Maven på en enkel måte gjennom terminalen.
Installere SDKMAN
...
- Du kan åpne en terminal inne i VSCode ved å trykke på Terminal i menylinjen og så velge New Terminal (eller tilsvarende valg hvis du har norsk språk)
Kjør kommandoen
Code Block | ||
---|---|---|
| ||
curl -s "https://get.sdkman.io" | bash |
Kjør deretter
Code Block | ||
---|---|---|
| ||
source "$HOME/.sdkman/bin/sdkman-init.sh" |
...
Code Block | ||
---|---|---|
| ||
sudo apt install zip |
...
Kjør kommandoen nedenfor verifiser at installasjonen gikk som den skulle:
Code Block | ||
---|---|---|
| ||
sdk version |
Hvis oppsettet er riktig skal du få opp dette (eller lignende) i terminalen etter å ha kjørt kommandoen over:
Installere Java og Maven med SDKMAN
- Åpne en terminal
Kjør
Code Block language bash sdk install java 17.0.1-tem
Vent på at installasjonen skal bli ferdig.
Kjør
Code Block language bash sdk install maven
Vent på at installasjonen blir ferdig.
- Nå er du snart klar for å begynne å kode! Hopp til Installere tillegg lenger nede i guiden.
Windows
SDKMAN kan ikke brukes uten på Windows uten en del ekstra konfigurasjon. Vi har flere alternativer for installering av Java på Windows, så velg en av følgende fremgangsmåter:
- Installere WSL2 og følg guiden over for SDKMAN. (Bør ha noe kjennskap til bruk av terminal, ettersom man interagerer med WSL gjennom en Linux-terminal)
- Følg denne guiden for installasjon av SDKMAN med Git Bash i Windows og følg guiden over for SDKMAN
- Installere Java og (valgfritt) Maven manuelt ved å følge guiden under.
Vi anbefaler alternativ 1 eller 3. Om du ikke har noe kjennskap til bruk av terminal fra før, er nok alternativ 3 det greieste.
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 1721.
Vi anbefaler Java versjon 21. For eksempel kan man bruke Adoptium sin Eclipse Temurin 1721:
- 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:
Code Block language bash echo %JAVA_HOME%
Powershell:
Code Block language 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.
...
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.
(Windows guide)
- 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:
Code Block language powershell mvn -version
Sjekk at kommandoen fungerte og ikke ga feilmelding:
- 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:
Code Block | ||||
---|---|---|---|---|
| ||||
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:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
brew tap homebrew/cask-versions
brew install --cask temurin21 |
For å verifisere at Java har blitt installert kan du kjøre følgende kommando:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
java --version |
Installer VS Code
Hvis du ikke har VS Code fra før av kjør følgende kommando i terminalen for å installere:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
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:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
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:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
sudo apt install wget apt-transport-https |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
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 |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
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
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
sudo apt install maven |
Om det ikke fungerer, se Apache Mavens installasjonsside.
Anchor | ||||
---|---|---|---|---|
|
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
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:
...
- Åpne VS Code
- Åpne settings.json ved Ctrl + Shift + P og søk på user settings:
Legg til denne linjen i settings.json:
Code Block language yml "java.debug.settings.forceBuildBeforeLaunch": false
Potensielle problemer med JAVA_HOME
Om man installerer med SDKMAN skal ikke det være noe problem med JAVA_HOME. Manuell installasjon derimot kan av og til gå galt.
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.
.
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.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å user settings:
- Sjekk at "java.jdt.ls.java.home" er den samme plassen der JDK ble installert.