Menyiapkan Gradle

Menggunakan SpongeGradle

Menggunakan SpongeGradle begitu sederhana dan mengizinkan anda meminimalkan susunan Gradle yang diperlukan untuk memasang plugin Sponge di Gradle. Selain itu, ini menyediakan integrasi untuk Plugin Metadata, seperti menyumbang secara otomatis terhadap kelompok, nama proyek, versi dan gambaran yang didefinisikan dalam skrip build anda ke plugin yang ada, jadi anda hanya perlu memperbarui versi plugin anda. dalam satu file.

Tip

Sebagian besar masalah disebabkan karena mencoba menggunakan versi Gradle yang telah kedaluwarsa. Kami merekomendasikan untuk menggunakan Gradle versi terbaru bersamaan dengan SpongeGradle. Bagian Gradle pada halaman build sistem menjelaskan bagaimana cara mengatur Gradle pada komputer anda.

Berikut adalah template mudah yang akan digunakan untuk kebanyakan plugin. ** Pastikan untuk mengganti grup dengan ID grup yang telah anda pilih sebelumnya.**

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

Beberapa baris ini menangani sebagian besar Pengaturan yang biasanya anda lakukan secara manual:

  • Mempersiapkan Badic Gradle Java

  • Terapkan proyek anda untuk dikompilasi dengan java 8

  • Tambahkan repositori Maven Sponge (dan Maven Central)

  • Mengatur plugin dengan nama proyek dalam kasus yang lebih rendah sebagai plugin ID

  • Secara otomatis meliputi nama proyek, deskripsi dan versi di :doc: /plugin/plugin-meta`.

Tetapkan ID plugin secara manual

Secara awal, Gradle plugin akan mengkonfigurasi plugin ID dengan nama proyek (dalam huruf kecil) anda telah dikonfigurasi. Jika anda ingin menggunakan adat plugin ID dan masih menggunakan Plugin Metadata integrasi anda dapat mengubahnya secara manual:

sponge {
    plugin {
        id = 'mypluginid'
    }
}

Default bawaan

Secara default plugin Gradle akan berkontribusi nama plugin,**versi plugin** dan deskripsi secara otomatis ke Plugin Metadata dengan default yang didefinisikan di proyek properti. Hal tersebut juga memungkinkan untuk mengeyampingkannya jika anda mau menentukan mereka secara manual:

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

Anda juga dapat menghapus nilai default seluruhnya:

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

Tanpa SpongeGradle

Peringatan

Kami merekomendasikan penggunaan SpongeGradle untuk plugin Gradle karena akan memberikan penambahan integarasi Gradle ke plugin Sponge.

Umumnya, segala sesuatu yang diperlukan untuk mengkompilasi sebuah Spons plugin menggunakan Gradle dapat dilakukan dengan hanya menambahkan SpongeAPI ketergantungan untuk proyek anda:

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

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