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:6.0.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:6.0.0'
}