Configuración de Gradle

Utilización de SpongeGradle

El uso de SpongeGradle es muy simple y le permite minimizar la configuración necesaria de Gradle para configurar un complemento de Sponge en Gradle. Adicionalmente, proporciona integración para Metadatos del Complemento, ya que automáticamente contribuye al grupo, al nombre del proyecto, a la versión y a la descripción definidos en su script de compilación con el complemento compilado, solo necesita actualizar su versión del complemento en un archivo.

Truco

Muchos problemas son causados al intentar utilizar una versión anterior de Gradle. Recomendamos utilizar la última versión deGradle junto con SpongeGradle. La sección de Gradle de la página del sistema de compilación explica como configurar Gradle en su computadora.

A continuación se muestra una plantilla simple que debería ser utilizable por la mayoría de los complementos. Asegúrese de reemplazar el grupo con el ID del grupo que ha escogido antes.

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

Estas pocas líneas se encargan de la mayoría de las configuraciones que normalmente haría manualmente:

  • Configuración Básica de Gradle Java

  • Agregar el repositorio Maven de Sponge (y Maven Central)

  • Configure un complemento con el nombre del proyecto en minúsculas como ID del complemento

  • Automatically includes the project name, description and version in Metadatos del Complemento.

Sin SpongeGradle

Advertencia

Recomendamos utilizar SpongeGradle para complementos de Gradle ya que proporcionará integración adicional de Gradle para complementos de Sponge.

Generalmente, todo lo necesario para compilar un plugin de Sponge utilizando Gradle puede ser hecho al simplemente agregando la dependencia SpongeAPI a su proyecto:

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

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