Установка Ruby.
Менеджер пакетов gem автоматически скачает все необходимые компоненты, и установит их. Однако это не всегда удобно, и невозможно при наличии прокси сервера.
Установка Ruby
Идем сюда (One-Click Installer — Windows) и скачиваем ruby184-20.exe (27.28 MB).
Запускаем ruby184-20.exe — ruby установился (в папку c:/ruby по умолчанию).
Проверяем в командной строке:
C:>ruby -v
ruby 1.8.4 (2006-07-24) [i386-mswin32]
Если интерпретатор ruby не был найден, возможно, надо закрыть текущую сессию FAR и открыть заново (чтобы "сработали" переменные окружения).
После установки интерпретатора ruby необходимо установить пакет Rails, который собственно и является основой Ruby on Rails.
Для установки Ruby компонентов используется утилита gem. Тут можно воспользоваться двумя способами - автоматическим и ручным. В автоматическом режиме необходимо просто выполнить команду
gem install rails --include-dependencies
Менеджер пакетов gem автоматически скачает все необходимые компоненты, и установит их. Однако это не всегда удобно, и невозможно при наличии прокси сервера.
В этом случае удобнее воспользоваться ручным сособом.
Установка Rails (ручная)
Ручная, т.е. никаких фоновых подключений к серверу, все устанавливается с локально скаченных файлов.
Для установки Ruby компонентов используется утилита gem. И соответственно для этой утилиты нужны файлы с расширением .gem.
Когда файл some_file0.0.0.gem какого-либо модуля скачан, то, чтобы его установить, надо запустить gem:
gem install some_file0.0.0.gem
Rails — это фреймворк, который объединяет несколько компонентов, поэтому каждый из них надо отдельно скачать и установить (при ручной установке, при автоматической они все скачиваются/устанавливаются автоматически).
Согласно этой странице (раздел Manual installation), получаются следующие шаги (порядок важен!), стрелкой указан файл который скачивается, ниже — строка для установки (версии указаны для Rails 1.0):
* Activesupport -> activesupport-1.3.1.gem
gem install activesupport-1.3.1.gem
* Actionpack-> actionpack-1.12.5.gem
gem install actionpack-1.12.5.gem
* Actionmailer -> actionmailer-1.2.5.gem
gem install actionmailer-1.2.5.gem
* Activerecord -> activerecord-1.14.4.gem
gem install activerecord-1.14.4.gem
* Actionwebservice -> actionwebservice-1.1.6.gem
gem install actionwebservice-1.1.6.gem
* Rake -> rake-0.7.1.gem
gem install rake-0.7.1.gem
* Rails-> rails-1.1.6.gem
gem install rails-1.1.6.gem
Суммарный объем всех gem'ов — 1 269Kb
Замечание: версии, конечно, могут измениться в будущем.
Проверяем, что Rails установлен, в командной строке:
C:>rails
Usage: c:/ruby/bin/rails /path/to/your/app [options]
Options:
--ruby [c:/ruby/bin/ruby] Path to the Ruby binary of your choice.
--without-gems Don't use the Rails gems for your app.
WARNING: see note below.
...
установился.
Создание Rails приложения
Rails приложение - это веб приложение, которое решает какую-либо задачу. Каждое приложение распологается в своей папке (с определенной структурой), также каждому приложению соответсвует база данных в MySQL (точнее, 3 бызы, каждая соответсвует режиму работы приложения — development, test, production).
Генерация приложения
Создаем Rails приложение, для этого надо запустить rails, указав папку (имя приложения), например:
rails ToDo
создаст папку ToDo, в которой будет размещено Rails приложение "ToDo".
Вот как это выглядит:
C:rails>rails ToDo
create
create app/apis
create app/controllers
create app/helpers
create app/models
create app/views/layouts
create config/environments
create components
create db
create doc
create lib
create lib/tasks
create log
create public/images
create public/javascripts
create public/stylesheets
create script/performance
create script/process
create test/fixtures
create test/functional
create test/mocks/development
create test/mocks/test
create test/unit
create vendor
create vendor/plugins
create Rakefile
create README
create CHANGELOG
create app/controllers/application.rb
create app/helpers/application_helper.rb
create test/test_helper.rb
create config/database.yml
create config/routes.rb
create public/.htaccess
create config/boot.rb
create config/environment.rb
create config/environments/production.rb
create config/environments/development.rb
create config/environments/test.rb
create script/breakpointer
create script/console
create script/destroy
create script/generate
create script/performance/benchmarker
create script/performance/profiler
create script/process/reaper
create script/process/spawner
create script/process/spinner
create script/runner
create script/server
create public/dispatch.rb
create public/dispatch.cgi
create public/dispatch.fcgi
create public/404.html
create public/500.html
create public/index.html
create public/favicon.ico
create public/robots.txt
create public/javascripts/prototype.js
create public/javascripts/scriptaculous.js
create public/javascripts/effects.js
create public/javascripts/dragdrop.js
create public/javascripts/controls.js
create public/javascripts/slider.js
create doc/README_FOR_APP
create log/server.log
create log/production.log
create log/development.log
create log/test.log
Т.е. была создана папка ToDo и относительно нее файловая структура:
ToDo/
app/
components/
config/
db/
doc/
lib/
log/
public/
script/
test/
vendor/
CHANGELOG
Rakefile
README
данная структура идентична для всех Rails приложений.
Само приложение размещается в папке app, далее:
components
-
config
-
db
структура БД для приложения
doc
-
lib
-
log
-
public
доступные для веб клиента файлы (images, javascripts, stylesheets)
script
размещаются скрипты для генерации классов модели/контроллеры, скрипт веб-сервера (удобно для режима разработки)
test
-
vendor
-
Запуск приложения (веб-сервер)
Уже можно запустить это приложение, для этого, находясь в ToDo папке, набираем:
ruby script/server
запускается WEBrick веб-сервер на порту 3000 (по умолчаню):
C:railsToDo>ruby script/server
=> Rails application started on http://0.0.0.0:3000
=> Ctrl-C to shutdown server; call with --help for options
[2005-10-24 18:49:49] INFO WEBrick 1.3.1
[2005-10-24 18:49:49] INFO ruby 1.8.2 (2004-12-25) [i386-mswin32]
[2005-10-24 18:49:49] INFO WEBrick::HTTPServer#start: pid=4004 port=3000
Теперь запускаем Firefox, и указываем в качестве url: http://localhost:3000/, и мы увидим начальную страницу.
Теперь уже можно приступать к разработке Rails приложения (настройку Apache/FCGI оставим на потом).
Также для настройки порта можно использовать ключик -p порт при запуске:
ruby script/server -p 3001
приложение будет запущено на 3001 порту. Можно сделать наблюдение: на машине может быть запущено несколько Rails приложений: каждое на своем порту.
Также сервер запускается с utf8 кодировкой по умолчанию, если требуется другая, используем ключик -c кодировка:
ruby script/server -c windows-1251
какие есть еще "ключики" для веб-сервера, можно увидеть, запустив следующую команду:
ruby script/server --help