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

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

• Automatically includes the project name, description and version in Eklenti Metaverileri.

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

Varsayılanları geçersiz kılma

By default, the Gradle plugin will contribute the plugin name, plugin version, and description automatically to Eklenti Metaverileri with defaults defined in the project properties. It is also possible to override these if you want to specify them manually:

sponge {
    plugin {
        meta {
            name = 'Example Plugin'
            version = '1.0.0-SNAPSHOT'
            description = 'This is an example plugin'
            url = 'http://www.example.com/'
        }
    }
}

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

sponge {
    plugin {
        meta {
            name = null
            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 {
    jcenter()
    maven {
        name = 'sponge-repo'
        url = 'https://repo.spongepowered.org/maven'
    }
}

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