Configurer Gradle

Utiliser SpongeGradle

Utiliser SpongeGradle est très simple et vous permet de réduire au minimum la configuration Gradle nécessaire pour mettre en place un plugin Sponge sur Gradle. Additionnellement, il fournit une intégration pour Plugin Metadata, comme la contribution automatique du groupe, du nom du projet, de la version et de la description définies dans votre script de build pour le plugin compilé, donc vous devez seulement mettre à jour la version de votre plugin dans un fichier.

Astuce

La plupart des problèmes sont causés par la tentative de l’utilisation d’une version obsolète de Gradle. Nous recommandons d’utiliser la dernière version de Gradle avec SpongeGradle. La section Gradle de la page du système de build explique comment configurer Gradle sur votre ordinateur.

Voici ci-dessous un modyle simple qui devrait être utilisable pour la plupart des plugins. Assurez-vous de remplacer le groupe par le group ID que vous avez choisi avant.

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)
        }
    }
}

Ces quelques lignes traitent la plupart des paramètres que vous feriez normalement manuellement :

• Configuration Java de Gradle Basique

• Ajout du dépôt Maven de Sponge (et le Maven Central)

• Mise en place d’un plugin avec le nom du projet en minuscule comme le plugin ID

• Intégration automatique du nom du projet, de la description et de la version dans Plugin Metadata.

Sans SpongeGradle

Avertissement

Nous recommandons l’utilisation de SpongeGradle pour les plugins Gradle puisqu’il fournira une intégration Gradle supplémentaire pour les plugins Sponge.

En général, tout le nécessaire pour compiler un plugin Sponge en utilisant Gradle peut être fait en ajouter simplement la dépendance SpongeAPI à votre projet :

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

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