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 'org.spongepowered.plugin' version '0.8.1'
}

group = 'com.example' // TODO
version = '1.0-SNAPSHOT'
description = 'An example plugin'

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

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

• Establezca su proyecto para compilar con Java 8

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

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

• Automáticamente incluye el nombre del proyecto, la descripción y la versión en Metadatos del Complemento.

Establezca manualmente el ID del complemento

Por defecto, el complemento Gradle configurará su ID del complemento con el nombre del proyecto (en minúsculas) que haya configurado. Si quiere utilizar un ID del complemento personalizado y todavía utilizar la integración Metadatos del Complemento puede cambiarlo manualmente:

sponge {
    plugin {
        id = 'mypluginid'
    }
}

Sobrescribir valores predeterminados

Por defecto el complemento de Gradle contribuirá al nombre del complemento, versión del complemento y descripción automáticamente a Metadatos del Complemento con valores por defecto definidos en las propiedades del proyecto. También es posible sobrescribir estos si quiere especificarlos manualmente:

sponge {
    plugin {
        meta {
            name = 'My Plugin'
            version = '1.0.0'
            description = 'This is a plugin'
        }
    }
}

También puede eliminar completamente un valor predeterminado:

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

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'
        url = 'https://repo.spongepowered.org/maven'
    }
}

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