Der Abschnitt beschreibt Werkzeuge und Zugänge zu den Entwicklerbereichen von MyCoRe.
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.
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:
clone a git repository
auswählen
https://github.com/MyCoRe-Org/mycore.git
eintagen
deselect all
und dann
select master
auswählen
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.
Import projects
Import General Project
auswählen
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.
Fetch from upstream
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.
Neben dem Repository auf GitHub betreiben einige Entwickler noch eigene Repositories auf GitLab-Grundlage.
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).
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.
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.