Настройка Gradle

Использование SpongeGradle

SpongeGradle очень прост в использовании и позволяет минимизировать количество действий для создания Sponge плагина на Gradle. Кроме того, он обеспечивает интеграцию с Метаданные плагина, такую как автоматическое внедрение группы, названия проекта, версии и описания, определенных в build скрипте, в сборку вашего плагина. Таким образом вам нужно будет обновлять версию плагина только в одном файле.

Совет

Большинство проблем вызвано использованием устаревшей версии Gradle. Мы рекомендуем использовать последнюю версию Gradle и SpongeGradle. В статье о системах сборки, в разделе о Gradle описано как установить Gradle на свой компьютер.

Ниже приведен простой шаблон, который должен подойти для большинства плагинов. **Не забудьте заменить идентификатор группы в поле group, на ваше значение.* *

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

Эти несколько строк обрабатывают большинство параметров, которые вы обычно делаете вручную:

  • Основные настройки Gradle Java

  • Настройка проекта для компиляции с Java 8

  • Добавление Maven репозитория Sponge (и Maven Central)

  • Настройка имени проекта и плагина в нижнем регистре через поле plugin ID

  • Автоматически включает имя проекта, описание и версию в Метаданные плагина.

Ручная настройка идентификатора плагина

По умолчанию, Gradle плагин настроит ваш plugin ID на основании имени проекта (в нижнем регистре) которое было заранее задано. Если вы хотите использовать пользовательский plugin ID и по-прежнему использовать Метаданные плагина интеграцию, то вы можете изменить его вручную:

sponge {
    plugin {
        id = 'mypluginid'
    }
}

Переопределение значений по умолчанию

По умолчанию Gradle задаст имя плагина, версию плагина и описание автоматически в Метаданные плагина со значениями по умолчанию, определенными в свойствах проекта. Их также можно переопределить, если вы хотите указать их вручную:

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

Также можно полностью удалить значение по умолчанию:

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

Без использования SpongeGradle

Предупреждение

Мы рекомендуем использовать SpongeGradle так как он предоставляет дополнительную интеграцию Gradle с плагинами Sponge.

Как правило, для компиляции Sponge плагина с помощью Gradle, достаточно добавить SpongeAPI в качестве зависимости в ваш проект:

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

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