Gradle’ın kurulumu

SpongeGradle’ı kullanmak

SpongeGradle’i kullanmak çok basit ve Gradle’da bir Sponge eklentisi kurmak için gereken Gradle yapılandırmasını en aza indirmenize olanak tanır. Ayrıca Eklenti Metaverileri için entegrasyon sağlar; örneğin, oluşturulan betiğinizde tanımlanan gruba, proje adına, sürümüne ve açıklamasına yerleşik eklentiye otomatik olarak katkıda bulunur, böylelikle yalnızca eklenti sürümünüzü bir dosyada güncellemeniz yeterlidir.

Tüyo

Çoğu sorun, eski bir Gradle sürümünü kullanmaya çalışmaktan kaynaklanmaktadır. En yeni Gradle sürümünü SpongeGradle ile birlikte kullanmanızı öneririz. The Gradle section of the build systems page bilgisayarınızdaki Gradle kurulumunu açıklar.

Çoğu eklenti için kullanılabilecek basit bir şablon aşağıda verilmiştir. Grubu daha önce seçtiğiniz grup kimliğiyle değiştirdiğinizden emin olun.

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

Bu birkaç satır, normalde elle yapacağınız ayarların çoğunu gerçekleştirir:

• Temel Gradle Java kurulumu

• Projenizi Java 8 ile uyumlu olarak ayarlayın

• Sponge’un Maven deposunu (ve Maven Merkezi) ekle

• plugin ID gibi proje adıyla küçük harfli bir eklenti kurun

• Proje adını, açıklamasını ve sürümünü otomatik olarak Eklenti Metaverileri öğesine ekler.

El ile eklenti kimliğini ayarlama

Varsayılan olarak, Gradle eklentisi eklenti kimliğinizi yapılandırdığınız yapılandırma adını (küçük harflerle) yapılandırır. Özel eklenti kimliği kullanmak ve yine de Eklenti Metaverileri entegrasyonunu kullanmak istiyorsanız bunu manuel olarak değiştirebilirsiniz:

sponge {
    plugin {
        id = 'mypluginid'
    }
}

Varsayılanları geçersiz kılma

Varsayılan olarak Gradle eklentisi, eklenti adı, eklenti sürümü ve açıklama ‘ya otomatik olarak :doc:`/eklenti/eklenti meta’ olarak proje özelliklerinde tanımlanan varsayılanlarla katkıda bulunacaktır. Bunları elle belirtmek isterseniz bunları geçersiz kılmak da mümkündür:

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

Varsayılan bir değeri tamamen kaldırabilirsiniz:

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

SpongeGradle olmadan

Uyarı

Sponge eklentileri için ek Gradle entegrasyonu sağlayacağından SpongeGradle kullanmanızı öneririz.

Genellikle, bir Sponge eklentisini Gradle kullanarak derlemek için gereken her şey, projenize SpongeAPI bağımlılığını ekleyerek yapılabilir:

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

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