Membangun Sistem

Membangun sistem seperti Gradle atau Maven dapat mengatur proses membangun proyek Anda. Sebagai alat independen dari IDE Anda, Anda dapat menggunakannya untuk mengelola ketergantungan Anda pada SpongeAPI atau plugin lainnya dan memberi orang lain cara mudah untuk membuat plugin dari sumbernya.

Catatan

SpongeAPI tidak tidak memerlukan menggunakan membangun sistem untuk membuat plugin, namun kami sangat menyarankan menggunakan satu. Kecuali penjelasan singkat di Menciptakan plugin tanpa membangun sistem, bagian berikut akan berasumsi anda menggunakan membangun sistem, yang dapat mengelola dependensi untuk anda.

Umumnya, anda dapat menggunakan setiap membangun sistem yang mendukung Maven dependensi, yang merupakan standar yang didukung oleh mayoritas membangun sistem Jawa untuk proyek_proyek. Bagian berikut ini akan fokus pada Gradle dan Maven, yang adalah pilihan yang paling umum seperti membangun sistem. Jika anda tidak yakin yang mana yang harus digunakan sebaiknya menggunakan Gradle seperti itu juga digunakan untuk Spons proyek dan menyediakan integrasi terbaik untuk Sponge plugin.

Gradle

Gradle uses Groovy or Kotlin based scripts for configuring projects. A Gradle project typically consists of a build.gradle file in your project's root directory, which tells Gradle how to build the project.

Tip

Merujuk ke Gradle Panduan Pengguna untuk instalasi dan pengenalan umum tentang konsep-konsep yang digunakan dalam Gradle. Jika anda hanya tertarik pada bagaimana untuk menggunakan Gradle untuk proyek Java, tempat yang baik untuk memulai akan menjadi Gradle Jawa Quickstart.

Penataan ruang kerja anda seperti yang dijelaskan dalam Anda mengatur ruang kerja kemudian ikuti proyek/gradle.

Maven

Maven menggunakan XML-based konfigurasi yang disebut Project Object Model (atau POM) untuk konfigurasi proyek. Sebuah Maven proyek biasanya berisi pom.xml file di proyek direktori root yang menceritakan Maven bagaimana untuk membangun proyek.

Tip

Merujuk ke Maven Pengguna Centre untuk instalasi dan pengenalan umum tentang konsep-konsep yang digunakan dalam Maven. Jika anda hanya tertarik pada bagaimana untuk menggunakan Maven untuk proyek Java, tempat yang baik untuk memulai akan menjadi Maven dalam 5 Menit.

Mempersiapkan lembar kerja anda seperti yang dijelaskan pada Anda mengatur ruang kerja kemudian ikuti Mempersiapkan Maven.

Membuat plugin tanpa membangun sistem

Hal ini juga memungkinkan untuk membuat plugin Sponge tanpa menggunakan sistem build, hanya dengan tool yang disertakan di IDE Anda.

Peringatan

Kami sangat menyarankan untuk tidak menggunakan SpongeAPI tanpa membangun sistem. Dalam jangka panjang menggunakan membangun sistem akan menyederhanakan proses pengembangan untuk anda dan orang-orang lain yang ingin berkontribusi untuk proyek anda. Metode ini mengembangkan plugin tidak menerima pengujian aktif dengan Spons tim.

For developing plugins without a build system, you need to download the SpongeAPI dependency manually from the SpongeAPI Download Page. For developing without a build system, we provide the shaded artifact which bundles all dependencies that would normally be automatically downloaded by the build system.

Setelah anda telah men-download berbayang artefak dan telah ditambahkan ke proyek dalam IDE anda, anda dapat mulai mengembangkan plugin anda. Terus pada Pengenal Plugin untuk memilih sebuah identifier untuk proyek anda, kemudian lanjutkan pada Class Plugin utama.