shoes4
1.0.0
Sepatu 4: Versi sepatu berikutnya
Sepatu adalah DSL kecil untuk pemrograman GUI lintas platform (Mac, Windows, dan Linux). Rasanya seperti ruby asli, bukan hanya pembungkus perpustakaan C ++ lainnya. Untuk beberapa sampel, manual, dan buku gratis, lihat situs web sepatu.
Ingin melihat seperti apa sepatu itu? Nah, ini dia! Diberi skripnya:
Shoes . app width : 300 , height : 200 do
background lime .. blue
stack do
para "Welcome to the world of Shoes!"
button "Click me" do alert "Nice click!" end
image "http://shoesrb.com/img/shoes-icon.png" ,
margin_top : 20 , margin_left : 10
end
endIni menghasilkan aplikasi berikut:
Tampilan dan nuansa akan berbeda untuk sistem operasi Anda, karena Shoes 4 menggunakan widget asli.
Jalan jauh di hari itu, ada seorang pria bernama _Why. Dia menciptakan proyek yang dikenal sebagai Hackety Hack untuk mengajarkan pemrograman kepada semua orang. Untuk mencapai semua penjuru bumi, _Why memutuskan untuk membuat peretasan Hackety bekerja pada Windows, Mac OS X, dan Linux. Ini banyak pekerjaan, dan _Why memutuskan untuk berbagi toolkitnya dengan dunia. Dengan demikian, sepatu lahir.
Halo, terima kasih telah memeriksanya! Sepatu 4 berada dalam tahap pratinjau. Saat ini mendukung hampir semua sepatu DSL, tetapi masih ada beberapa tempat yang tidak didukung dan masalah yang diketahui. Kami sekarang secara teratur merilis versi pratinjau yang diperbarui ke Rubygems, untuk pemasangan yang mudah. Jika Anda belum terlalu suka berpetualang, Anda masih bisa menggunakan sepatu lama!
Ada dua cara untuk mendapatkan sepatu 4 - pelepasan pratinjau permata dan memasangnya langsung dari GitHub. Untuk keduanya Anda memerlukan instalasi JRuby saat ini.
Kami merekomendasikan menggunakan JRuby 9.x+, dengan sebagian besar pengujian kami saat ini terhadap 9.1. Jruby 1.7.x dapat bekerja, tetapi telah belum teruji sejak 4.0.0.pre6.
Jadi langkah pertama Anda adalah memasang JDK (sepatu juga berfungsi dengan OpenJDK) dan Jruby. Pastikan untuk mengambil versi jruby yang sesuai untuk sistem operasi Anda. Di Linux/Mac Anda juga dapat menggunakan alat instalasi Ruby untuk menginstal JRuby. Misalnya RVM:
$ rvm install jruby
Catatan Versi JDK: Jruby Version 9 membutuhkan versi JDK dari 7 atau 8 - JDK 9 belum berfungsi dengan JRuby dan karenanya tidak dengan sepatu. Juga dalam versi utama JDK, pastikan untuk menginstal pembaruan terbaru, kami memiliki kasus di mana versi yang lebih baru menyelesaikan bug.
Persyaratan SWT: Perhatikan bahwa sepatu 4 dibangun di atas SWT untuk backend default. Itu biasanya tidak menjadi perhatian (selain kebutuhan untuk Jruby/JDK, yang dijelaskan di atas) karena Anda tidak perlu menginstal SWT sendiri. Namun, itu berarti kami memiliki persyaratan sistem dasar yang sama yang dilakukan SWT. Untuk Linux itu berarti Anda memerlukan GTK+> = 2.10 atau> = 3.0 jika Anda suka. Selain itu, sampai sekarang tidak ada dukungan lengan (seperti yang dibutuhkan Raspberry Pi).
$ gem install shoes --pre
C:tmp> jruby -S gem install shoes --pre
Jika Anda ingin berada di tepi pendarahan atau ingin menyumbangkan kode, Anda perlu menginstalnya langsung dari repositori GitHub.
Garpu repositori dan klon garpu Anda, atau
$ git clone git://github.com/shoes/shoes4.git
Siapkan Lingkungan Lokal Anda
$ cd shoes4
$ gem install bundler && bundle install
Catatan: Jika Anda mendapat RVM, RBENV atau semacamnya yang diinstal, mungkin akan mengeluh bahwa Anda harus menggunakan Jruby Version XX. Itu karena kami menjaga file .ruby-versi kami tetap terkini. Anda harus dapat menjalankannya dengan versi jruby> = 9.0.0.0 Kami merekomendasikan versi terkini.
Garpu repositori dan klon garpu Anda, atau
C:tmp> git clone git://github.com/shoes/shoes4.git
Siapkan Lingkungan Lokal Anda
C:tmp>cd shoes4
C:tmpshoes4>jruby -S gem install bundler
C:tmpshoes4>jruby -S bundle install
Anda siap untuk pergi!
Sepatu 4 dilengkapi dengan pelari aplikasi baris perintah. Lewati saja nama file dari aplikasi sepatu Anda.
$ bin/shoes samples/simple_sound.rb
CATATAN: Untuk Windows, C:tmpshoes4>binshoes samplessimple_sound.rb Jika Anda memasang sepatu 4 sebagai permata, cukup lakukan C:tmp> shoes pathtofile.rb
Ada juga skrip starter ruby sederhana saat menggunakan backend SWT yang dapat Anda gunakan sebagai berikut:
$ bin/shoes-swt samples/simple_sound.rb
Ini belum berfungsi pada Mac sebagai JRuby (JVM) membutuhkan beberapa parameter tambahan. Di sini Anda dapat melakukan hal berikut (yang pada dasarnya adalah apa yang dilakukan bin/sepatu):
$ jruby -J-XstartOnFirstThread bin/shoes-swt samples/simple_sound.rb
Alternatif lain adalah menempatkan require 'shoes' di bagian atas aplikasi Anda, maka Anda bisa melakukannya
$ jruby path/to/file.rb
Di OS X Anda masih perlu memasok parameter tambahan ke Jruby
$ jruby -J-XstartOnFirstThread path/to/file.rb
Anda dapat menjalankan rake samples dan sampel acak yang kami percaya bekerja akan dijalankan sampai Anda berhenti dengan CTR + C. Beberapa di antaranya sangat sederhana, sementara yang lain lebih kompleks atau bahkan permainan! Jika Anda melihat masalah apa pun dengan sampel -sampel itu, beri tahu kami!
Dengan mengatur variabel lingkungan SHOES_USE_INSTALLED ke true, Anda juga dapat menggunakan versi Anda yang terpasang dari sepatu (perintah shoes ) untuk menjalankan sampel alih -alih bin/shoes lokal.
Kemasan hanyalah bayi, jadi bersikaplah lembut.
Untuk mengemas aplikasi, Anda harus memasang permata sepatu di lingkungan Anda. Jika Anda tidak melakukan instalasi permata, Anda selalu dapat menghasilkan permata dan menginstalnya dari sumber saat ini:
$ rake install:all
Sekarang, Anda dapat mengemas aplikasi. Tapi pertama -tama, lihat di sini:
.gemspec atau Gemfile . Menggunakan Warbler, yang selalu mencari file -file tersebut. Jika Anda menjalankan spesifikasi, Anda mungkin melihat beberapa peringatan seperti ini:Peringatan: Komponen `Path 'bundler saat ini tidak didukung. Komponen `sepatu-4.0.0.pre1 'tidak dibundel. Aplikasi Anda mungkin gagal boot!
Itu warbler berbicara. Sebenarnya, kami menyelinap permata sepatu, tapi jangan tahu.
Oke, sekarang nyata. Yang paling sederhana adalah menempatkan skrip Anda di direktori dengan sendirinya dan kemudian:
$ bin/shoes package --mac path/to/directory-of/your-shoes-app.rb
Ini akan menghasilkan aplikasi Mac, yang kemudian dapat Anda temukan di path/to/directory-of/pkg/your-shoes-app.app .
Anda juga dapat mengemas aplikasi sepatu sebagai toples melalui:
$ bin/shoes package --jar path/to/directory-of/your-shoes-app.rb
Anda dapat menemukan stoples di direktori yang sama seperti di atas, yaitu jalur/ke/direktori/pkg/Anda-sepatu-app.jar
Jika Anda ingin lebih banyak kontrol (seperti Anda ingin memberi nama aplikasi Anda sesuatu selain "aplikasi sepatu", atau Anda tidak ingin memasukkan semua file yang kami bicarakan sebelumnya), buat file app.yaml . Lihat contoh untuk detail lebih lanjut.
Catatan: Jika Anda menggunakan app.yaml , Anda harus menyesuaikan atau mengomentari setiap opsi. Contohnya hanyalah sebuah contoh;)
Saat Anda memiliki file app.yaml tepat di sebelah skrip Anda, Anda memiliki tiga opsi:
$ bin/shoes package --mac path/to/directory-of/your-shoes-app.rb
$ bin/shoes package --mac path/to/directory-of/app.yaml
$ bin/shoes package --mac path/to/directory-of
Packager akan menemukan instruksi Anda menggunakan salah satu dari perintah itu. Sekali lagi, Anda akan menemukan aplikasi Anda di direktori pkg di dalam direktori proyek Anda. Cari tahu lebih lanjut di bin/shoes --help .
Oh, dan Anda juga bisa menjalankan aplikasi sepatu Anda dengan bin/shoes .
Itu luar biasa, terima kasih!
Anda dapat mencoba memperbaiki salah satu masalah kami. Kami telah memperkenalkan tag baru 'Friendly Newcomer' untuk masalah yang kami yakini cocok untuk memulai dengan sepatu yang berkontribusi. Masalah -masalah ini relatif mudah dicapai atau tidak bergantung pada banyak kode sepatu lainnya (misalnya fitur yang benar -benar baru) sehingga lebih mudah untuk memulai. Silakan menangani masalah apa pun - kami akan membantu Anda jika diperlukan. Tag hanyalah sebuah saran! =)
Juga ada daftar sampel yang sudah berfungsi di sampel/readme, bersama dengan semua sampel lainnya. Anda dapat mencoba mendapatkan sampel baru untuk dijalankan. Untuk melakukannya, Anda dapat menjalankan rake non_samples untuk menjalankan sampel acak yang kami pikir tidak berfungsi. Jika Anda hanya ingin mencantumkan sampel yang tidak berfungsi, Anda juga dapat menjalankan rake list_non_samples .
Dengan semua yang Anda lakukan, pastikan untuk menulis spesifikasi karena sepatu 4 dikembangkan gaya TDD (lihat bagian spesifikasi yang sedang berjalan di bawah). Jadi pastikan Anda tidak melanggar tes apa pun :-)
Jika Anda merasa tidak yakin tentang pengujian atau implementasi Anda cukup buka masalah atau permintaan tarik. Permintaan tarik tidak perlu dilakukan - mereka adalah pemula diskusi yang hebat! Kami dengan senang hati membantu Anda menyiapkan kontribusi Anda untuk digabungkan untuk membantu membangun sepatu 4!
Bahkan kami sangat menghargai permintaan tarikan awal untuk meninjau kode dan membantu Anda menemukan jalan di sekitar sepatu 4! =)
Jika Anda memiliki pertanyaan, jangan ragu untuk mampir di saluran #Shoes di FreeNode IRC. Orang mungkin tidak menanggapi secara instan, tetapi setelah beberapa waktu seseorang akan merespons :-)
Kadang -kadang juga merupakan cara yang baik untuk refactor beberapa kode atau menulis beberapa spesifikasi untuk membiasakan diri dengan suatu proyek. Jika Anda ingin mencoba pendekatan ini, Anda dapat melihat iklim kode kami untuk menemukan kandidat untuk refactoring atau setelah menjalankan spesifikasi secara lokal mengambil puncak ke direktori cakupan dan membuka indeks.html - ini menunjukkan kepada Anda data cakupan kami saat ini. Lihat sesuatu yang tidak tercakup dan mungkin Anda bisa menulis spesifikasi untuk itu?
Lihat bagian berikut untuk informasi tentang cara menjalankan spesifikasi, yang disebutkan sebelumnya :-)
Sepatu 4 dikembangkan dalam gaya TDD menggunakan RSPEC. Anda harus menulis dan menjalankan spesifikasi :)
Cara paling sederhana untuk melakukan ini adalah dengan tugas menyapu.
$ bundle exec rake
(Coba rake --tasks untuk daftar lengkap)
Jika Anda ingin detail lebih lanjut tentang mode lain untuk menjalankan spesifikasi, filosofi tentang bagaimana dan apa yang harus diuji, lihat entri sepatu pengujian di wiki.
Jalan jauh di hari itu, ada seorang pria bernama _Why. Dia menciptakan proyek yang dikenal sebagai Hackety Hack untuk mengajarkan pemrograman kepada semua orang. Untuk mencapai semua penjuru bumi, _Why memutuskan untuk membuat peretasan Hackety bekerja pada Windows, Mac OS X, dan Linux. Ini banyak pekerjaan, dan _Why memutuskan untuk berbagi toolkitnya dengan dunia. Dengan demikian, sepatu lahir.
Sepatu dilahirkan untuk mengajarkan pemrograman kepada semua orang, di seluruh penjuru bumi. Tidak keren untuk membuat programmer atau programmer baru dengan bahasa Inggris yang buruk merasa buruk karena mereka tidak menulis ruby / bahasa Inggris dengan sangat baik. Dan jelas setiap komentar anti-sosial lainnya yang diarahkan pada agama, etnis, ras, identitas gender, atau barang-barang pribadi apa pun yang tidak akan ditoleransi di sini di tanah Chunky-Bacon! Jika anggota masyarakat merasa seperti komentar Anda tidak sesuai dengan ruang proyek apa pun (kode, masalah, ruang obrolan, milis), mereka akan dengan baik memberi tahu Anda cara meningkatkan sesuai kode perilaku kami.
Bottom-line adalah: bersenang-senang dengan sepatu!
Jika Anda ingin tetap mengikuti perkembangan dengan apa yang terjadi dengan sepatu, Anda dapat menemukan kami di berbagai tempat:
Ingin menghubungi komunitas sepatu? Itu bagus! Anda dapat menghubungi di sini:
Namun kami mencoba untuk menjaga sebagian besar diskusi tentang pengembangan dalam repositori ini/masalahnya sehingga semua orang dapat melihatnya dan mencarinya.
