Installasjon av Eclipse

Last ned Eclipse-installasjonsprogrammet for din plattform fra https://wiki.eclipse.org/Eclipse_Installer. Om du ikke har Java installert fra før velger du versjonen med JRE inkludert.

Velg det grønne +-ikonet i øverste høyre hjørne og finn og lim inn adressen til setup-filen for Eclipse i Resource URIs-feltet. Lukk så dialogen med OK-knappen. Setup-filen ved navn TDT4100 skal nå være valgt. Legg merke til at du IKKE skal laste ned setup-filen og legge den til, men kun oppgi nettadressen til filen.

Pass på at TDT4100-v2021 (2020-12) er valgt i feltet Product Version, og at valgt javaversjon (i feltet Java 15+ VM) står på JRE 15.0.1 - <url>.

Trykk Next og legg inn setup-fila for Eclipse-prosjektene på samme måte: Velg +-ikonet, finn og lim inn adressen til setup-filen for Eclipse-prosjektene, velg GitHub projects og lukk dialogen. Legg merke til at du IKKE skal laste ned setup-filen og legge den til, men kun oppgi nettadressen til filen.

Finn prosjektet TDT4100, våren 2021 i treet over prosjekter (den skal ligge under GitHub Projects, <User>) og huk den av. NB: Husk at den skal hukes av, ikke bare markeres.

Trykk Next.

I det neste vinduet må du velge installasjonsmappa. Trykk på Show all variables nederst i venstre hjørne hvis du ikke ser alt som i bildet til høyre, og sjekk hvor Eclipse installeres. Sannsynligvis fungerer det som fylles inn automatisk fint, men det er VELDIG viktig at det ikke er noe mellomrom i hverken Installation folder name eller Root install folder. Om det er det (f.eks. hvis du har et mellomrom i brukernavnet ditt) må du endre hvor Eclipse installeres.

Det er viktig at du husker hvor du installerte Eclipse, da du må gå til den mappa for å starte programmet senere. Standarden er at det opprettes en mappe med navn tdt4100-<år>-master i hjem-mappa di, altså C:\Users\<username>, /home/<username> eller lignende.

Trykk Next (én eller flere ganger) og så Finish for å sette i gang selve installasjonen. Her kan det fort være du må akseptere litt andre ting underveis og. Dette kan ta noe tid... trøsten er at det går mye raskere neste gang, fordi filene som lastes ned i installasjonsprosessen kan gjenbrukes.

Når nedlastingen er ferdig, så startes Eclipse opp og du blir bedt om å angi plassering av et såkalt workspace. Dette er en mappa som inneholder (informasjon om) kodingsprosjektene dine, og kan forsåvidt ligge hvor som helst. Det enkleste er å bruke den foreslåtte plasseringen, men merk deg hvor det er, så du kan finne mappa igjen senere.

Når Eclipse er startet opp ser du en velkomstskjerm. Fjern denne ved å trykke på krysset ved siden av Welcome. Nå vil de forhåndsoppsatte Eclipse-prosjektene bli lastet ned vha. git, som er et system for deling av kode som brukes av utviklere over hele verden.

Høyreklikk på et av prosjektene (f.eks foreksempel) og velge Maven > Update Project. Huk av som på bildet og velg Ok.

Vindusoppsettet til Eclipse består av mange små "vinduer", der hvert vindu har sin egen jobb, som å vise filene i prosjekter, innholdet i kodefiler, output fra programmer, og mye mer. For bruk i dette faget anbefaler vi å vise et ekstra vindu i Eclipse. Nye vinduer kan åpnes ved å velge menyen Window → Show View → Other... og søke etter navnet på vinduet.

Exercise View: Dette brukes for å vise spesielle .ex-filer, som brukes ifm. øvinger i faget. Vinduet gir en del statistikk på hvordan du ligger an med oppgaven, hvor mange feil det er i koden din og hvor mange tester du fortsatt ikke har fått til å kjøre.

Du kan dra rundt på vinduer som du vil. Til høyre vises et eksempel på hvordan det kan se ut (merk at Exercise View vil være tomt helt til man åpner en .ex-fil i det).

Etter å ha fulgt stegene hit burde alt fungere som det skal ved kjøring av klasser og JUnit-tester. Det er lagt ved noen helt enkle klasser og tester for å sjekke at alt fungerer i ovinger-prosjektet. Ved feil, se diverse problemer og løsninger på disse under i stegene/punktene 11-13.

Forskjellige paneler kan gi litt feilmeldinger og ikke helt fungere slikt det skal i nåværende versjon.

Plant-UML-viewet, fungerer heller ikke helt optimalt og er det som kan gi en feilmelding hver gang du lager en ny fil eller åpner en ny fil. Lukk dette viewet så vil denne feilmeldingen gå vekk

For å fjerne gjenliggende problemer som av en eller annen grunn ikke bli borte kan du gå i Problems-panelet og slette alle problemene manuelt.

Problemer med å kjøre filer og/eller JUnit testene i Eclipse grunnet mellomrom (eller andre tegn) i filmappen hvor Eclipse er installert:

Hvis du får følgende feilmelding, eller generelt ikke klarer å kjøre filer og/eller JUnit-tester:

Error: Could not find or load main class meg\tdt4100-v2019-master4\git\tdt4100-v2019-students\ovinger\target\classes

Caused by: java.lang.ClassNotFoundException: meg\tdt4100-v2019-master4\git\tdt4100-v2019-students\ovinger\target\classe

...så skyldes dette problemet ofte hvor Eclipse er installert. Dette løses ved å installere det i en filmappe uten mellomrom eller bindestrek, for eksempel kan helt øverst i filstrukturen være nyttig. Eksempelvis kan det hende at eclipse er installert på "Users/Fornavn Etternavn/Documents/TDT4100.....). Her er mellomrommet mellom fornavnet og etternavnet problemet, og en måte å løse det på er å lage en ny bruker på datamaskinen uten mellomrom og installere programmet, samt JDK der.

Problemer med å kjøre filer? Hvis du får feilmeldingen:

Error occurred during initialization of boot layer

Så er det noe galt med installasjon av noen tillegg. For å fikse dette kan du høyreklikket på et av prosjektene (f.eks foreksempel) og velge Maven > Update Project. Huk av som på bildet og velg Ok.