Build Systeme
Build Systeme wie Gradle oder Maven können den Build-Prozess von einem Projekt verwalten. Als ein von der IDE unabhängiges Tool kannst du diese nutzen um die Abhängigkeiten von der SpongeAPI oder anderen Plugins zu verwalten und anderen einen einfachen Weg zu bieten dein Plugin aus dem Quellcode zu erstellen.
Bemerkung
Die SpongeAPI verlangt kein Build-System um Plugins zu erstellen, es ist allerdings empfohlen eines zu verwenden. Die folgenden Abschnitte, mit Ausnahme des Abschnitts Ein Plugin ohne Build-System erstellen, gehen davon aus, dass ein Build-System verwendet wird, welches die Abhängigkeiten verwaltet.
Im Allgemeinen kannst du jedes Build-System benutzen, das Maven Abhängigkeiten unterstützt, welches ein Standard ist, der von der Mehrheit der Build Systeme für Java unterstützt wird. Die folgenden Abschnitte werden sich auf Gradle und Maven fokussieren, welche die zwei meist verwendeten Build-Systeme sind. Wenn du unsicher bist, für welches du dich entscheiden sollst, empfehlen wir dir die Benutzung von Gradle, da dies auch für die Sponge Projekte verwendet wird und die beste Integration für Sponge Plugins bietet.
Gradle
Gradle verwendet Groovy- oder Kotlin-basierte Skripts für die Konfiguration von Projekten. Ein Gradle Projekt besteht typischerweise aus einer build.gradle
-Datei im Stammverzeichnis Ihres Projekts, die Gradle erklärt, wie das Projekt gebaut werden soll.
Tipp
Beziehe dich auf das Gradle User Guide für die Installation und eine allgemeine Einführung in das Konzept von Gradle. Wenn du nur an der Verwendung von Gradle für einfache Java Projekte interessiert bist, wäre der Gradle Java Quickstart ein guter Einstieg.
Richte deine Arbeitsumgebung ein wie in Den Arbeitsbereich einrichten erklärt, folge dann Gradle einrichten.
Maven
Maven verwendet eine XML-basierte Konfiguration namens Project Object Model (oder POM) für die Konfiguration von Projekten. Ein Maven-Projekt enthält in der Regel eine pom.xml
Datei im Stammverzeichnis des Projekts, die Maven erklärt, wie das Projekt gebaut werden soll.
Tipp
Beziehe dich auf das Maven Users Centre für die Installation und eine allgemeine Einführung in das Konzept von Maven. Wenn du nur an der Verwendung von Maven für einfache Java Projekte interessiert bist, wäre Maven in 5 Minutes ein guter Einstieg.
Richte deine Arbeitsumgebung ein wie in Den Arbeitsbereich einrichten erklärt, folge dann Maven einrichten.
Ein Plugin ohne Build-System erstellen
Es ist auch möglich Sponge Plugins ohne den Einsatz eines Build Systems, nur mit den mitgelieferten Werkzeugen in deiner IDE zu erstellen.
Warnung
Wir sprechen uns deutlich gegen die Verwendung der SpongeAPI ohne Build-System aus. Auf lange Sichte vereinfacht die Verwendung eines Build-Systems den Entwicklungsprozess für dich und andere, die zu deinem Projekt beitragen möchten. Diese Methode der Entwicklung von Plugins wird nicht aktiv vom Sponge Team getestet.
For developing plugins without a build system, you need to download the SpongeAPI dependency manually from the
SpongeAPI Download Page. For developing without a build system, we provide the shaded
artifact which bundles all
dependencies that would normally be automatically downloaded by the build system.
Nachdem du das shaded
Artefakt heruntergeladen hast und es in der IDE dem Projekt hinzugefügt hast, kannst du die Entwicklung an deinem Plugin beginnen. Fahre fort mit Plugin-Identifikatoren, um eine Identifizierung für dein Projekt zu wählen, und anschließen mit Hauptklasse des Plugins.