Konfigurowanie Gradle

Używanie SpongeGradle

Korzystanie z SpongeGradle jest bardzo proste i pozwala Ci zminimalizować potrzebną konfigurację Gradle do utworzenia pluginu na Sponge. Dodatkowo, zapewnia integrację dla Metadane Wtyczek, na przykład, automatyczne dodawanie grupy, nazwy projektu, wersji oraz opisu zdefiniowanego w Twoim skrypcie budowy projektu do tworzonego pluginu, tak abyś musiał zmieniać wersję tylko w jednym pliku.

Wskazówka

Większość problemów jest spowodowana próbą użycia przestarzałej wersji Gradle. Zalecamy używanie najnowszej wersji Gradle wraz z SpongeGradle. Sekcja Gradle na stronie systemu komiplacji wyjaśnia jak skonfigurować Gradle na Twoim komputerze.

Poniżej znajduje się prosty szablon, który powinien być użyteczny dla większości pluginów. **Upewnij się że group ID jest takie jakie wybrałeś wcześniej.

plugins {
    id 'java'
    id 'org.spongepowered.plugin' version '0.9.0'
}

// 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 {
    jcenter()
}

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

Te kilka linijek jest odpowiedzialne za większość ustawień, które normalnie musiałbyś zrobić ręcznie:

  • Podstawowe ustawienia Gradle Java

  • Ustaw swój projekt do kompilacji z Java 8

  • Dodaj repozytorium Maven Sponge (i Maven Central)

  • Skonfiguruj plugin, dodają w nim nazwę projektu pisną małymi literami jako plugin ID

  • Automatycznie umieszcza nazwę projektu, opis i version w Metadane Wtyczek.

Ręczne ustawianie ID pluginu

Domyślnie, plugin (wtyczka) Gradle skonfiguruje Twoje ID pluginu z nazwą projektu (napisaną małymi literami), którą ustawiłeś. Jeśli chcesz użyć niestandardowego ID pluginu i dalej używać integracje z Metadane Wtyczek, możesz zmienić je manualnie:

sponge {
    plugin {
        id = 'pluginidgoeshere'
    }
}

Zastępowanie ustawień domyślnych

Domyślnie, plugin (wtyczka) Gradle automatycznie prześle nazwę pluginu, wersję pluginu oraz opis do Metadane Wtyczek z ustawieniami domyślnymi zdefiniowanymi we właściwościach projektu. Możliwe jest również nadpisanie tych danych jeśli chcesz określić je manualnie:

sponge {
    plugin {
        meta {
            name = 'Example Plugin'
            version = '1.0.0-SNAPSHOT'
            description = 'This is an example plugin'
            url = 'http://www.example.com/'
        }
    }
}

Możesz także całkowicie usunąć wartość domyślną:

sponge {
    plugin {
        meta {
            name = null
            description = null
        }
    }
}

Bez SpongeGradle

Ostrzeżenie

Zalecamy użycie SpongeGradle dla pluginów Gradle, ponieważ zapewniają dodatkową integrację z pluginami Sponge.

Generalnie, wszystko co jest potrzebne do skompilowania pluginu (wtyczki) Sponge za pomocą Gradle może być zrobione poprzez dodanie zależności SpongeAPI do Twojego projektu.

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

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