This is an old revision of the document!
Table of Contents
Starten met een Rails-project kan wat verwarrend zijn als je dit nog nooit eerder gedaan hebt. Dit artikel bevat een overzicht tot de benodigde software en de stappen waarin je deze best installeert.
1. Ruby
Mac & Linux
Rails is een Ruby web framework en vereist dan ook een Ruby installatie. Omdat verschillende projecten verschillende Ruby versies kunnen gebruiken is het handig meerdere Ruby versies naast elkaar te kunnen draaien. Wij raden rbenv aan aangezien het een stuk eenvoudiger (en probleemlozer werkt) dan rvm. Rbenv installeer je op de volgende manier:
- Mac OSX: Via brew: handleiding
- Linux: Via je favoriete package manager (rbenv) of via rechtstreeks via Github (zie rbenv#basic-github-checkout)
Op beide platformen moet rbenv worden opgestart bij het openen van de shell, dit kan op de volgende manier (vervang .bash_profile door je favoriete shell zijn profile of rc):
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
Na installatie en herladen van de shell zou type rbenv rbenv is a function of iets dergelijks moeten geven.
Het installeren van een nieuwe Ruby versie kan aan de hand van rbenv install [versie] (bv. rbenv install 2.2.2). De volledige lijst van mogelijke versies kan bekomen worden aan de hand van het commando rbenv list.
Rbenv zal normaal de globaal ingestelde Ruby versie gebruiken, tenzij de gebruiker (of het project) een andere versie specifieert door middel van een .ruby-version bestand met daarin het versienummer. Dit laatste kan door rbenv shell [versie] worden overschreven voor de huidige shell sessie. De globale Ruby versie kan worden aangepast door rbenv global [version].
Windows
Rbenv op Windows wordt niet gedaan, de installatie van Ruby kan via RubyInstaller for Windows.
2. Bundler
Net zoals rbenv de versie van je Rails project beheert, beheert Bundler per project de verschillende versies van dependencies en gems. Wanneer bijvoorbeeld twee verschillende projecten twee verschillende versies van dezelfde gem gebruiken, zorgt Bundler dat deze netjes naast elkaar kunnen gebruikt worden.
Installatie van Bundler is zo simpel als gem install rbenv. Houd er rekening mee dat geïnstalleerde gems afhankelijk zijn van de door rbenv geactiveerde Ruby, het kan dus zijn dat je dit commando opnieuw moet uitvoeren na het installeren van een nieuwe Ruby versie.
Gems worden per project gespecifieerd in de Gemfile. Meer informatie over deze Gemfile kan hier worden verkregen.