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

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

• Automatically includes the project name, description and version in Plugin Metadata.

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

Default bawaan

By default, the Gradle plugin will contribute the plugin name, plugin version, and description automatically to Plugin Metadata 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/'
        }
    }
}

Anda juga dapat menghapus nilai default seluruhnya:

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

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