Software(technik)praktikum: SVN-Tutorial
Übersicht Kurz: Übersicht VKM (siehe auch Vorlesungs-Folien) Werkzeuge Grundsätzliches Integration in Eclipse Praktische Übung mit SVN Commits, Updates, Konflikte lösen Branch/Merge (wenn noch Zeit) Weitere Tipps
Versions- und Konfigurationsmanagement Beobachtung: Software besteht aus vielen verschiedenen Dokumenten (Anforderungen, Design, Programmcode, Dokumentation, Handbuch, ) Software-Entwicklung ist Teamarbeit Konsequenz: Viele verschiedene Personen greifen auf dieselbe Menge von Dokumenten zu Oft bearbeiten verschiedene Personen gleichzeitig (unabhängig voneinander) dasselbe Dokument Bearbeitungs-Konflikte vermeiden
Synchronisation von Dateien Repository edit src Main.java App.java doc index.html main.html Update Commit src Main.java,v App.java,v doc index.html,v main.html,v SVN Update Commit edit src Main.java App.java doc index.html main.html Benachrichtigung (z.b. per E-Mail)
Werkzeuge Concurrent Versions System (CVS) Älteres System Subversion (SVN) Versionierung des kompletten Projektarchivs anstatt einzelner Ressourcen Bessere Unterstützung für Erstellen, Löschen, Umbenennen Besserer Umgang mit Binärdaten Lokale Kopien des Basis -Versionen der Ressourcen
Subversion trunk Haupt-Entwicklungszweig In der Regel arbeitet man darin branches Neben-Entwicklungszweige tags Markierungen für bestimmte Zeitpunkte z.b. Release 1.0 Alles sind Ressourcen in SVN, keine separaten Konzepte für Branches und Tags
Grundsätzliche Tipps (1) Keinen nicht compilierbaren Code einchecken Bugs sind in der Regel kein Problem, es sei denn sie machen das Programm unbenutzbar Für Experimente mit größeren Folgen Branches verwenden Nur notwendige Ressourcen einchecken Keine Ausgabe-Dateien (*.class, ) oder Logfiles In Eclipse: Derived Resources Flag wird oft automatisch gesetzt, kann aber auch manuell gesetzt werden Besser: svn:ignore benutzen
Grundsätzliche Tipps (2) Aussagekräftige Commit-Kommentare Schlecht: ClassA.java geändert Besser: NPE-Bug behoben Gut: Bug #1234 behoben, verursacht durch NPE in ClassA.main() Zeilen nicht zu lang werden lassen Zeilenbasiertes Mischen beim Update Wichtig für LaTeX Binär-Dateien nur wenn nötig, weil automatisches Mischen nicht möglich (Ausnahmen: siehe Folie 18) Konflikte schwer zu beheben
Eclipse: Subversive (1) http://www.eclipse.org/subversive/ documentation/gettingstarted/ aboutsubversive/install.php Help Software Updates Available Software, Add Site SVN Update Sites: http://download.eclipse.org/technology/ subversive/0.7/update-site/ http://www.polarion.org/projects/ subversive/download/eclipse/2.0/ update-site/
Eclipse: Subversive (2) Subversive-Eclipse-Plugins Benötigt: SVN Team Provider mind. einen SVN Connector, z.b. SVNKit, JavaHL Optional: SVN Team Provider Localization SVN Integration for Mylyn SVN JDT Ignore Extensions Eines von vielen Tutorials: http://cs.wustl.edu/~cytron/cse132/helpdocs /Subversive/subversive.htm
Eclipse: Subclipse Eine Alternative zu Subversive ist Subclipse: http://subclipse.tigris.org/ Außerhalb von Eclipse bietet sich unter Windows der SVN-Client TortoiseSVN an: http://tortoisesvn.tigris.org/ 13.03.2012 11
Praktische Übungen Diese Übungen können im Team-Repository durchgeführt werden Tipp: Teams bilden zu je zwei Leuten (A / B) und gemeinsam arbeiten
Übung 1: Neue Klasse Check Out https://svn-serv-lab.cs.upb.de/swtpra2012-xy bzw. https://svn-serv-lab.cs.upb.de/sopra2012-xy A: Neue Datei 1. Neue Klasse erstellen: Factorial.java 2. Fakultäts-Funktion public static long fac(int n) rekursiv implementieren 3. Team Synchronize (auf Projekt) 4. SVN Add to version control 5. Commit B: Team Synchronize, Update
Übung 2: Merging Merging 1. A: Methode fac() durch eine iterative Version ersetzen 2. B: Methode public static void printfac() ergänzen, die die Fakultäten von 5 und 10 ausgibt (wichtig: unterhalb von fac()); aufrufen in main()-methode 3. A: Compare with 4. A: Synchronize with Repository, Einchecken 5. B: Compare with 6. B: Synchronize with Repository, Einchecken, Update, Einchecken
Übung 3: Konflikte Konflikte 1. A, B: In der printfac()-methode die Berechnung der Fakultät durch eine Schleife ersetzen, die alle Fakultäten von 1 5 (A) oder 1 10 (B) berechnet 2. B: Einchecken 3. A: Entweder 1. Konflikt auflösen (Doppelklick auf Datei in Sync View, Copy All Non-Conflicting Changes, Rest manuell links anpassen) 2. Commit A: Oder 1. Update und schauen 2. Konflikt auflösen (in Sync View Rechtsklick Edit Conflicts, anschließend Mark as Merged), Commit
Übung 4: Revision History A: Tag erstellen mit dem Namen Version 0.4 von team_#team# A, B: Umgang mit der Versions-Geschichte üben Show History Diverse Compare-Operationen Replace With Revision, Get Content Einfach ausprobieren!
Übung 5: Branch/Merge Branch/Merge 1. A: Neuen Branch erzeugen: Fakultäts-Berechnung mit Caching implementieren Neue Funktion static long fac_cache(int n) wird in fac() aufgerufen Team Branch (Name: test-swtpra12/team_#team# ), Start working in the branch 2. B: Begrenzung auf n 20 in fac() einbauen und einchecken 3. B: Branch mit trunk mergen: Team Merge, URL = branches/test-swtpra12 /team_#team#/de.upb.swtpra12.svntutorial Konflikte lösen, Commit
SVN: Weitere Infos Weitere Informationen auf den WWW- Seiten des Softwaretechnikpraktikums und http://subversion.tigris.org http://svnbook.red-bean.com Weitere Frontends: TortoiseSVN http://tortoisesvn.net/ Unterstützt MS Office, OpenOffice
Übung 6: MS Office Umgang mit Word-Dokumenten 1. A, B: TortoiseSVN installieren 2. A: Word-Dokument anlegen und mit zwei Absätzen versehen, Einchecken 3. B: Update 4. A, B: Beide verändern jeweils einen Absatz 5. A, B: Commit / Update