lu.se

Denna sida på svenska This page in English

SVN och Trac

Obs! En OS-uppdatering av studentdatorerna har påbörjats 11 januari och kommer att fortsätta även under läsvecka 1. Det kan därför hända att vissa datorer inte kan kommas åt förrän läsvecka 2.

I projektet kommer vi att använda Subversion (svn) i stället för cvs. Med hjälp av en Eclipse-plugin som heter Subclipse, kommer Eclipse att fungera i stort sett likadant som cvs, med t.ex. samma update och commit-kommandon. En fördel med svn är att den kan integreras på ett bra sätt med ett wikisystem som heter trac.

Varje team får ett eget svn-repository och en egen trac som är kopplad till svn-repot:

(ersätt XX med ditt team-nummer: 01, 02, etc.). Inloggning krävs. Använd samma login som för cvs på labbarna.

Nedan följer information om

  • Installation av Subclipse på studentdatorerna
  • Installation av Subclipse på egen dator
  • Hur man checkar ut ett befintligt projekt (Check out)
  • Hur man gör update och commit
  • Hur man lägger upp ett nytt projekt i repot (Share project)
  • Reservlösning (CVS)

Installation av Subclipse på studentdatorerna

Varje användare måste själv installera Subclipse-pluginen. Den läggs i en katalog som heter ~/.eclipse

Gör så här:

  • Logga in på en av Linux-datorerna.
  • Starta eclipse
  • Kontrollera att det är rätt eclipse-version: Help->About Eclipse. Det skall stå Eclipse 3.5. Om det står 3.4 är datorn inte uppdaterad än, och du måste vänta med installationen.
  • Installera först Graphical Editing Framework:
  • Installera därefter Subclipse:
    • Help->Install New Software
    • Add http://subclipse.tigris.org/update_1.4.x
    • Installera alla paketen utom "Subclipse integration for Mylyn" (såvida du inte redan använder Mylyn)
    • Följ instruktionerna, inklusive att till slut starta om Eclipse
  • Nu kan du i fortsättningen använda svn.

Obs! Det är första gången vi använder svn i kursen. Om någonting är svårt att få att fungera, försök i första hand reda ut det inom teamet. I andra hand försöker vi reda ut det inom coachgruppen. Om viktig information borde stå här, meddela gorel@cs.lth.se. Om stora problem skulle uppstå kan teamet gå över till att använda cvs istället, se längre ner.

Installation av subclipse på egen dator

Du installerar subclipse nästan på samma sätt på din egen dator som på studentdatorerna. Kontrollera dock först om du har en native svn på din egen dator genom att skriva

   svn --version

i ett kommandofönster. Om du har svn 1.4 eller 1.5 skall du använda http://subclipse.tigris.org/update_1.4.x. Om du har svn 1.6 skall du istället använda http://subclipse.tigris.org/update_1.6.x.

Anledningen är att svn 1.6 använder ett nytt sätt att lagra metainformationen i sandlådan. Om du omväxlande använder svn från kommandoraden och från Eclipse kan du få problem: En svn 1.4 eller 1.5 kommer inte att förstå sig på sandlådan om svn 1.6 har varit framme och lekt i den. Informationen i själva repot är opåverkad så det går bra att committa till samma repo från olika sandlådor som använder olika svn-versioner.

Hur man checkar ut ett befintligt projekt (Check out)

Antag att det finns ett 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 SVN Repositories vyn -> Context Menu -> New -> Repository Location
  • Fyll i ett lämpligt namn, t.ex. http://torvalds.cs.lth.se/svn/gu/eda260/vt10/teamXX
  • Du kan nu titta på innehållet i repot.
  • Välj det projekt du vill checka ut. Context Menu -> Check Out.
  • Gå över till Java-perspektivet där projektet ska ha dykt upp.

Hur man gör update och commit

Update och commit görs som vanligt genom att man väljer projektet, context menu -> Team -> update/commit. Eclipse håller själv reda på om det är ett SVN eller CVS projekt och använder rätt slags update/commit.

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
  • Context Menu->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://torvalds.cs.lth.se/svn/gu/eda260/vt10/teamXX
  • Välj ett lämpligt namn på projektet och avsluta.
  • Nu finns projektet i repot, men det är inte committat än. Så troligen skall du nu gå vidare och committa enligt ovan.

Obs! 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. När du gör ett projekt kan du i så fall fylla i namnet trunk/Project, istället för bara Project, och trunk kommer då att skapas automatiskt om den inte redan finns. Du kan också strunta i detta så länge och flytta ner projekten under trunk senare, om du skulle vilja börja använda branches.

Reservlösning (CVS)

Eftersom det är första gången vi använder svn i kursen vet vi inte riktigt hur det kommer att gå. Om det mot förmodan visar sig krångla för mycket med svn och/eller subclipse så går det bra att ett team går över och använder CVS istället. I så fall skall följande repos användas:

Sidansvarig: