Instrukcja instalacji środowiska programistycznego dla RoR

tutorial Krzysztofa Kluzy (bardziej rozbudowany niż poniższe instrukcje)

Instalacja MySQL

  • ze strony: http://dev.mysql.com/downloads/mysql/5.0.html#Windows pobrać pakiet Windows (x86) - NIE Windows Essentials, NIE Without Installer
  • rozpakować, uruchomić setup
  • w okienku "Please select a setup type" wybrać opcję "Typical"
  • w następnym okienku zostawić zaznaczonego checkboxa "Configure the MySQL Server" i wybrać "Finish"
  • przy pytaniu o typ konfiguracji wybrać "standard configuration"
  • zaznaczyć opcję "install as windows service" oraz "include bin directory in windows path"
  • w okienku tworzenia użytkownika odznaczyć chekboxy przy "modify security settings" oraz "create anonymous account"
  • sprawdzić poprawność instalacji - uruchomić linię poleceń (Run -> cmd) i wpisać: 
    mysql

Instalacja Ruby, RubyGems

  • ściagnąć instalator rubiego ze strony: http://rubyforge.org/frs/?group_id=167 - zalecana wersja dla Rails 1.2 to 1.8.6, na wierzbie i w pracowni zainstalowano 1.8.4, która również jest odpowiednia
  • po ściągnięciu uruchomić instalator
  • w okienku wyboru komponentów zaznaczamy "enable rubygems"; scite, freeride - są to proste edytory do rubiego, można pominąć jeśli chcemy używać innego środowiska
  • w kolejnych oknach dialogowych wybrać katalog instalacyjny (najlepiej zostawić domyślny), nazwę pozycji w menu start
  • po zakończeniu sprawdzić poprawność instalacji - uruchomić linię komend (Run -> cmd):
    • wpisać ruby -v - powinna się wypisać wersja rubiego
    • wpisać gem list - powinny się wypisać zainstalowane pakiety (LOCAL GEMS)

Instalacja Ruby on Rails

w linii komend wpisać polecenie:

gem install rails --include-dependencies

Najlepiej zainstalować wersję 1.2, taka jest w pracowni i będzie również udostępniona na wierzbie. Powyższe polcenie zainstaluje najnowszą aktualnie dostępną wersję, jeśli chcemy upewnić się, że zostanie zainstalowana wersja 1.2:

gem install --version '= 1.2.0' rails --include-dependencies

W przypadku błędu:


ERROR: While executing gem ... (SocketError)
getaddrinfo: no address associated with hostname.

najlepiej spróbować zainstalować wymagane komponenty lokalnie, bez pobierania ich z repozytorium przez instalator. Sposób postępowania opisano np. tutaj.

następnie sprawdzić poprawność instalacji railsow:

  • w linii komend wejść do wybranego katalogu i utworzyć testowy projekt: 
    rails blog
  • wejść do utworzonego katalogu aplikacji: cd blog
  • wygenerowac szkielet testowego kontrolera hello z metodą index: 
    ruby script/generate controller Hello index
  • w wybranym edytorze (np. textpad) otworzyć plik: blog/app.controllers/hello_controller.rb
  • wyedytować go do następującej postaci: 
    
class HelloController < ApplicationController

  def index
	@msg = 'hello'
  end
end
  • następnie w wybranym edytorze otworzyć plik blog/app/views/hello/index.html
  • wyedytować go do następującej postaci: 
    

<h1>Hello#index</h1>
<p><%= @msg %></p>
  • uruchomić serwer - w linii komend wejsć do katalogu blog i wpisać polecenie: 
    ruby script/server
  • w przeglądarce wpisać: http://localhost:3000/hello
  • powinien pojawić się tekst: 
    Hello#index

hello

Instalacja IDE do programowania w RoR

Jednym z dostępnych darmowych zintegrowanych środowisk tworzenia kodu w Ruby on Rails jest Aptana, dostępna jako osobna aplikacja lub jako plugin do Eclipse. Pliki do pobrania i instrukcje na stronie: Aptana RadRails

Dodatkowe źródła:

  1. mysql
  2. ruby, rubygems, rails
  3. IDE