Zasady korzystania z systemu wersji SVN na laboratoriach

Pomoc do laboratoriów
Temat : Korzystanie z systemu kontroli wersji
SVN w trakcie laboratoriów
Historia zmian
Data
2012.03.08
Wersja
1.0
Autor
Tomasz Kowalski
Opis zmian
Utworzenie dokumentu i wstawienie treści
1. Cel
Głównym celem tego dokumentu jest określenie zasady korzystania z repozytorium SVN w
trakcie zajęć laboratoryjnych.
2. Zasoby
2.1. Wymagane oprogramowanie
Omawiane polecenia będą dotyczyły dowolnego klienta svn. Na zajęciach w systemie
Windows zalecane jest korzystanie w klienta TortoiseSVN 1 lub klienta Subclipse2 zintegrowanego
ze środowiskiem Eclipse
2.1. Materiały pomocnicze
•
•
•
•
•
Materiały dostępne w Internecie:
http://subversion.tigris.org/ - Strona główna projeku SVN.
http://pl.wikipedia.org/wiki/Subversion - Polska strona WIKI dotycząca SVN.
http://svnbook.red-bean.com/ - Podręcznik do SVN (wersja angielska).
http://svnbook.opensys.pl/ - Podręcznik do SVN (wersja polska).
http://team.kis.p.lodz.pl:8080/svn/dydaktyka/pio/lab1/ - Pomoce do laboratorium z Podstaw
inżynierii oprogramowania
3. Laboratorium
Rozpoczęcie laboratoriów
1. Sprawdź czy odpowiedni klient svn jest zainstalowany.
2. Utwórz folder. Wewnątrz swojego katalogu utwórz standardową strukturę projektu, tj.
podkatalogi:
•
branches – folder pomocniczy na potrzeby testowania eksperymentalnej
funkcjonalności (nie musi być używany w ciągu zajęć).
•
tags – folder zawierający tzw. snapshot-y projektu wykonywane pod koniec każdych
zajęć w kolejnych pod-folderach (lab1, lab2,... ). Snapshot należy wykonać używając
polecenia svn copy (w tortoiseSVN opcja Branch/tag...) z źródłem ustawionym na
folder trunk w zdalnym repozytorium i docelowym folderem labX. Zmiany w
folderze trunk powinny zostać uprzednio zacommitowane.
•
trunk – zawierający biężącą wersje projektu, ale bez folderów automatycznie
generowanych przez narzędzia (np. bin, target). Standardowo w celu pracy na
lokalnej wersji repozytorium należy wykonać svn checkout wyłącznie na
folderze lub podfolderach trunk.
3. Zaimportuj (svn import) zawartość swojego folderu do repozytorium svn o adresie podanym
przez prowadzącego (w tortoiseSVN opcja Import) do podfolderu o nazwie imię_nazwisko.
W tym folderze na repozytorium mają być przechowywane wyniki Twoich prac na
laboratoriach w postaci projektów Java w środowisku Eclipse.
1 http://tortoisesvn.tigris.org/
2 http://subclipse.tigris.org/
Kontynuacja pracy z repozytorium
4. W celu synchronizacji swojej pracy na laboratorium z repozytorium svn na PUSTYM nowo
utworzonym folderze na dysku wykonaj checkout Twojego folderu trunk na repozytorium
zdalnym (w tortoiseSVN opcja SVN checkout...). W ten sposób tworzy się tzw. kopię
roboczą.
W trakcie laboratorium
5. W celu zapisania bieżących zmian w kopii roboczej (wybranych lub wszystkich) na
zdalnym repozytorium svn należy użyć operacji svn commit. Powrót do określonej rewizji
jest możliwy za pomocą svn update (w tortoiseSVN opcja Update to revision...).
6. UWAGA: przechowywanie folderów bin, target w repozytorium jest niewskazane. Brak
lub mała kontrola nad zmianami w tym folderze utrudniają prace z repozytorium svn.
W tortoiseSVN użyj opcji ...add to ignore list...
Zakończenie laboratorium
7. W celu „otagowania” pracy zatwierdź wszystkie zmiany (svn commit). Następnie wykonaj
polecenie svn copy (tortoiseSVN opcja Branch/tag...) ze źródłem ustawionym na kopię
roboczą (operacja svn copy zostanie wykonana na folderze trunk w zdalnym repozytorium)
i docelowym folderem (np. …/tags/lab1).
8. UWAGA: wyniki prac na laboratorium muszą być każdorazowo umieszczane w
repozytorium SVN w odpowiednim pod-folderze folderu tags. Braki w tym zakresie są
równoważne z brakiem obecności na zajęciach.
Repozytorium testowe
W celu przetestowania opisanych scenariuszy pracy i wykonywanych operacji można wykorzystać
repozytorium testowe znajdujące się pod adresem:
http://team.kis.p.lodz.pl:8080/svn/test/