Entwicklung

Für neue Entwickler hier ein Quickstart Guide: https://github.com/mediathekview/MediathekView/wiki/Quickstart-Guide

Um den Code für die Zukunft wartbar zu halten und Bugs zu minimieren sollte der Code so sauber wie nötig geschrieben werden. Hierzu empfhielt sich z.B. folgende Lektüre: http://blog.bbv.ch/wp-content/uploads/2013/06/Clean-Code-V2.1.pdf

Vorraussetzungen

• Java 8 JDK (für OpenJDK wird zusätzlich JavaFX benötigt)
• git
• git-flow (optional; eine Toolsammlung für vereinfachtes Arbeiten mit Git Flow, siehe Workflow)

Code auschecken

mkdir mediathekview
cd mediathekview
git clone https://github.com/mediathekview/MediathekView.git
cd MediathekView

Workflow

Wir setzten Git Flow als Workflow ein. Wir empfehlen die dazugehörigen Tools zu verwenden. Es ist es aber auch möglich mit reinem Git zu arbeiten.

• mit Tools (empfohlen)
• ohne Tools

Weitergehender Allgemeiner git-Workflow

• Entwickeln: Regelmäßig, am besten nach jedem baufähigen Commit, pushen. git push
• Wenn die Entwicklung fertig ist nochmal pushen und dann Pull Request erstellen. Dann ggf. nötige Änderungen einbauen und nach erfolgreichem Merge den Branch löschen. Entweder via GitHub oder mit git:

# Löscht den Branch "branchname", (bspw. "feature/#112") lokal, aber nur wenn breits gemerged wurde.
git branch -d [branchname]
# Löscht den Branch bei GitHub, der ":" ist wichtig.
git push origin :[branchname] 

Allgemeiner GitHub Hinweis

Issues können automatisch durch Keywords bei Commits auf master geschlossen werden: Closing issues via commit messages

Bauen und starten an der Kommandozeile

cd MediathekView
./gradlew run

Entwicklung mit Netbeans

• Verzeichnisse MLib und MediathekView mit Netbeans öffnen

Entwicklung mit Eclipse

• Falls noch nicht vorhanden: Plugin buildship installieren
• Projekt MediathekView als Gradle-Projekt importieren. MSearch wird automatisch mit importiert.