Настройка Gradle
Использование SpongeGradle
SpongeGradle очень прост в использовании и позволяет минимизировать количество действий для создания Sponge плагина на Gradle. Кроме того, он обеспечивает интеграцию с Метаданные плагина, такую как автоматическое внедрение группы, названия проекта, версии и описания, определенных в build скрипте, в сборку вашего плагина. Таким образом вам нужно будет обновлять версию плагина только в одном файле.
Совет
Большинство проблем вызвано использованием устаревшей версии Gradle. Мы рекомендуем использовать последнюю версию Gradle и SpongeGradle. В статье о системах сборки, в разделе о Gradle описано как установить Gradle на свой компьютер.
Ниже приведен простой шаблон, который должен подойти для большинства плагинов. **Не забудьте заменить идентификатор группы в поле group, на ваше значение.* *
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'
}
Эти несколько строк обрабатывают большинство параметров, которые вы обычно делаете вручную:
Основные настройки Gradle Java
Настройка проекта для компиляции с Java 8
Добавление Maven репозитория Sponge (и Maven Central)
Настройка имени проекта и плагина в нижнем регистре через поле plugin ID
Автоматически включается в название проекта, описание и версию в:doc:/plugin/plugin-meta.
Ручная настройка идентификатора плагина
По умолчанию, Gradle плагин настроит ваш plugin ID на основании имени проекта (в нижнем регистре) которое было заранее задано. Если вы хотите использовать пользовательский plugin ID и по-прежнему использовать Метаданные плагина интеграцию, то вы можете изменить его вручную:
sponge {
plugin {
id = 'pluginidgoeshere'
}
}
Переопределение значений по умолчанию
По умолчанию Gradle задаст имя плагина, версию плагина и описание автоматически в Метаданные плагина со значениями по умолчанию, определенными в свойствах проекта. Их также можно переопределить, если вы хотите указать их вручную:
sponge {
plugin {
meta {
name = 'Example Plugin'
version = '1.0.0-SNAPSHOT'
description = 'This is an example plugin'
url = 'http://www.example.com/'
}
}
}
Также можно полностью удалить значение по умолчанию:
sponge {
plugin {
meta {
name = null
description = null
}
}
}
Без использования SpongeGradle
Предупреждение
Мы рекомендуем использовать SpongeGradle так как он предоставляет дополнительную интеграцию Gradle с плагинами Sponge.
Как правило, для компиляции Sponge плагина с помощью Gradle, достаточно добавить SpongeAPI в качестве зависимости в ваш проект:
repositories {
jcenter()
maven {
name = 'sponge-repo'
url = 'https://repo.spongepowered.org/maven'
}
}
dependencies {
compile 'org.spongepowered:spongeapi:7.2.0'
}