Jak zainstalować Ruby i Ruby on Rails oraz używać RubyGems

Słyszałeś już o Ruby on Rails i o tym, jak łatwo z jego pomocą szybko tworzyć działające aplikacje. Sam proces tworzenia nowego oprogramowania wymaga jednak kilku klocków oraz zrozumienia, jak sprawnie się nimi posługiwać.

Pierwszym krokiem jest oczywiście instalacja samego Ruby. Gdy liczba projektów szybko wzrośnie, zarządzanie wieloma wersjami Ruby potrafi być uciążliwe. Z pomocą przychodzi społeczność open source, która przygotowała kilka menedżerów wersji, z których najpopularniejsze to rbenv i rvm.

Jak zainstalować Ruby na Mac?

Zarówno rvm, jak i rbenv są dostępne na MacOS i popularne dystrybucje Linuxa, więc cały proces sprowadza się do wklejenia kilku poleceń w terminalu.

rbenv

1. Mając zainstalowany Homebrew, uruchom init w Terminalu (a jeśli go nie masz, możesz zainstalować rbenv przez GitHub checkout):

$ brew install rbenv

2. Po zakończeniu wpisz:

$ rbenv init

3. To wyświetli instrukcję konfiguracji powłoki. Zwykle wystarczy dodać jedną linię do .zshrc lub .bash_profile:

$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc

4. Od teraz przy każdym uruchomieniu Terminala rbenv powinien być gotowy do pracy.

$ source  ~/.zshrv

5. Na koniec pora zainstalować właściwy Ruby. Teraz to proste — po poleceniu install podaj numer wersji:

$ rbenv install 2.7.0
$ rbenv global 2.7.0

6. Aby ustawić lokalną wersję do użycia, wpisz:

$ rbenv local 2.7.0

rvm

Jeśli zainstalowałeś już Ruby przy użyciu rbenv, praca jest zakończona. Rvm to alternatywne narzędzie do tego samego celu i generalnie nie warto używać obu jednocześnie — zresztą nie ma takiej potrzeby.

Instalacja rvm jest podobna do rbenv — znów wystarczy wykonać kilka poleceń w konsoli:

1. Zacznijmy od dodania kluczy PGP:

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

2. Następnie pobierz rvm i od razu zainstaluj najnowszą wersję Ruby:

$ curl -sSL https://get.rvm.io | bash -s stable --ruby

3. Różne wersje Ruby można szybko pobierać i instalować poleceniem install, na przykład:

$ rvm install 2.7.0

Warto wspomnieć, że w katalogu projektu możesz utworzyć plik .ruby-version (zwykły plik tekstowy z numerem wersji Ruby). Na podstawie tego pliku zarówno rbenv, jak i rvm spróbują użyć właściwej wersji Ruby lub zaproponują instalację brakującej.

Jak zainstalować Ruby na Windows?

Jeśli korzystasz z Windows, najlepszą opcją jest RubyInstaller. Pobierz plik .exe dla wybranej wersji Ruby i uruchom instalację. RubyInstaller można połączyć z MSYS2 (port zestawu narzędzi deweloperskich Unix) i bibliotekami MinGW, co zapewnia świetne środowisko deweloperskie.

Sprawdzenie instalacji Ruby

Po instalacji możesz sprawdzić wersję poleceniem:

$ ruby -v

Oraz zobaczyć, gdzie znajduje się interpretator:

$ which ruby

Ruby to język interpretowany. Aby uruchomić kod, wystarczy wskazać plik .rb i wykonać go:

$ ruby app.rb

Razem z interpretatorem dostajesz Interactive Ruby Shell (irb), który wykonuje polecenia Ruby w czasie rzeczywistym, gdy je wpisujesz:

$ irb
irb(main):001:0> 2+2
=> 4

Czym jest RubyGems?

Standardowa instalacja Ruby zawiera Ruby Core API i Standard Library API, wykorzystywane do pisania aplikacji w Ruby. Proste aplikacje można tworzyć od zera z użyciem tych API, ale przy bardziej złożonych projektach najlepiej korzystać z pakietów Ruby dostarczanych przez menedżer pakietów. Ruby ma swój — RubyGems, a pakiety nazywają się gemami. 

RubyGems dostarcza narzędzie wiersza poleceń o nazwie gem. Instaluje ono gemy z określonych publicznych lub prywatnych repozytoriów. Warto też wspomnieć o https://rubygems.org/, które hostuje wiele gemów społeczności Ruby. Zazwyczaj gem dostarcza nowe biblioteki o określonej funkcjonalności, a czasem także narzędzia konsolowe. 

RubyGems jest częścią standardowej instalacji Ruby, więc nie trzeba niczego dodatkowo instalować.

Jak używać Ruby Gems?

Zobaczmy, jak pracować z gemami. To polecenie wypisze ustawienia RubyGems wraz z informacją, gdzie instalowane są gemy:

$ gem env

Instalacja / odinstalowanie gemów

Aby instalować i odinstalowywać gemy, wpisz:

$ gem install gem_name (-v version to specify gem version)
$ gem uninstall gem_name

Aktualizacja gemów

Aby zaktualizować konkretny gem, uruchom:

$ gem update gem_name

Albo wszystkie gemy:

$ gem update

Lista gemów

Gemy są instalowane w lokalnym repozytorium. Aby wyświetlić listę zainstalowanych gemów, wpisz:

$ gem list

Podczas instalacji gemów wszystkie zależności są instalowane razem z gemem.

Ruby Bundler

W trakcie rozwoju projektu możesz odkryć, że wymaga on coraz większej liczby gemów. Ręczna instalacja wszystkich gemów poleceniem gem byłaby trudna, jeśli nie niemożliwa, aby dopasować wszystkie zależności. Służy do tego sprytne narzędzie do zarządzania gemami w projekcie — Bundler.

Instalacja Bundlera i określenie gemów dla projektu

Bundler jest gemem, więc najpierw go zainstaluj:

$ gem install bundler

Następnie utwórz plik Gemfile w katalogu głównym projektu o treści:

source ‘https://rubygems.org’ gem ‘rails’, ’6.0.2.1’ gem ‘rspec’

Instalacja gemów za pomocą Bundlera

Aby zainstalować, wpisz:

$ bundle install

Zainstaluje to wszystkie gemy z określonymi wersjami oraz ich zależnościami. Jeśli chcesz użyć innego gema w projekcie, dodaj go do Gemfile i ponownie uruchom bundle install.

Aktualizacja gemów przy użyciu Bundlera

Jeśli chcesz zaktualizować niektóre gemy w projekcie, zmień wersję w Gemfile i ponownie uruchom:

$ bundle install

Aby zaktualizować konkretny gem, uruchom:

$ bundle update gem_name

Albo wszystkie gemy:

$ bundle update

W obu przypadkach Bundler rozwiąże zależności.

Jak używać Ruby on Rails?

Po wszystkich instalacjach i ustawieniach pora rozpocząć nowy projekt Ruby on Rails i skonfigurować kilka rzeczy. 

Instalacja Rails

Bez zaskoczeń — Rails jest dostępny jako gem:

$ gem install rails

Zainstaluje to najnowsze Rails wraz z gemami, od których Rails zależy. Rails ma też własne narzędzie wiersza poleceń, którego można użyć do tworzenia nowej aplikacji Ruby on Rails.

Sprawdź wersję i pomoc opisującą opcje tworzenia nowej aplikacji.

$ rails -v
$ rails -h

Nowa aplikacja Rails

Aby utworzyć projekt Rails z domyślnymi opcjami, wpisz:

$ rails new my_amazing_rails_app

To polecenie wygeneruje całą strukturę projektu w katalogu my_amazing_rails_app. Zobaczysz wypis tworzenia plików aplikacji, a następnie Bundler zainstaluje wszystkie zależności z nowo utworzonego Gemfile. 

Następnie przejdź do katalogu my_amazing_rails_app i uruchom serwer Rails.

$ cd my_amazing_rails_app
$ rails server

Uruchomi to serwer WWW Puma, domyślnie używany przez aplikacje Rails. Domyślny port to 3000. Otwórz przeglądarkę, wejdź na http://localhost:3000 i powinieneś zobaczyć stronę powitalną Rails.

Jak skonfigurować środowisko deweloperskie Ruby on Rails?

Domyślną bazą danych używaną przez Rails jest SQLite. Jeśli od początku chcesz używać innej bazy, możesz wskazać ją opcją:

$ rails new my_amazing_rails_app —database postgresql

Konfiguracja bazy danych znajduje się w pliku config/database.yml. Rails uruchamia aplikację w określonym środowisku (lokalnie domyślnie używane jest środowisko „development”). Aby podać własne ustawienia bazy, edytuj sekcję development w config/database.yml. 

Inną często używaną opcją jest api, która konfiguruje aplikację z ograniczonym middleware, tylko dla aplikacji typu API.

$ rails new my_amazing_rails_app —api

Rails generuje wiele plików. W katalogu app znajdziesz główne pliki aplikacji. Ponieważ Rails powstał zgodnie ze wzorcem MVC (Model-View-Controller), znajdują się tam pliki modeli, kontrolerów i widoków w odpowiednich katalogach. W katalogu config znajdziesz pliki konfiguracyjne aplikacji, środowisk, bazy danych, tras itd. W katalogu db znajdziesz schemat bazy i pliki migracji.

Co dalej?

Istnieje wiele tutoriali i przewodników po Rails. Wystarczy wspomnieć https://guides.rubyonrails.org/, gdzie opisano większość funkcji Rails z przykładami. API Ruby i Rails jest dobrze udokumentowane. Po prostu utwórz nową aplikację, stwórz model, kontroler i widok — i możesz zakochać się w Rails!

Jeśli interesuje Cię rozwój w Ruby on Rails, przeczytaj nasz artykuł, aby dowiedzieć się, dlaczego warto uczyć się Ruby on Rails.