SvnOchTrac
I projektet kommer Subversion (SVN) att användas i stället för CVS. Den främsta anledningen är att SVN kan kopplas ihop med projekthanteringssystemet Trac. Varje team får ett eget SVN-repositorium och en egen Trac, se Team-sidan. För att använda SVN inifrån Eclipse behöver du installera en plugin som heter Subclipse.
Nedan följer information om
- SVN
- Subclipse
- Installera pluginen (på studentdatorerna)
- Check out (checka ut projekt)
- Update och Commit
- Synchronize
- Share project (lägga upp nytt projekt i repot)
- Egen dator
- Mer information
- Trac
SVN
SVN är modernare än CVS, men den grundläggande modellen är densamma: Från ett repositorium på en server kan man checka ut en kopia till sin dator. Därefter kan man sedan ändra filerna lokalt, och sedan göra update och commit.
Man kan köra SVN från kommandoraden med kommandot svn
.
Dokumentation:
- Subversions hemsida: http://subversion.apache.org/
- On-line bok om Subversion: http://svnbook.red-bean.com/
Subclipse
Subclipse är en Eclipse-plugin som gör att du kan använda SVN inifrån Eclipse. Du måste själv installera den.
Installera pluginen
Obs! Om du tänkt installera Subclipse-pluginen på din egen dator, se "Egen dator" nedan först.
- Starta eclipse
- Installera Subclipse:
- Help → Install New Software
- Add http://subclipse.tigris.org/update_1.6.x
- Select All
- Följ installations-instruktionerna, inklusive att till slut starta om Eclipse. Om något paket inte kan installeras, t.ex. "Subclipse Integration for Mylyn" eller "Subversion Revision Graph Library", prova att klicka bort dem och installera de andra paketen.
- Gå till Window → Preferences, öppna Team, välj SVN.
- Välj SVNKit i drop-down-menyn.
Check out
Antag att det finns ett Eclipse-projekt i repot som du vill checka ut så du kan jobba med det i Eclipse. Gör så här:
- Gå över till Subversion-perspektivet: Window → Open Perspective → Other → SVN Repository Exploring
- Lägg till ett repostitory location genom kontext-menyn New → Repository Location
- Fyll i ett lämpligt namn, t.ex. (med lämpliga siffror istället för XX) http://svn.cs.lth.se/svn/eda260/vt13/teamXX
- Du kan nu titta på innehållet i repot.
- Välj det projekt du vill checka ut och gör Check Out i kontext-menyn.
- Gå över till Java-perspektivet där projektet ska ha dykt upp.
Update och commit
Update och commit görs på samma sätt som när man använder CVS: välj projektet, och sedan gör Team → update/commit i kontext-menyn. Eclipse håller själv reda på om det är ett SVN eller CVS projekt och använder rätt slags update/commit.
Synchronize
I samband med update/commit är det mycket praktiskt att använda något i Eclipse som kallas Synchronise view. Då kan man enkelt se vilka av ens filer som är ändrade eller gamla jämfört med repot. Välj ditt projekt och gör Team → Synchronize with repository. (Detta fungerar både för CVS och SVN-projekt.)
Hur man lägger upp ett nytt projekt i repot (Share project)
Om du har skapat ett nytt Java-projekt och vill lägga till det till repot gör du så här:
- Välj Java-projektet i Eclipse package explorer
- Gör Team → Share project...
- Välj typ av repository (SVN)
- Välj ett lämpligt repo-namn, t.ex. (med lämpliga siffror istället för XX) http://svn.cs.lth.se/svn/eda260/vt13/teamXX
- Välj Use specified folder name och fyll i namnet trunk/Project (om projektets namn är Project), och avsluta. Se mer information om trunk nedan.
- Nu finns projektet i repot, men det är inte committat än. Välj ut projektet och gör Team → commit.
Angående trunk: Det är en konvention i SVN att ha de tre katalogerna trunk, branches och tags överst i repot, och att checka in sina projekt under trunk. Detta är praktiskt om man senare vill använda sig av branches och tags.
Egen dator
Om du tänkt installera Subclipse på din egen dator, kontrollera först vilken SVN-version du har installerad:
svn --version
Om det är en annan version än 1.6, kontrollera på Subclipse hemsida vilken version av plugin-en du skall ladda ner. Genom att se till att Subclipse-versionen är kompatibel med den svn du kör från kommandoraden så går det bra att göra svn från kommandoraden på de projekt du checkat ut via Eclipse.
Mer information
Vill du veta mer om Subclipse, se http://subclipse.tigris.org/
Trac
Trac är ett system för att hantera mjukvaruprojekt. Här är några viktiga funktioner och begrepp i Trac:
- Wiki. Typiskt använder man den för intern information om projektet och teamet.
- Tickets. Tickets används för att representera uppgifter som skall utföras, t.ex. stories, eller features och buggfixar, etc. Man kan skapa nya tickets efter behov, och det går lätt att se vilka tickets som är klara och i vilket stadium andra är. I en ticket kan man lägga information om uppgiften, t.ex. vilka tasks den består av, hur de lösts, och vilka commits som relaterar till uppgiften.
- Timeline. Här kan man se alla ändringar i wikin, i tickets, och commits i SVN-repot. Den är mycket praktisk för att kunna se vad som hänt sedan sist. Man kan t.ex. direkt se källkodsändringar för en viss commit. Timeline-informationen finns också som RSS feeds; mycket praktiskt om man använder RSS.
- Roadmap. Här kan man dela upp arbetet (tickets) i milestones, t.ex. en för varje iteration och/eller release.
- Browse source. Man kan bläddra i repots källkod direkt från Trac, och se diffar mellan olika versioner.
- Admin. Man kan konfigurera Trac och till exempel definiera vilka typer av tickets som skall finnas och vilka komponenter programvaran är uppdelad i.
Dokumentation om Trac: