Du har hittat ett Ruby-bibliotek som verkar lösa precis det du behöver, men frågan är om du ska installera det direkt eller låta projektet styra versionen. En RubyGem är oftast lätt att lägga till med Bundler, men rätt arbetssätt beror på om du bygger en app eller själva biblioteket.

En gem levereras av RubyGems och hanteras i projektet med Bundler
- RubyGems installerar och paketerar bibliotek; Bundler löser projektets beroenden.
- Gemfile anger vilka bibliotek projektet behöver.
- Gemfile.lock sparar de lösta versionerna för en applikation.
- Applikation eller gem: låsfilen ska normalt checkas in för en app, men följer inte med i en publicerad gem.
RubyGems, RubyGems.org och Bundler gör olika jobb
Namnen ligger nära varandra, så det är lätt att blanda ihop dem. RubyGems är pakethanteraren och kommandoradsverktyget som installerar gems; RubyGems.org är en värdtjänst där Ruby-bibliotek publiceras och hämtas. Bundler håller i stället reda på vilka gems ett enskilt projekt behöver.
En gem kan innehålla återanvändbar kod, körbara kommandon och metadata om bland annat beroenden. För en app beskriver du de direkta beroendena i en Gemfile; Bundler hittar sedan versioner som fungerar tillsammans. RubyGems guider skiljer på de här rollerna, och den skillnaden gör det lättare att felsöka installationer.
Jag tycker att det är mest användbart att se RubyGems som distributionslagret och Bundler som projektets versionsplanerare. Det blir särskilt tydligt när samma bibliotek fungerar i ett projekt men orsakar problem i ett annat.
Gemfile.lock hindrar att appens beroenden glider isär
En installation kan lyckas på din dator och ändå ge ett annat resultat på en kollegas maskin. Gemfile.lock minskar risken genom att spara de exakta versioner som Bundler valt, även för beroenden som dina gems själva använder. Därför kan teamet och driftsmiljön installera samma uppsättning i stället för att lösa om allt från början.
För en applikation är tumregeln tydlig: checka in Gemfile.lock. En vanlig missuppfattning är att låsfilen alltid hör till den gem som utvecklas. RubyGems dokumentation skiljer på fallen: en publicerad gem skickar inte med projektets låsfil till användarna, eftersom deras appar löser beroendena tillsammans. Bundler-arbetsflödet förklarar den skillnaden.
Om du ändrar en version och installationen plötsligt drar in fler uppdateringar än väntat, granska diffen i låsfilen före commit. En liten ändring i Gemfile kan påverka hela beroendeträdet, så låsfilen är också ett synligt kvitto på vad som faktiskt ändrades.
Välj installationssätt efter om du bygger en app eller en gem
Det praktiska beslutet börjar med projektets roll. Bygger du en app? Lägg till beroendet i Gemfile och låt Bundler hantera installationen. Bygger du en gem? Ange beroenden i gemspec-filen, så att projekt som installerar biblioteket får information om vad det behöver.
| Situation | Trolig orsak eller följd | Gör så här |
|---|---|---|
| Appen fungerar lokalt men inte efter deploy | Låsfilen saknas eller har inte följt med ändringen | Kontrollera att Gemfile.lock är versionshanterad och uppdaterad |
| Du skapar ett återanvändbart bibliotek | Användarna behöver själva lösa projektets versioner | Deklarera beroenden i gemspec-filen |
| Du vill testa en lokal ändring av en gem | Den publicerade versionen innehåller inte din arbetskopia | Använd Bundlers path- eller git-stöd och kontrollera sedan låsfilen |
| Installation misslyckas utan nätverk | En nödvändig gem saknas i lokal cache | Kontrollera cache eller vendor/cache; bundle install --local söker inte på RubyGems.org |
Det sista fallet överraskar ofta: --local betyder att Bundler inte försöker ansluta till fjärrkällan. Referensen för bundle install beskriver vad flaggan gör och var Bundler letar efter redan hämtade gems.
En versionsändring kan påverka fler bibliotek än du räknar med
Säg att en svensk frilansare bygger en webbplats med en appgem och ett testbibliotek. Efter att ha ändrat en versionsgräns i Gemfile kör personen bundle install; Bundler löser då beroendena för projektet som helhet och uppdaterar Gemfile.lock. Om ändringen dessutom flyttar en underliggande gem till en ny version kan testmiljön påverkas, trots att den inte nämns direkt i Gemfile.
Beslutsregeln är enkel: om du arbetar med en app och vill ha upprepbara installationer, behåll och granska låsfilen. Om du utvecklar ett bibliotek som ska fungera tillsammans med olika användares projekt, deklarera beroendena i gemspec och testa kompatibiliteten där i stället för att förlita dig på en enda låst uppsättning.
Bundler löser beroenden samtidigt och skriver resultatet till låsfilen, enligt RubyGems dokumentation om beroendelösning. Det förklarar varför en till synes liten versionsändring ibland ger en större diff än väntat.
En stabil Ruby-miljö börjar med rätt fil på rätt plats
När du väljer en RubyGem, kontrollera att den passar projektets Ruby-version och att dess beroenden går att lösa. För appar är Gemfile och Gemfile.lock ett par: den ena beskriver vad du vill använda, den andra visar vilken uppsättning Bundler faktiskt valde.
Jag skulle börja med Bundler i ett nytt appprojekt och låta Gemfile vara den tydliga listan över direkta beroenden. Det ger ett lugnare arbetsflöde än att installera gems globalt och hoppas att alla utvecklings- och driftsmiljöer råkar få samma versioner.