Tutorial Básico

Instalando e testando o Ruby on Rails no Windows

Ana Luiza Dias

Organização do Tutorial:

Passos para a instalação ..................................................................pág 2

Passos para a criação de um projeto rails .....................................................pág 3

Passos para acompanhar os campos e os dados criados no BD (opcional) ..............pág 6

Organização das pastas de RoR do projeto criado ................................pág 7

Organização e modificação do conteúdo dos arquivos das pastas de RoR ...........pág 9

Tutoriais que podem ajudar no processo de aprendizagem ......................pág 12

São Carlos, 29 de março de 2011

2

Passos para a instalação

1º. Passo: acessar o site http://www.rubyonrails.pro.br/down

Instalar o instalar o ruby 1.8.7

Instalar o RubyGems

Descompacte-o e então execute ruby setup.rb pelo prompt

2º. Passo: verificar a instalação do ruby

Dar o comando ruby –v pelo prompt

Retornará a versão do ruby instalada

3º. Passo: instalar o Rails

Dar o comando: gem install rails pelo prompt

4º. Passo: verificar a instalação do Rails

Dar o comando rails –v pelo prompt

Ele retornará a versão do Rails instalada

3

Passos para a criação de um projeto rails

1º. Passo: criar um novo projeto Rails

Dar o comando rails new <nomedo projeto> pelo prompt

Ex: rails new teste

2º. Passo: entrar na pasta do projeto Rails criado para poder executar os próximos passos

Dar o comando cd <nomedoprojeto> pelo prompt

Ex: cd teste

3º. Passo: criar o banco de dados

Dar o comando rake db:migrate pelo prompt

//Este comando também será usado sempre que for alterado algo no banco

4º. Passo: criar campos em uma aplicação com os dados que você desejar

Ex: Dar o comando rails generate scaffold User name:string

email:string published:boolean desc:text data:date pelo prompt

// o commando rails generate scaffold é o que faz gerar separadamente o

MVC (modelo, controle e visão)

// o User faz o papel de uma classe. Todos os campos que você criar usando User

estará dentro da visão do User. E ele será acessado como http://localhost:3000/users

// os outros campos serão criados de acordo com a aplicação desejada. Deve-se passar

o nome do campo, seguida de : e depois o tipo do dado. Ex name:string

//algumas opções de tipos da dados

string boolean Text

4

5º. Passo: atualizar o banco de dados

Dar o comando rake db:migrate pelo prompt

//Como citado anteriormente, todas as vezes que são modificados ou inseridos dados

na aplicação, deve-se rodar o comando rake para atualizar o BD.

6º. Passo: iniciar o servidor

Dar o comando rails server ou rails s para rodar o servidor

7º. Passo: acessar a aplicação (parte 1/3)

Digitar no browser o endereço: http://localhost:3000

Você deverá ver a seguinte tela:

//Caso isso não aconteça e dê o erro: sqlitedll-3_7_3, você deverá buscar no endereço

indicado pelo prompt, o arquivo do sqlite e descompactar os arquivos bin em:

C:\Ruby187\bin)

7º. Passo: acessar a aplicação (parte 2/3)

Para acessar a aplicação criada, você deverá acessar a “classe” que foi criada no Passo

4. No exemplo, foram criados os Users. Portanto, acessaremos: http://localhost:3000/users

Você deverá ver a seguinte tela:

5

7º. Passo: acessar a aplicação (parte 3/3)

Para acessar diretamente a inserção de um novo usuário, você pode tanto clicar em

New User por meio da interface acima, ou digitar no browser: http://localhost:3000/users/new

Você deverá ver a seguinte tela:

//perceba que os dados apresentados acima, foram criados por meio do comando

rails generate scaffold User do Passo 4.

6

Passos para acompanhar os campos e os dados criados no BD (opcional)

O Ruby on Rails (RoR) já possui o banco SQLite. Portanto, dependendo do tipo de aplicação,

pode-se utilizar este banco mesmo, pois ele suportará a quantidade de dados.

1º. Passo: Baixar e instalar o SQLite Manager

Extensão para o Firefox que permite o gerenciamento de bancos de dados SQLite

diretamente pelo navegador. Download: http://www.baixaki.com.br/download/sqlite-

manager.htm

2º. Passo: Após instalação, o SQLite Manager poderá ser acessado diretamente pelo

navegador

Ex: Navegador -> Ferramentas -> SQLite Manager

Deverá abrir a seguinte tela:

//Perceba que a classe user criada anteriomente, agora pode ser acessada diretamente

pelo BD. Todos os campos criados também podem ser acessados e a listagem dos usuários

cadastrados também.

` //O interessante de instalar o SQLite Manager é poder gerenciar e acompanhar os

campos criados e os dados que são cadastrados.

7

Organização das pastas de RoR do projeto criado

1º. Passo: entender as pastas que são geradas

Ao criar um new rails <projeto>, são criadas todas as pastas apresentadas na

figura a seguir.

2º. Passo: encontrar a organização do MVC (modelo, visão e controle)

As pastas controllers, models e views ficam dentro de app. Para cada “classe” criada

haverá um controlador, um modelo e uma visão. Por exemplo, users, posts etc.

Controllers:

8

Models:

Views:

9

Organização e modificação do conteúdo dos arquivos das pastas de RoR

1º. Passo: entender as pastas que são geradas

//para visualizar o código fonte, é legal utilizar o Notepad++ (Editor de texto versátil e repleto de recursos úteis, com suporte a várias linguagens de programação) Download: http://www.baixaki.com.br/download/notepad-.htm

Modelos: haverá um modelo para cada classe criada e todas elas

Controladores: tem as funções para controlar todos os dados inseridos na visão

10

Visões: para cada funcionalidade da classe criada, há uma visão, ou seja, um arquivo

distinto

Editar um usuário:

11

Listar todos os usuários:

//ressalta-se que você pode editar diretamente o arquivo

Criar um novo usuário

12

Tutoriais que podem ajudar no processo de aprendizagem:

1) http://aprendaaprogramar.rubyonrails.pro.br/

2) http://ruby.railstutorial.org/ruby-on-rails-tutorial-book

3) http://guides.rubyonrails.org/getting_started.html

Obs:

Quando precisar de ajuda com algum comando do Rails, dar o comando rails –help

pelo prompt que virá as opções disponíveis naquele momento.