SVN-Server installieren und in EClipsePDT einbinden
Aus wiki.tommy-schmidt.de
Um eigene Projekte im Team besser bearbeiten zu können, empfiehlt es sich eine moderne Quellcode-Verwaltung mit Versionierung zu verwenden. Ich möchte anhand eines Beispiel-Projektes unter Windows die Installation und Verwendung eines Subversion-Servers und die Anbindung an die Entwicklungsumgebung EclipsePDT für PHP-Entwickler erklären. Als Betriebssystem verwende ich die Windows Vista Business Edition, die für Studenten über die MSDN Academic Alliance [1] bezogen werden kann. Als Hardware dient mir ein stromsparendes Intel Atom System, welches über Port-Forwarding einer AVM-Fritzbox auch von außerhalb meines Heimnetzes erreicht und somit von anderen Entwicklern auf die Quellcode-Verwaltung zugegriffen werden kann.
Inhaltsverzeichnis |
[bearbeiten] SVN-Server installieren
Zu Beginn laden wir uns die freie Version des VisualSVN-Servers herunter [2] und installieren diese mit den angebotenen Standard-Einstellungen.
Nach der Installation kann der "VisualSVN Server Manager" direkt oder über das Windows-Startmenü geladen werden.
Wenn man bei der Installation alle Standard-Einstellungen belassen hat, wird direkt ein Dienst unter Windows registriert und der SVN-Server gestartet. Dies kann man auf Wunsch nachträglich über die Systemsteuerung ändern.
[bearbeiten] Neues Repository anlegen
Als nächstes wollen wir ein Repository anlegen, welches als Datenbehälter für unser neues Projekt dienen soll. Dazu klickt man einfach mit der rechten Maustaste auf "Repositories" im linken Bereich des Programmfensters und dann anschließend auf "Create New Repository". Wir entscheiden uns für "PHPSampleProject" als "Repository Name" und bestätigen mit OK.
Wie man sieht, schreibt das Programm bereits automatisch die Repository URL (https://vista:8443/svn/PHPSampleProject) unter der das Projekt dann später erreichbar sein wird.
[bearbeiten] Neuen Benutzer anlegen
Nun wollen wir noch einen Benutzer einrichten, der Zugriff auf unseren Datenbehälter erlangen soll. Mit der rechten Maustaste auf "Users" -> "Create User..." klicken und das erscheinende Formular ausfüllen.
Nun haben wir schon einiges an Arbeit gemacht und wollen uns über den Erfolg unserer Aktionen informieren. Dazu klickt man einfach unter "Aktion" auf "Browse". Der Standard-Browser sollte geöffnet werden und eine Abfrage von Benutzername und Passwort erscheinen. Wir geben die Daten des Benutzers den wir eben angelegt haben ein und bestätigen den Dialog. Nun sollten wir Zugriff auf unser noch leeres Repository erhalten.
[bearbeiten] SVN in EclipsePDT einbinden
Im nächsten Schritt wollen wir unsere neue Quellcode-Verwaltung in EclipsePDT [3] einbinden. Die Installation und Einrichtung der Entwicklungsumgebung setze ich hier voraus, sie bildet die Grundlage für die nächsten Schritte. Da in der aktuellen Version von EclipsePDT leider noch keine SVN-Unterstützung existiert, muss man sich hier eines Plugins bedienen. Ich habe mich für Subclipse [4] entschieden. Die Software ist recht schnell installiert, einfach in Eclipse auf "Help" -> "Software Updates" -> "Find and Install" gehen und danach "Search for new features to install" wählen. Mittels "Next" kommt man zum nächsten Dialog, in dem man "New Remote Site" wählt. Je nach verwendeter Eclipse-Version muss man nun zwischen den vorhandenen Update-Seiten die Subclipse bietet wählen. Da ich hier keinen aktuellen Stand der Adressen anbieten kann, möchte ich einfach auf die Installations-Seite von Subclipse verweisen, unter der man immer die aktuellen Versionen aufgelistet bekommt [5].
Der Dialog wird nach Eingabe der Adresse bestätigt und der Vorgang mit "Finish" abgeschlossen. Eclipse durchsucht nun die Remote-Seite nach Updates und sollte das Subclipse-Plugin anbieten. Selektiert man dieses nun, bekommt man sehr wahrscheinlich einen Abhängigkeits-Fehler, da das Modul "Integrations (optional)" noch das Paket "org.eclipse.mylyn.tasks.core" benötigt. Für alle die wie ich diese Komponente nicht installiert haben, empfiehlt es sich einfach dieses Feature zu deselektieren, da wir es für unsere Zwecke ohnehin nicht benötigen.
Der Vorgang wird mit "Next" fortgesetzt und anschließend die License Agreements bestätigt um weitermachen zu können. Nachdem alle weiteren Dialoge abgearbeitet wurden, wird das Plugin letztendlich halbautomatisch runtergeladen und installiert. Ein kurzer Neustart von Eclipse ist notwendig um das System zu aktualisieren.
[bearbeiten] SVN unter EclipsePDT verwenden
Nun wird es endlich spannend, denn wir wollen mittels unserer Entwicklungsumgebung auf den vorher eingerichteten SVN-Server zugreifen. In Eclipse wählen wir unter "File" -> "Import" und selektieren im erscheinenden Dialog "SVN" -> "Checkout Projecs from SVN".
Im nächsten Schritt wählen wir "Create a new repository location" und geben anschließend die Adresse unseres Servers inkl. Repository-Verzeichnis ein.
Danach muss man ggf. noch das Sicherheitszertifikat bestätigen und Benutzername und Passwort des Users den wir bereits auf dem VisualSVN-Server angelegt haben eingeben. War die Authentifizierung erfolgreich, kann man das Projekt vom SVN-Server auschecken (checkout) und sich somit einen initialen Stand holen. Lediglich ein Zwischenschritt ist noch notwendig, in dem man wählt, ob man die Struktur eins zu eins vom Server übernehmen, oder den "New Project Wizard" von Eclipse verwenden will um ggf. die Daten in eine eigene Verzeichnisstruktur zu übertragen. Wir entscheiden uns für "Check out as a project in the workspace".
[bearbeiten] Mit einem SVN-Projekt arbeiten
Da unser ausgechecktes Projekt noch keine Daten enthält, wollen wir ein Verzeichnis und eine PHP-Quelldatei anlegen, die wir anschließend wieder auf dem Server einchecken und somit für andere Entwickler mit Zugang zum System zur Verfügung stellen. Mit Rechtsklick auf unser Projekt im PHP Explorer wählen wir "New" -> "Folder" und geben einen Namen ein (z.B. "lib"). Wieder mit der rechten Maustaste auf den neu angelegten Ordner wählen wir diesmal "New" -> "PHP File" und geben der Datei einen Namen, z.B. "index.php". Ein wenig Beispiel-Code kann auch nicht schaden:
<?php echo "Hello world"; ?>
Nun wollen wir die Daten auf den SVN-Server übertragen. Dazu gehen wir wieder mit der rechten Maustaste auf unseren Projektordner und wählen diesmal "Team" -> "Update" und danach "Team" -> "Commit" um die Übertragung auch wirklich durchzuführen.
Es empfiehlt sich auch bei jedem Commit einen kurzen Kommentar über die Änderungen oder Arbeiten, die man gemacht hat, einzugeben um alle Vorgänge zu dokumentieren.
[bearbeiten] Abschlussbemerkung
Um nun wirklich im Team arbeiten zu können empfiehlt sich das Anlegen weiterer Benutzer auf dem SVN-Server, sowie das Experimentieren mit den einzelnen Funktionen, die das verwendete Eclipse-Plugin mitbringt.
Ich hoffe mit dieser kurzen Anleitung einen Einblick in die wirklich praktische Arbeit mit Subversion bringen zu können.
