Apakah gem dan Bundler?

Question

Accepted Answer

**Gem** ialah pakej (pustaka) Ruby yang diedarkan melalui RubyGems. **Bundler** menguruskan kebergantungan gem sesuatu projek — memasang versi yang betul dan memastikan persekitaran yang **konsisten dan boleh dihasilkan semula** merentas mesin melalui lockfile. Bersama-sama, ia adalah cara projek Ruby menguruskan kebergantungan.

## Gem — pakej Ruby

```bash
gem install rails          # install a gem globally
gem list                   # list installed gems
# gems come from rubygems.org — the central package registry (Rails, RSpec, etc.)
```

Gem ialah pustaka Ruby yang dipakejkan (kod + metadata). RubyGems ialah pengurus pakej dan rubygems.org ialah registri — setara Ruby dengan npm/pip.

## Bundler — pengurusan kebergantungan projek

```ruby
# Gemfile — declares your project's gem dependencies
source "https://rubygems.org"

gem "rails", "~> 7.0"        # version constraint (~> allows compatible updates)
gem "pg"                     # PostgreSQL adapter
gem "rspec", group: :test    # only in the test environment
```

```bash
bundle install               # install all gems from the Gemfile (creates Gemfile.lock)
bundle update                # update gems to newer allowed versions
bundle exec rspec            # run a command with the project's exact gem versions
```

**`Gemfile`** mengisytiharkan kebergantungan projek anda dengan kekangan versi. `bundle install` memasangnya dan menjana **`Gemfile.lock`**.

## Lockfile — pemasangan yang boleh dihasilkan semula

```text
Gemfile      → declares dependencies with constraints (e.g. rails ~> 7.0)
Gemfile.lock → records the EXACT versions of every gem (and sub-dependency) installed
→ COMMIT Gemfile.lock → everyone (team, CI, production) gets the IDENTICAL versions.
  Prevents "works on my machine" bugs from version differences.
```

**`Gemfile.lock`** menetapkan versi tepat bagi setiap gem (termasuk kebergantungan transitif), jadi mengcommitnya menjamin bahawa semua pembangun, CI, dan production memasang pokok kebergantungan yang *sama* — persekitaran yang boleh dihasilkan semula dan konsisten. Sentiasa commit ia.

## bundle exec — gunakan versi projek

```bash
bundle exec rspec    # runs rspec using the EXACT versions in Gemfile.lock
# (vs `rspec` which might use a different globally-installed version)
```

## Mengapa ia penting

Gem dan Bundler adalah asas kepada pembangunan Ruby — ia adalah cara hampir setiap projek Ruby menguruskan kebergantungan, jadi memahaminya adalah penting. **Gem** (pakej Ruby daripada rubygems.org) menyediakan pustaka dan rangka kerja (Rails, RSpec, dll.) yang menjadi sandaran aplikasi sebenar, dan **Bundler** ialah alat standard untuk menguruskannya dalam sesuatu projek.

Nilai utama yang disediakan oleh Bundler — dan konsep paling penting untuk difahami — ialah **persekitaran yang boleh dihasilkan semula dan konsisten**: **`Gemfile`** mengisytiharkan kebergantungan dengan kekangan versi, dan **`Gemfile.lock`** menetapkan versi *tepat* bagi setiap gem (termasuk kebergantungan transitif) yang telah dipasang.

Mengcommit `Gemfile.lock` menjamin bahawa semua orang — keseluruhan pasukan, CI, dan production — memasang pokok kebergantungan yang sama, mencegah bug "works on my machine" yang timbul daripada perbezaan versi.

Kebolehasilan semula ini adalah kritikal untuk pembangunan dan penyebaran yang boleh dipercayai serta kolaboratif.

Memahami gem (pakej Ruby), Gemfile (mengisytiharkan kebergantungan), `bundle install`, **lockfile dan mengapa perlu mengcommitnya** (pemasangan boleh dihasilkan semula — manfaat utama), dan `bundle exec` (menjalankan arahan dengan versi gem tepat projek) ialah pengetahuan penting dan harian untuk mana-mana projek Ruby.

Memandangkan pengurusan kebergantungan adalah asas kepada aplikasi sebenar, dan kerana kebolehasilan semula berasaskan lockfile Bundler ialah cara pasukan Ruby memastikan persekitaran yang konsisten merentas pembangunan, CI, dan production, menguasai gem dan Bundler — setara dengan npm/package-lock.json dalam Node — ialah pengetahuan penting dan kerap diaplikasikan untuk pembangunan Ruby profesional.