Programmieren für Wammu und Gammu

Gammu wurde in C programmiert, Wammu in Python, die Kenntnis einer dieser Sprachen ist also Voraussetzung um Code direkt beizutragen. Sie werden vermutlich einige Teile der Entwickler Dokumentation verwenden wollen, um den Code zu verstehen. Wenn Sie Informationen über derzeitig geplante Änderungen benötigen, lesen Sie bitte unsere Roadmap.

Versionskontrollsystem

Derzeit verwenden wir Git als Versionensystem. Es erlaubt Ihnen, eigene Entwicklungszweige zu erschaffen, den Code zu entwickeln und dann Patches oder Aufforderungen zur Aufnahme des Codes zu übermitteln.

Die Git Speicher befinden sich auf Gitorious, im speziellen finden Sie dort die Projekte Wammu und Gammu. Sie können sich dort den Quelltext ansehen oder einfach die gesamte Datenbank kopieren und auf Ihrem Computer genau analysieren. Letzteres können Sie bequem mit folgenden Befehlen veranlassen:

# For Wammu sources:
git clone git://gitorious.org/wammu/mainline.git wammu

# For Gammu sources:
git clone git://gitorious.org/gammu/mainline.git gammu

# For Wammu website:
git clone git://gitorious.org/wammu/website.git wammu_web

Alternativ, zB wenn Ihre Firewall das Git Protokoll blockiert, haben Sie Zugang über http. Ersetzen Sie einfach git://gitorious.org/ mit http://git.gitorious.org/. Sämtliche Dateien werden außerdem auf SourceForge.net zur Verfügung gestellt; ebenso werden Sie auf repo.or.cz (Gammu und Wammu) fündig.

Die Anleitung zum Bau und zur Installation finden Sie, sowohl bei Gammu, als auch bei Wammu, in der Datei INSTALL. Sie benötigen zum Kompilieren von Gammu CMake.

Code Snapshots

Wenn Sie das Versionskontrollsystem nicht nutzen wollen, können Sie jederzeit die aktuellsten Versionen des Codes herunterladen. Wir bieten diese auf unserem Download Server an: Gammu und Wammu. Diese Quelltext-Momentaufnahmen werden mehrmals pro Tag aktualisiert, um die Gültigkeit des Codes wirklich gewährleisten zu können.

Fehlerbereinigung

Letztendlich steht Ihnen frei, wie Sie uns Ihren Code zukommen lassen. Die einfachste Methode, Code hinzuzufügen, ist sicherlich die Benutzung von git format-patch. Wenn Sie Git nicht verwenden, erfüllen vereinheitlichte diff den Zweck. Sie können Fehlerbereinigungen und Zusatzcode an unsere Mailing Listen oder per bug tracker senden.

Testen

Gammu bietet eine umfassende Testumgebung, die auf manchen Plattformen täglich angewendet wird. Ergebnisse finden Sie auf CDash. Wenn Sie einen über einen Computer verfügen, der durchgehend in Betrieb ist, wäre das Testen mittels Testumgebung ein willkommener Beitrag zur Qualitätssicherung des Codes. Um die Testumgebung zu verwenden, müssen Sie sich nur die Quelltexte besorgen und folgende Befehle jeden Abend ausführen:

cd /path/to/gammu
git pull
cd build-dir # eg. build-configure
make NightlyMemCheck # or just Nightly if memory checking tool is not available on your platform

Die Ergebnisse werden automatisch hoch geladen und den Entwicklern übermittelt. Jeder Fehler im Test wird somit mitgeteilt und beachtet.