Innstallasjon av plugins til Eclipse
Denne enkle tutorialen viser hvordan man kan installere de eclipse plugins som benyttes i INF5120 (vil bli oppdatert etterhvert med info om ATL og MOFScript).
For ? bruke de plugins som vi skal bruke i kurset trenger en Eclipse 3.2
eller nyere. Eclipse kan lastes ned fra http://www.eclipse.org/downloads/
som en zip-fil. For ? installere trenger en kun ? pakke ut filene.
Dette kan man gj?re b?de hjemme, og p? sitt eget omr?de p? skolen ved ? lage en extension location. De som bruker egen maskin, og ikke ?nsker ? opprette en extension location kan hoppe over det f?rste steget.
1 Opprettelse av
extension location
En extension location er en mappe som gj?r det mulig ? installere eclipse plugins p? et annet omr?de eller i en annen mappe enn der selve eclipse applikasionen ligger. Dette er ikke n?dvendig dersom en sitter p? sin egen maskin, men det kan v?re en grei m?te ? holde orden i sine eclipse plugins dersom en bruker eclipse til mange form?l. En kan for eksempel ha en extension location fro modellering og en for C++ programmering osv osv. Dette kan ogs? v?re fornuftig dersom en bruker forskjellige eclipse plugins som gir konflikter seg i mellom, ettersom de forskjellige extensioin locations kan enbles eller disables alt ettersom.
For ? opprette en extensionlocation oppretter man en mappe et sted p? omr?det sitt som heter 'eclipse'. Denne m? inneholde en mappe som heter 'plugins', og en som heter 'features', samt en fil som heter '.eclipseextension'. Dersom en sitter p? en Windows PC f?r en antagelig vis ikke lov ? opprette en fil som begynner med '.', men dette kan man gj?re f.eks i eclsipse (filen kan opprettes under et hvilket som helst prosjekt) eller i Notepad. Det er ikke sikkert at filen blir synelig i package exploreren i eclipse, men den ligger under prosjekt mappen i workspacet, og kan klippes ut derfra og limes inn i den nylig opprettede eclipse folderen.
Man kan s? legge til extension locationen ved ? starte eclipse og velge Help -> Software Updates -> Manage Configurations fra menyen ?verst:
Deretter velger man linken add an Extensionlocation fra menyen til h?yre i bildet som kommer opp:
Man vil da f? en dialog boks der det st?r at eclipse m? restartes. N?r eclipse starter opp igjenn kan man g? til Manage Configuration igjenn, for ? sjekke at alt er som det skal. Extension locationen skal n? vises:
Extension locationen kan disables ved en senere anledinging dersom dette er ?nskelig ved ? velge Disable i menyen til h?yre.
2 Installasjon av EMF
og GMF plugins
Vi vil her vise hvordan EMF og GMF kan installeres ved hjelp av update funksjonen i eclipse. Dette kan selvf?lgelig ogs? gj?res 'manuelt' ved ? laste ned pluginsene som zip-filer, og pakke dem ut i eclipse folderen. Dette kan imidlertid v?re litt mer knotete, ettersom en ogs? m? passe p? ? f? med diverse plugins som EMF of GMF er avhengig av.
G? til Help
-> Software Updates -> Find and Install:
Velg Search for new features to install i dialogen som kommer opp, og trykk Next. I vinduet som kommer opp kan en legge til nye update sites, eller velge en av de som er der for ? s?ke etter nye features eller updates. Vi skal velge Callisto Discovery Site.
N?r du har trykket Finish og valge et mirror vil f?r du en liste med features som kan installeres. Velg Eclipse Modeling Framework (EMF) og Graphical Modeling Framework under Models and Model Development, og trykk p? nappen Select Required til h?yre i bildet. Update manageren vil da ta med de features som trengs (en kan selvf?lgelig ta med andre features dersom dette er ?nskelig, men det er ofte lurt ? kun ta med de man trenger, ettersom dette er lettere ? h?ndtere met tanke p? oppdateringer og eventuelle konflikter mellom plugins etc). Trykk deretter Next.
I neste steg kan en bare velge accept terms of use og Next. I den neste
dialogen kan en velge hvor de valgte plugins skal installeres. Dersom en ?nsker
? legge dem i en extension location m? man trykke p? knappen Change Location
(tror dete skjer automatisk p? skolen), og velge riktig locaton (Dette m?
gj?res for hver enkelt feature). Ellers kan en bare trykke Finish.
N?r installasjonen er ferdig og man har startet eclipse p? nytt kan man g? inn i Manage Configuration (File-> Software Updates -> Manage Configuration) ? kontrollere at de nye pluinsenen er installert:
F?r man begynner ? ta i bruk GMF b?r en ogs? g? til Window -> Preferences... -> Java -> Compiler, og kontrollere at Generated .class files compatibility og Source Compatibility er satt til 1.4 eller h?yere. Ellers vil en f? feil i den genererte koden
3 Installasjon av ATL plugin
Last ned ATL Development Tools (ADT) plugin for eclipse: ?ADT 20060630 (withMDR4ATL)? fra http://www.eclipse.org/m2m/atl/download/.
Pakk denne ut direkte til den mappa du ?nsker ? installere ADT til, dvs. enten mappa ?eclipse? som inneholder eclipse installasjonen, eller mappa ?eclipse? som er en extension location. P? denne m?te havner plugins automatisk under plugins mappa. Eventuelt kan en pakke ut filene et annet sted, for deretter ? copy-paste dem in i ?plugins? folderen.
For at ADT skal fugere trenger en ogs? ANTLR (ANother Tool for Language Recognition). Dette er en jar fil: antlr-2.7.5.jar, som kan lastes ned fra http://www.antlr.org/download.html. OBS!! pass p? at fila f?r navnet ?antlr.jar? (dersom en bruker Windows vil antagelig filtypen som foresl?s v?re .zip). Dersom en fila f?r et annet navn en ?antlr.jar? vil ikke ADT finne den.
N?r fila er lastet ned, kan den copy-pastes inn i ?eclipse\plugins\org.atl.eclipse.engine_1.0.7\lib? (?eclipse\plugins? mappen er den samme som ADT nettop ble installert i).
4 Installasjon av MOFScript plugin
Mofscript benytter seg av en plugin som heter ANTLR (i motsetning til ATL pluginen, som bare benytter en ANTLR-jar fil). Denne m? alts? installers f?rst: G? til update manager (Sofware Updates -> Find and Install velg Search for new features to install og trykk Next ). Velg New Remote Site...? i menyen p? h?yre side. Klipp s? ut http://antlreclipse.sourceforge.net/updates/ og lim den inn i URL feltet. Gi s? update siten et passende navn, feks ?ANTLR?. S?rg s? for at ANTLR update siten er huket av, og trykk Finish. Resten av installasjonen er den samme som beskrevet om installasjon av GMF.
Mofscript kan installeres p? samme m?te, ved ? g? til update manageren igjenn, og legge til en ny Remote Site, og skrive/lime inn http://www.modelbased.net/mofscript/update/. Denne update siten kan gjerne kalles MOFScrtipt.