Instruktioner för utvecklare
Hämta källkod och struktur
Källkoden för TAK hittar du på http://code.google.com/p/skltp/ och instruktioner för att check ut koden på http://code.google.com/p/skltp/source/checkout.
Exempel på checkout kommando (ersätt me@mail.com
med eget användarid på Google Code):
$svn checkout https://skltp.googlecode.com/svn/ skltp --username me@mail.com
Källkoden för TAK hamnar under skltp/tp/tk
med följande struktur:
Bygg TAK
Kör mvn clean install.
$cd ...skltp/tp/tk/trunk $mvn clean install
Integrerad utvecklingsmiljö
Utveckling av källkoden kan göras i olika IDE:er. Ett vanligt verktyg är Eclipse. Nedanstående beskrivning beskriver uppsättning av Eclipse Kepler 4.3 för utveckling av TAK.
Ladda ned Eclipse
Eclipse kan laddas ned här. Välj lämplig distribution för ditt operativsystem, exempelvis Eclipse IDE for Java EE Developers.
När Eclipse är uppstartat behövs en särskild Groovy/Grails-plugin installeras. Detta görs via Eclipse Marketplace... (gäller Kepler 4.3, tidigare versioner kan fungera annorlunda i detta avseende).
Välj Help -> Eclipse Marketplace...
Skriv in "Grails" i sökrutan (du bör få ett resultat som nedan). Välj "Install".
I nedanstående dialog kan installationen anpassas. Bilden visar det som är nödvändigt att installera. Klicka "Confirm"
när du valt klart.
I nästa dialog (om den dyker upp) Välj "Keep my installation the same..." och klicka på "Confirm".
Pluginen installeras sedan. Installationsdialogen kommer be dig om starta om Eclipse för att förändringarna ska gå igenom.
Installera Grails-distribution i Eclipse
För att kunna köra projektet tp-vagval-admin-web inuti Eclipse behövs en Grails-distribution installeras. Denna version är för tillfället 2.2.4 och laddas ned här.
Pack upp distibutionen på lämpligt ställe. Välj Eclipse -> Preferences -> Groovy -> Grails -> Add.. vilket ger följande dialog. Mata in ett lämpligt namn och peka ut distributionen.
Importera tp-vagval-admin-web till Eclipse
Stå i katalogen tp-vagval-admin-web i ett terminalfönster. Skapa konfigurationsfiler för Eclipse genom nedanstående kommando:
mvn eclipse:eclipse
Importera nu projektet i Eclipse genom File -> Import:
Välj "Existing Maven projects":
Välj Browse... - Peka ut projektroten för tp-vagval-admin-web - > klicka "Next"
Trots felen på nästkommande dialog (maven-license-plugin felar) så klicka på "Finish"
I nästa steg kan Eclipse be dig att konvertera projektet till ett Grails projekt som är konfigurerat för användning av STS Grails Tools.
Klicka "Yes".
Nu är projektet importerat till Eclipse, men några fel kan fortfarande finnas (felet med maven-license-plugin går ej att åtgärda för stunden)
Välj Maven -> Update Project... (Detta tar hand om en del fel)
Du kan också ha problem med Groovy compiler:
Detta åtgärdas genom att högerklicka på projektet tp-vagval-admin -> properties -> Groovy Compiler -> Välj 2.1 -> Klicka "Ok"
Starta upp tp-vagval-admin-web
Klicka på den gröna Grails ikonen
Skriv in "run-app" i rutan som dyker upp och tryck Enter
Om allting funkar bör du få nedanstående i ditt konsolfönster
| Loading Grails 2.2.4 | Configuring classpath | Downloading: tp-vagval-admin-core-1.3.3-SNAPSHOT.pom | Downloading: tp-vagval-admin-core-1.3.3-SNAPSHOT.jar. | Environment set to development..... | Packaging Grails application..... | Running Grails application | Server running. Browse to http://localhost:8080/tp-vagval-admin-web
tp-vagval-admin-web är nu uppsatt som ett Grails-projekt i Eclipse.
Starta TAK lokalt för test
För att detta skall fungera krävs att Grails 2.2.4 finns installerat lokalt på din dator. Instruktioner och dokumentation för hur man laddar ner och installerar Grails finns på följande länk http://grails.org/.
Verifiera med följande kommando vilken version av Grails som du har installerat
$grails -version Grails version: 2.2.4
För att starta TAK lokalt och testa kan följande kommandon köras och ge resultatet Server running med adress till startsidan.
$cd ...skltp/tp/tk/trunk/tp-vagval-admin-web $grails run-app | Server running. Browse to http://localhost:8080/tp-vagval-admin-web
Öppna startsidan i en web läsare:
Logga in i lokal testmiljö med användaren admin
som har lösenordet admin
. Startsidan skall nu visas: