Ini adalah permata Ruby 2D. Lihatlah situs web Ruby 2D untuk mempelajari cara memulai membangun aplikasi 2D di Ruby.
Untuk mengerjakan permata secara lokal, pertama -tama klon repo ini menggunakan:
git clone --recursive https://github.com/ruby2d/ruby2d.git Untuk menjaga ukuran repositori kode sumber ini kecil, submodul GIT digunakan untuk merujuk aset. Bendera --recursive memastikan submodul diinisialisasi dan diperbarui ketika repo ini dikloning. Jika Anda kebetulan mengkloning repo ini tanpa bendera --recursive , Anda masih dapat menginisialisasi dan memperbarui submodul dengan:
git submodule init
git submodule update --remote Perbarui submodul ini kapan saja menggunakan git submodule update --remote atau tugas rake update .
Selanjutnya, instal dependensi dengan Bundler dengan menjalankan bundle install untuk mendapatkan permata pengembangan.
Akhirnya, jalankan rake untuk membangun dan memasang permata secara lokal. Gunakan rake dev untuk membangun referensi pustaka yang dipasang pengguna (misalnya SDL).
Ruby 2D menggunakan kombinasi tes otomatis melalui RSPEC dan manual, tes interaktif untuk memverifikasi kebenaran fungsionalitas visual, audio, dan input. Bangun permata dan jalankan semua tes otomatis menggunakan perintah rake . Bangun dan jalankan tes interaktif di test/ direktori menggunakan rake test:<target> <name_of_test> , misalnya:
# Run `test/testcard.rb` using the standard Ruby interpreter, MRI (CRuby)
rake test:cruby testcard # `test:mri` or just `test` work also
# Build `test/audio.rb` using mruby and run
rake test:mruby audio
# Build `test/mouse.rb` for the web using WebAssembly and run in the default browser
rake test:wasm mouseRuby 2D adalah proyek yang sepenuhnya terbuka (termasuk ketergantungannya) yang dibangun oleh orang-orang yang berdedikasi yang percaya membuat aplikasi 2D harus sederhana, alami, dan gembira, dalam semangat bahasa Ruby itu sendiri.
Jika Anda ingin terlibat, ada sejumlah cara untuk melakukannya:
Menyarankan dan menerapkan fitur baru. ? Ruby 2D sudah banyak melakukan, tetapi ada banyak hal baru yang bisa dilakukan. Jika Anda memiliki permintaan fitur, atau saran tentang cara meningkatkan bahasa khusus domain, atau hal lain untuk ditambahkan, menghapus, atau mengubah, membuka masalah baru dan memberi tahu kami tentang hal itu. Jika Anda hanya ingin dengan santai membicarakan ide tanpa tekanan membuka masalah, kirim catatan ke milis atau mengobrol dengan kami di Gitter.
Tambahkan dukungan untuk lebih banyak platform. Ruby 2D bertujuan untuk sepenuhnya melintasi platform. Bantu kami menguji dan meningkatkan pengalaman pengembang pada platform yang ada dan menambahkan yang baru.
Temukan dan perbaiki masalah. ? Bantuan Anda mengidentifikasi dan memperbaiki bug, dan meningkatkan kinerja di sepanjang jalan, akan sangat penting untuk memastikan orang lain memiliki pengalaman yang solid menggunakan perpustakaan. Lihatlah pelacak masalah dan miliki!
Tulis dan tinjau dokumentasi. Sangat penting bagi keberhasilan setiap proyek open-source adalah dokumentasi. Kami akan memulai awal yang layak, tetapi selalu ada lebih banyak untuk ditulis dan diedit. Telusuri situs web Ruby 2D dan bantu kami mengidentifikasi area untuk menambah kejelasan atau mengisi celah. Di bagian atas sebagian besar halaman, Anda akan melihat tautan untuk "menyarankan edit" yang langsung ke file sumber di repo situs web.
Buat dan tingkatkan contoh. ? Kami saat ini sedikit ringan pada aplikasi sampel untuk membantu orang memulai. Kami ingin mendapatkan ide-ide Anda untuk aplikasi kecil, satu file tunggal untuk memandu pengguna melalui fitur atau teknik tertentu, yang kami kumpulkan dalam repositori contoh. Lihatlah showcase untuk melihat apa yang dibangun orang dan mendapatkan inspirasi.
Untuk mencapai kesederhanaan seperti itu, banyak yang harus terjadi di bawah tenda. Apakah menambahkan fitur atau memperbaiki bug, cobalah melakukan hal berikut untuk memastikan permintaan tarik Anda digabungkan. Beberapa di antaranya mungkin tampak menakutkan, tapi kami senang membantu di sepanjang jalan!
Periksa apakah ada masalah yang ada, dan jika tidak, buka yang baru untuk memulai diskusi. Sebelum mendedikasikan waktu dan energi untuk sebuah ide atau perbaikan, mari kita pastikan itu konsisten dengan prinsip dan tujuan proyek, dan bahwa kami memiliki strategi yang kuat untuk mengimplementasikan dan menguji.
Gunakan subset ruby yang bekerja di mana -mana. Aplikasi Ruby 2D, tentu saja, ditulis dalam Ruby. Beberapa pengguna dapat memilih untuk memanfaatkan kekuatan penuh bahasa, perpustakaan standar, dan ekosistem permata dengan menulis aplikasi yang ditafsirkan yang menargetkan implementasi standar, MRI. Orang lain mungkin ingin menargetkan web melalui WebAssembly, perangkat seluler, atau membangun aplikasi desktop asli, semua yang memanfaatkan implementasi Ruby yang berbeda yang disebut MRUBY. Ruby 2D bertujuan untuk mendukung semua kasus penggunaan ini, bahkan dengan basis kode aplikasi yang sama. Kontribusi Anda harus mendukung subset ruby yang kompatibel dengan dan berperilaku sama di seluruh MRI/Cruby dan Mruby. Di luar membaca dokumentasi untuk setiap implementasi Ruby, Anda juga dapat mencoba cuplikan kode pada baris perintah menggunakan masing -masing balasan: irb untuk MRI, dan mirb untuk mruby.
Uji perubahan Anda secara komprehensif. Tidak seperti perpustakaan Ruby lainnya, tidak semua yang ada di sini dapat dengan mudah ditutupi dengan tes unit saja. Kita juga perlu memastikan hal -hal terlihat dan terdengar benar, input bekerja seperti yang diharapkan, dan perilaku konsisten di semua platform dukungan Ruby 2D.
rake update untuk memperbarui submodules version.rb , lakukan perubahanv#.#.# , Dan tulis sedikit catatan rilisrake release untuk membangun permata, lalu dorong ke rubygems.org dengan gem push ruby2d-#.#.#.gem