Menggunakan Ruby

ServBay menyediakan persekitaran pembangunan yang cekap dan fleksibel untuk pembangun Ruby di macOS. Melalui sistem pengurusan pakej ServBay, anda boleh memasang dan mengurus pelbagai versi Ruby secara selari dengan mudah, serta menggunakan fail .servbay.config yang berkuasa untuk menentukan versi Ruby khusus bagi setiap projek, seterusnya memudahkan aliran kerja pembangunan dan menjamin konsistensi persekitaran.

Gambaran Keseluruhan

Pengenalan Bahasa Ruby

Ruby ialah bahasa pengaturcaraan berorientasikan objek yang dinamik dan sumber terbuka. Ia terkenal dengan sintaksnya yang ringkas dan elegan serta sangat menekankan produktiviti pembangun. Ruby dicipta oleh saintis komputer Jepun, Yukihiro "Matz" Matsumoto, pada pertengahan 1990-an dengan falsafah reka bentuk “menjadikan pengaturcaraan lebih menggembirakan”. Ruby banyak dipengaruhi oleh bahasa seperti Perl, Smalltalk, Eiffel, Ada, dan Lisp, membawa penekanan kepada kejelasan dan kesederhanaan kod.

Dalam Ruby, segala-galanya adalah objek. Ia menyokong pelbagai paradigma pengaturcaraan termasuk berorientasikan objek, prosedur, dan fungsi. Ruby memperoleh populariti globalnya terutamanya selepas David Heinemeier Hansson (DHH) melancarkan rangka kerja pembangunan web Ruby on Rails pada tahun 2004, yang sangat meningkatkan kecekapan pembangunan aplikasi web. Kini, Ruby digunakan secara meluas untuk pembangunan web (Rails, Sinatra), penulisan skrip, automasi tugasan, perekaan prototaip, dan banyak lagi. Ekosistemnya sangat bergantung pada RubyGems (pengurus pakej) dan Bundler (alat pengurusan kebergantungan).

Sokongan Ruby oleh ServBay

ServBay mengurus pelbagai versi pengantara Ruby sebagai pakej perisian yang berdiri sendiri. Ini memberi anda kelebihan utama berikut:

1. Berbilang Versi Serentak: Memasang beberapa versi Ruby pada masa yang sama (contohnya Ruby 2.7, 3.0, 3.3, 3.4, dsb.) tanpa perlu risau tentang konflik versi.
2. Kawalan Versi Per Projek: Melalui fail .servbay.config yang unik kepada ServBay, anda boleh menentukan dengan tepat versi Ruby yang diperlukan setiap projek anda.
3. Pengurusan Ringkas: Lihat, pasang, dan nyahpasang mana-mana versi Ruby dengan mudah melalui antara muka grafik ServBay.
4. Integrasi Pengurusan Gem: Selepas memasang Ruby, anda terus boleh menggunakan arahan gem untuk mengurus RubyGems.

Ini amat penting bagi pembangun yang perlu menyelenggara projek lama menggunakan Ruby versi berbeza, membangunkan projek baharu (seperti aplikasi Ruby on Rails), atau menjalankan alat Ruby yang tertentu.

Mengakses Pakej Ruby

1. Buka aplikasi ServBay.
2. Dalam bar navigasi kiri, klik Pakej (Packages).
3. Di halaman Pakej, tatal ke bawah atau pilih Languages -> Ruby di senarai terperinci di sebelah kiri.
4. Kawasan kanan akan memaparkan senarai semua pakej Ruby yang tersedia.

Memasang Ruby

Senarai pakej memaparkan dengan jelas status setiap versi Ruby:

• Nama Pakej: Nama pakej, seperti Ruby 3.3.
• Versi: Nombor versi khusus untuk pakej tersebut.
• Status: Tunjuk Installed (Dipasan) atau Not Installed (Belum Dipasang).
• Kawalan: Sediakan butang operasi.

Untuk memasang versi Ruby yang belum dipasang (contohnya Ruby 3.3):

1. Cari versi yang diinginkan dalam senarai.
2. Pastikan statusnya adalah Not Installed.
3. Klik ikon Muat Turun/Pasang (Download/Install) paling kanan pada baris tersebut (biasanya ikon anak panah ke bawah).
4. ServBay akan mula memuat turun dan memasang versi Ruby yang dipilih. Proses pemasangan mungkin mengambil sedikit masa.
5. Selepas berjaya dipasang, status versi tersebut akan berubah menjadi Installed dan ikon kawalan bertukar kepada Nyahpasang (Uninstall) (ikon tong sampah).

Mengurus Versi Ruby yang Dipasang

• Lihat Versi Dipasang: Status Installed pada senarai dengan jelas menandakan semua versi Ruby yang telah dipasang pada persekitaran anda.
• Nyahpasang Ruby: Jika anda tidak lagi memerlukan versi Ruby yang dipasang, hanya klik ikon Nyahpasang (Uninstall) (ikon tong sampah) dan sahkan untuk membuangnya dari sistem.

Menggunakan Ruby yang Dipasang

Selepas pemasangan, ServBay akan menambah Ruby ke dalam pembolehubah persekitaran yang dikawalnya. Apabila anda mengaktifkan persekitaran ServBay dalam terminal, anda boleh terus menggunakan arahan ruby dan gem.

Contoh Arahan Biasa:

1. Semak Versi Ruby Aktif: Buka terminal dan jalankan:

   ruby -v

   Ini akan memaparkan versi Ruby yang sedang diaktifkan pada sesi terminal anda. Versi ini mungkin dipengaruhi oleh tetapan global atau fail .servbay.config per projek.

2. Semak Versi RubyGems:

   gem -v

3. Pasang Pakej Gem: Contoh, pasang penjana laman web statik popular Jekyll:

   gem install jekyll

   Atau pasang rangka kerja Ruby on Rails:

   gem install rails

4. Jalankan Skrip Ruby: Cipta fail bernama hello.rb dengan kandungan berikut:

   #!/usr/bin/env ruby
   puts "Hello from Ruby in ServBay!"

   Jalankan dalam terminal:

   ruby hello.rb

Pengurusan Versi Per Projek: .servbay.config

Salah satu kelebihan teras ServBay ialah sokongannya untuk konfigurasi persekitaran per projek. Dengan meletakkan fail bernama .servbay.config di direktori akar projek anda, anda boleh mengunci versi Ruby yang diperlukan bagi projek tersebut.

Kelebihan:

• Pengurusan Berbilang Bahasa: Urus versi Ruby, PHP, Node.js, Python, Go, Java, .NET dan lain-lain dalam satu fail.
• Jamin Konsistensi: Pastikan semua ahli pasukan atau persekitaran penghantaran menggunakan versi Ruby yang sama tanpa perbezaan.
• Penukaran Otomatik: Apabila anda masuk ke direktori yang mengandungi .servbay.config menggunakan arahan cd, persekitaran ServBay akan automatik mengesan dan mengaplikasikan nilai RUBY_VERSION yang ditetapkan dalam fail tersebut.

Contoh Konfigurasi:

Di direktori akar projek Ruby anda, cipta fail .servbay.config dan tambah pembolehubah RUBY_VERSION untuk menentukan versi utama Ruby yang diperlukan (contohnya 2.7, 3.3). ServBay akan menggunakan versi terbaru yang telah dipasang dalam siri utama tersebut secara automatik.

# .servbay.config

# Tentukan versi utama Ruby untuk projek ini (misal 3.3)
# ServBay akan guna versi 3.3.x terkini yang telah dipasang
RUBY_VERSION=3.3

# Boleh juga tentukan versi dan konfigurasi bahasa lain
NODE_VERSION=18
# ... konfigurasi lain ...

Apabila anda membuka terminal dalam direktori ini serta mengaktifkan persekitaran ServBay, menjalankan ruby -v akan memaparkan versi Ruby yang ditetapkan dalam .servbay.config (atau versi tertinggi yang telah dipasang dalam siri utama tersebut).

Contoh Penggunaan Mudah

Mari kita buat projek ringkas untuk menunjukkan cara menggunakan .servbay.config:

1. Cipta Direktori Projek:

   mkdir my-ruby-project
   cd my-ruby-project

2. Cipta .servbay.config: Cipta fail .servbay.config di dalam direktori my-ruby-project dengan kandungan berikut:

   RUBY_VERSION=2.7 # Asumkan anda telah memasang Ruby 2.7.x

   (Pastikan Ruby 2.7 telah dipasang dalam ServBay)

3. Cipta Skrip Ruby: Cipta fail app.rb:

   #!/usr/bin/env ruby
   puts "Project is using Ruby version: #{RUBY_VERSION}"

4. Aktifkan dan Sahkan: (Pastikan terminal anda sudah mengaktifkan persekitaran ServBay) Jalankan di direktori my-ruby-project:

   ruby -v

   Output akan memaparkan versi Ruby 2.7.x yang dipasang.

5. Jalankan Skrip:

   ruby app.rb

   Output akan menjadi: Project is using Ruby version: 2.7.x (x ialah nombor revisi sebenar yang telah dipasang).

6. Pasang Kebergantungan Projek (Contoh): Jika projek anda menggunakan Bundler bagi pengurusan kebergantungan (lazim dalam projek Rails), anda boleh menjalankan:

   # Jika bundler belum dipasang
   # gem install bundler
   bundle install

   Bundler akan memasang kebergantungan berdasarkan Gemfile projek dan versi Ruby semasa (2.7.x).

Kini, jika anda mempunyai projek lain yang memerlukan Ruby 3.4, hanya tetapkan RUBY_VERSION=3.4 dalam .servbay.config projek tersebut, dan ServBay akan automatik menukar persekitaran Ruby anda setiap kali anda menukar direktori.

Integrasi dengan Pelayan Web (Rails, Sinatra, dll.)

Untuk aplikasi web yang dibina menggunakan Ruby on Rails, Sinatra atau rangka kerja lain, anda biasanya akan menggunakan pelayan aplikasi seperti Puma, Unicorn, atau Thin. Anda boleh:

1. Cipta sebuah Laman Web (Website) untuk aplikasi anda dalam ServBay.
2. Konfigurasikan pelayan web ServBay (Nginx, Caddy, Apache) sebagai proksi terbalik untuk menghalakan permintaan daripada domain tertentu ke pelayan aplikasi Ruby anda pada port tertentu (contohnya http://localhost:3000 atau Unix socket yang digunakan Puma/Unicorn).

Konfigurasi ini membolehkan anda memanfaatkan pengurusan domain ServBay, HTTPS automatik (jika perlu), serta akses masuk yang seragam kepada aplikasi anda.

Rumusan

ServBay benar-benar memudahkan pembangunan Ruby di macOS. Dengan antara muka pengurusan pakej yang intuitif dan kawalan versi per projek melalui .servbay.config, anda boleh mengurus pelbagai versi Ruby dan Gems dengan mudah, memastikan persekitaran yang bebas konflik dan konsisten untuk setiap projek, dan terus meningkatkan produktiviti projek Ruby anda.