2019.06 2020.06

Gemeinsame Entwicklungsplattformen

Der Abschnitt beschreibt Werkzeuge und Zugänge zu den Entwicklerbereichen von MyCoRe.

Git-Zugang

Das Entwicklerteam hat sich entschlossen, die MyCoRe-Quellcodes vom eigenen Subversion-Server auf GitHub zu verschieben. Neben einer besseren Wahrnehmung von MyCoRe in der Open Source Gemeinde sollen die besseren Team-Arbeitsmöglichkeiten von Git ausgenutzt werden. Die Umstellung fand im Oktober 2016 für den aktuellen Master-Code (trunk) und das release 2016.06 statt. Die Code-Entwicklung ist dabei weiter an JIRA und BAMBOO gekoppelt.

Alle Projekte der MyCoRe Community sind unter https://github.com/MyCoRe-Org zu finden.

Hinweise zum Umgang mit Git von Kathleen Neumann sind hier zu finden.

Integration des MyCoRe-Git-Repositories in Eclipse

Um das MyCoRe-Git-Repository auszuchecken und in Eclipse zu integrieren sollte zuerst Git auf dem lokalen Rechner installiert werden. Anschließend ist die Konfiguration entsprechend der obigen Doku zu setzen. Nun können in Eclipse folgende aktivitäten ausgeführt werden:

  • in die Git-Ansicht wechseln
  • clone a git repository auswählen
  • als Source https://github.com/MyCoRe-Org/mycore.git eintagen
  • eigenes Git Login und Pw eintragen
  • deselect all und dann select master auswählen
  • Directory festlegen (z. B. ~/workspace); origin als Bezeichner lassen
  • ... und laden

Nun ist der Codestand im Git-View sichtbar. Jetzt soll der Code auch in der Java-Ansicht verfügbar sein. Dazu sind folgende Schritte notwendig.

  • in die Git-Ansicht wechseln
  • im Working Tree der ausgecheckten Daten Import projects
  • dort Import General Project auswählen
  • anschießend in die Java-Ansicht wechseln und mit
  • Import existing Maven projects die gewünschen MyCoRe-Komponenten auswählen

Um vom Master auf ein bestimmtes Release zu wechseln sind folgende Schritte zu tun.

  • in die Git-Ansicht wechseln
  • auf dem Master rechte Maustaste Fetch from upstream
  • da unter Remote tracking checkout as new branch auswählen

Anschalten der Warnung für die pom.xml: Hierfür ist die jeweilige pom.xml zu öffnen. Ober erscheint eine Warnung. Auf der Warnung rechte Maustaste und Make goal update-project-license as ignored in eclipse build markieren.

Weiteres Repositories von MyCoRe-Entwicklern

Neben dem Repository auf GitHub betreiben einige Entwickler noch eigene Repositories auf GitLab-Grundlage.

Nutzung der Entwicklungsumgebung Eclipse

Die Entwicklungsumgebung Eclipse leistet nicht nur hilfreiche Dienste bei der Formatierung des Java-Codes. Mit ihr kann auch die Syntaxprüfung der Java-Klasse wie auch ihre Einbettung in das Gesamtprojekt leicht überwacht werden. Dazu sind einige Installationen und Einstellungen erforderlich. Diese werden dann sowohl für die Kernanwendung wie auch für die Applikationen genutzt.

Zuerst ist die Eclipse-Entwicklungsumgebung zu installieren.
Von den Entwicklern wird als Basis die Eclipse IDE for Java EE Developers genutzt und empfohlen.

Weiterhin sollte nach der Installation die Code-Style-Definition von MyCoRe importiert werden (siehe Abschnitt Java-Code Formatierung).

Installations-Skript

Um die Installation und Erst-Konfiguration unter Windows zu erleichtern, stellt die MyCoRe-Community ein Script zur Verfügung. Es nutzt die Skriptsprache AutoHotKey, um die Eclipse-Anwendung herunterzuladen, zu entpacken und erste Einstellungen vorzunehmen.
Weitere Informationen zum Skript findet man in unserem Github-Repository unter MyCoRe: Eclipse Download und Konfigurations-Tool.

Weitere Tools

Zur Bearbeitung von I18N-Sprachdateien hat sich der ResourceBundle-Editor (besonders für Sprachen außerhalb des Lateinischen Alphabetes) bewährt.

Um eine direkte Jira-Anbindung im Eclipse zu realisieren, muss der Jira-Connector über den Eclipse-Marketplace installiert werden. Danach muss das Jira über MyLyn eingebunden werden.

Für weitere Einstellungen im Editor kann AnyEdit empfohlen werden. Damit kann beispielsweise konfiguriert werden, dass überzählige Leerzeichen z.B. am Zeilenende aus dem Code entfernt werden.