ImageLink(subversion_logo.gif, http://subversion.tigris.org) BR siehe auch: TableOfContents

Subversion Repository

Die Quellen der FlightCtrl und BL-Ctrl sind jeweils in einem Subversion Projektarchiv (Repository) hinterlegt.

Um die Quellen bearbeiten zu können, muss man sich einen Subversion Client (siehe unten) installieren. Dann kann man die Quellen 'auschecken'.

Man kann aber auch mit dem Browser durch das Projektarchiv blättern:

BR FlightCtrl - Projektarchiv:

• http://mikrocontroller.cco-ev.de/mikrosvn/FlightCtrl/

BR BL-Ctrl - Projektarchiv:

• http://mikrocontroller.cco-ev.de/mikrosvn/BL-Ctrl/

Verzeichnisstruktur

• /trunk/:

• die aktuelle Codeversion an der gearbeitet wird (nicht unbedingt lauffähig!)

• /tags/:

• freigegebene Versionen (z.B. /tags/V0.60/)

• /branches/:

• Test- und Sonderversionen

Einige Begriffe

• Checkout bzw. Ausschecken:
• damit ist das Herunterladen von Dateien aus dem Projektarchiv auf die lokale Festplatte gemeint.
• Commit bzw. Übertragen:
• ist das Zurücksichern der lokalen Arbeitskopie in das Projektarchiv

. ToDo: ergänzen

Windows Client: TortoiseSVN

attachment:tortoisesvn_logo.gif

TortoiseSVN ist ein einfach zu verwendender Subversion Client für Windows.

Er erweitert das Kontextmenü des Windows-Explorer mit den notwendigen Befehlen des Versionskontroll-Systems:

attachment:subversion_kontext1.gif

Installation

• TortoiseSVN-Homepage: http://subversion.tigris.org

  • Download-Seite: http://tortoisesvn.net/downloads

  • Übersicht Sprachpakete: http://tortoisesvn.net/translator_credits

Man installiert zuerst TortoiseSVN und dann gleich hinterher das deutsche Spachpaket. Danach ist meist ein Neustart von Windows erforderlich.

Spache auf 'Deutsch' umstellen

Im Windows-Explorer irgendwo die rechte Maustaste drücken und im Kontextmenü TortoiseSVN und dann Settings auswählen. Im folgenden Dialog dann auf deutsche Sprache umschalten und bestätigen:

attachment:subversion_sprache.gif

Das war es schon

Dateien ausschecken

Wie bekomme ich jetzt die Daten aus dem Projektarchiv auf meinen Rechner ??

Dazu legt man sich zuerst ein leeres Verzeichnis auf seiner Festplatte an, welches die lokale Arbeitskopie aufnehmen soll:

• z.B. C:\SVN\FlightCtrl

Dann muss man sich entscheiden, welche Daten man eigentlich haben möchte.

Das kann z.B. die aktuelle Codeversion (/trunk) oder vielleicht ein bestimmter (lauffähiger !) Versionsstand (/tags/) sein.

Dateien lokalisieren

Wir gehen mal beispielhaft davon aus, dass wir die eine freigegebene Version (/tags/) der FlightCtrl-Software haben möchten.

Wir blättern durch das FlightCtrl-Projekt: http://mikrocontroller.cco-ev.de/mikrosvn/FlightCtrl/

Im Verzeichnis /tags/ befinden sich die unterschiedlichen Versionen. Wir sehen dort z.B. die V0.60.

Die Adresse lautet also: http://mikrocontroller.cco-ev.de/mikrosvn/FlightCtrl/tags/V0.60/

Dateien übertragen

Um die Daten zu erhalten, klicken wir mit der rechten Maustaste im Windows-Explorer auf unseren neu angelegten Ordner 'FlightCtrl'):

attachment:subversion_checkout.gif

Es erscheint ein Dialog, wo wir unsere gefundene URL eintragen und dann OK klicken:

attachment:subversion_checkout2.gif

Daraufhin werden die Dateien der V0.60 in das lokale Verzeichnis kopiert.

• FERTIG

Dateien ins Projektarchive übertragen

Es ist nur den Entwicklern möglich, Daten ins /trunk/ und /tags/ Verzeichnis Projektarchiv zu übertragen.

Änderungen oder Verbesserungen können als Patches an die Entwickler geschickt werden.

Jeder kann aber Daten ins /branches/ - Verzeichnis übertragen und so dort seine Arbeit sichern und teilen.

Eigene Version anlegen

Als Beispiel:

• Wir wollen die FlightCtrl-Software weiterentwickeln (z.B. anderer Kompass)

• Basis soll die letzte veröffentliche Version sein

Als erstes übertragt man sich die Version, die man als Basis verwenden möchte, auf sein System (wie zuvor beschrieben).

Dann erstellt man eine Verzweigung (branch). Man klickt mit der rechten Taste auf erstellte lokale Verzeichnis, in dem sich jetzt die aktuelle Version befindet).

In unserem Beispiel also auf C:\SVN\FlightCtrl.

Dann wählt man aus dem Kontextmenü TortoiseSVN und dann Verzweigen / Markieren:

attachment:subversion_branch1.gif

Dann trägt unter zu URL den Namen der neuen Verzweigung ein. Es ist gut, ein paar Infos im Namen unterzubringen (Version, was ist besonderes, Ersteller).

Das Ganze muss unter /branches/ angelegt werden, also z.B. :

• http://mikrocontroller.cco-ev.de/mikrosvn/FlightCtrl/branches/V0.60_Kompass_Name/

Als Ursprung wählt man am besten Arbeitskopie. Dann fügt man noch ein paar Infos über diese Verzweigung hin (siehe Screenshot).

Und zum Schluss macht man noch einen Hacken bei Die Arbeitskopie zum neuen Zweig wechseln, damit diese auch gleich die aktiv ist.

Hier mal ein Screenshot:

attachment:subversion_branch2.gif

Das war es - jetzt kann man seine Änderungen am Code vornehmen.

Seine Daten ins Projektarchiv übertragen

Wenn man Änderungen gemacht hat, kann man diese jederzeit ins Archiv übertragen (commit). Einfach mit der rechten Taste (im Explorer) auf seinen Verzeichnisnamen und SVN übertragen wählen.

Es erscheint ein Dialog, wo man ein paar erläuternde Worte hinterlassen kann und eine Liste von Dateien, die bearbeitet wurden:

attachment:subversion_commit.gif

FERTIG.

Subversion Anleitungen

Es gibt im Netz eine Menge Informationen und Anleitung zum Umfang mit Subversion und TortoiseSVN . (Google hilft )

Hier mal ein paar Links:

• Anleitung zu TortoiseSVN

• http://tortoisesvn.net/docs/release/TortoiseSVN_de/

...

• ToDo: ausführlicher...

BR

• KategorieAnleitung