Gems ni packages (libraries) za Ruby zinazosambazwa kupitia RubyGems. Bundler husimamia dependencies za gem za project — kusakinisha versions sahihi na kuhakikisha mazingira thabiti, yanayoweza kurudiwa kwenye mashine tofauti kupitia lockfile. Kwa pamoja ndizo jinsi projects za Ruby zinavyosimamia dependencies.
gem install rails
gem list
Gem ni library ya Ruby iliyofungashwa (code + metadata). RubyGems ni package manager na rubygems.org ni registry — sawa na npm/pip ya 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
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 hutangaza dependencies za project yako pamoja na version constraints. bundle install huzisakinisha na hutengeneza Gemfile.lock.
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 hubandika versions kamili za kila gem (ikijumuisha transitive dependencies), hivyo kuifanya commit huhakikisha kwamba waendelezaji wote, CI, na production wanasakinisha mti uleule wa dependencies — mazingira yanayoweza kurudiwa na thabiti. Iifanye commit daima.
bundle exec rspec # runs rspec using the EXACT versions in Gemfile.lock
# (vs `rspec` which might use a different globally-installed version)
Gems na Bundler ni vya msingi kwa uendelezaji wa Ruby — ndizo jinsi takriban kila project ya Ruby inavyosimamia dependencies, hivyo kuvielewa ni lazima. Gems (packages za Ruby kutoka rubygems.org) hutoa libraries na frameworks (Rails, RSpec, n.k.) ambazo applications halisi hutegemea, na Bundler ni zana ya kawaida ya kuzisimamia ndani ya project.
Thamani kuu ambayo Bundler hutoa — na dhana muhimu zaidi kuelewa — ni mazingira yanayoweza kurudiwa na thabiti: Gemfile hutangaza dependencies pamoja na version constraints, na Gemfile.lock hubandika versions kamili za kila gem (ikijumuisha transitive dependencies) zilizosakinishwa.
Kuifanya commit Gemfile.lock huhakikisha kwamba kila mtu — timu nzima, CI, na production — husakinisha mti uleule wa dependencies, ukizuia bugs za "inafanya kazi kwenye mashine yangu" zinazotokana na tofauti za versions.
Uwezo huu wa kurudiwa ni muhimu kwa uendelezaji na utumiaji wa kuaminika na wa ushirikiano.
Kuelewa gems (packages za Ruby), Gemfile (kutangaza dependencies), bundle install, lockfile na kwa nini kuifanya commit (usakinishaji unaoweza kurudiwa — faida kuu), na bundle exec (kuendesha commands kwa versions kamili za project) ni maarifa muhimu ya kila siku kwa project yoyote ya Ruby.
Kwa kuwa usimamizi wa dependencies ni wa msingi kwa applications halisi, na kwa kuwa uwezo wa kurudiwa unaotegemea lockfile wa Bundler ndiyo jinsi timu za Ruby zinavyohakikisha mazingira thabiti kwenye uendelezaji, CI, na production, kufahamu gems na Bundler — sawa na npm/package-lock.json katika Node — ni maarifa ya lazima, yanayotumika mara kwa mara kwa uendelezaji wa kitaalamu wa Ruby.