Gradle einrichten

SpongeGradle verwenden

SpongeGradle zu verwenden ist sehr einfach und erlaubt dir die notwendige Konfiguration, um ein Sponge Plugin mit Gradle einzurichten zu vermindern. Außerdem stellt es eine Integration mit Plugin Metadaten zur Verfügung, so dass es automatisch die Gruppe, den Projektnamen, die Version und die Beschreibung aus dem Build-Script zu dem erstellten Plugin hinzufügt. Dadurch musst du die Plugin-Version nur in einer Datei ändern.

Tipp

Die meisten Probleme werden dadurch verursacht, dass eine veraltete Gradle Version verwendet wird. Wir empfehlen daher immer die neuste Version zusammen mit SpongeGradle. Der Gradle Abschnitt der Build-System Seite erklärt, wie Grade auf deinem Computer installiert wird.

Unten ist eine einfache Vorlage, die für die meisten Plugins funktionieren sollte. Ersetze die Gruppe und Gruppen-ID mit den vorher ausgewählten Werten.

plugins {
    id 'java-library'
    id("org.spongepowered.plugin") version '0.11.3'
}

// This may not be required, but has solved issues in the past
compileJava.options.encoding = 'UTF-8'

// TODO: Change the following to match your information
group = 'com.example'
version = '1.0.0-SNAPSHOT'
description = 'Here lies an example plugin definition'

repositories {
    mavenCentral()
}

sponge {
    apiVersion("8.1.0")
    licence("MIT")
    loader {
        name(PluginLoaders.JAVA_PLAIN)
        version("1.0")
    }
    plugin("**plugin Id**") {
        displayName("**Plugin Name**")
        entrypoint("**Plugin Entrypoint**")
        description("**Plugin Description**")
        dependency("spongeapi") {
            loadOrder(PluginDependency.LoadOrder.AFTER)
            optional(false)
        }
    }
}

Diese wenigen Zeilen verwalten die Meisten Einstellungen, die du sonst selbst machen müsstest:

  • Grundeinstellungen von Gradle Java

  • Sponge Maven Repository hinzufügen (und Maven Central)

  • Ein Plugin mit dem Projektnamen in Kleinbuchstaben als Plugin-ID erstellen

  • Automatically includes the project name, description and version in Plugin Metadaten.

Ohne SpongeGradle

Warnung

Wir empfehlen SpongeGradle für auf Gradle basierende Plugins zu verwenden, da es zusätzliche Funktionen für Sponge Plugins bereitstellt.

Zum kompilieren eines Sponge Plugins mit Gradle reicht es die SpongeAPI als Abhängigkeit zu deinem Projekt hinzuzufügen:

repositories {
    mavenCentral()
    maven {
        name = 'sponge-repo'
        url = 'https://repo.spongepowered.org/repository/maven-public/'
    }
}

dependencies {
    compile 'org.spongepowered:spongeapi:8.0.0'
}