Einrichtung einer lokalen Twasi-Core-Instanz für die Entwicklung

Um dein Plugin auf deinem lokalen Gerät zu testen (oder sogar zu verwenden), musst du unsere Hauptkomponente Twasi-Core lokal einrichten.

Installation von Java

Um den Twasi-Core ausführen zu können, musst du Java auf deinem Gerät installiert haben. Wir entwickeln und testen Twasi-Core unter Verwendung von JDK 1.8 (OpenJDK build), was hier gefunden werden kann.

Die Plugin-Entwicklung sollte auch in neueren Versionen gut funktionieren, aber wir empfehlen nicht neuere Sprach-Features zu verwenden, da das Plugin in unserer Umgebung auf JDK 1.8 ausgeführt wird.

Installation von MongoDB

Eine weitere Komponente, von der Twasi-Core abhängt, ist die Datenbank. Derzeit wird nur MongoDB unterstützt. Die Installation ist recht simpel, einfach die offiziellen MongoDB-Docs anklicken für einen Walktrough.

Achte darauf, die Community-Edition herunterzuladen und zu installieren, da diese vollkommen ausreichend ist, um unseren Anforderungen gerecht zu werden.

Es ist nicht erforderlich, die Authentifizierung auf MongoDB einzurichten (standardmäßig ist dies ohnehin deaktiviert), da es nur Verbindungen vom lokalen Computer zulässt.

Abrufen von Twasi-Core

Um die Twasi-Core .jar-Datei zu erhalten, hast du derzeit zwei Möglichkeiten. Wir empfehlen die erste Möglichkeit:

Twasi-Core von der Artifactory holen

Rufe mit meinem Lieblingsbrowser die folgende Seite auf: https://artifactory.twasi.net/artifactory/libs-snapshot-local/net/twasi/TwasiCore/

Wähle die neueste Version (0.0.1-SNAPSHOT zum Zeitpunkt des Schreibens) und klicke auf den Link.

Suche im nächsten Ordner die neueste .jar-Datei (es sollte die vorletzte Datei in der Liste sein), wobei die letzte Datei die Erweiterung .pom besitzt, und lade es herunter.

Twasi-Core von der Quelle holen

Klone das Repository https://github.com/Twasi/twasi-core.git:

git clone https://github.com/Twasi/twasi-core.git

Im neu erstellten Verzeichnis gibst du den folgenden maven Befehl ein, um die JAR-Datei aus der Quelle zu erstellen:

mvn clean compile assembly:single

Jetzt sollte die fertige Datei hier liegen: target/TwasiCore-0.0.1-SNAPSHOT-jar-with-dependencies.jar

Erster Start

Verschiebe die abgerufene JAR-Datei in ein Verzeichnis, das dem Twasi-Core gewidmet ist.

Öffne eine Befehlszeile und starte die Verwendung von Twasi-Core (vorausgesetzt, du hast die Datei so benannt) twasi-core.jar:

java -jar twasi-core.jar

Konfiguration anpassen

TODO