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/sqlitemanager.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.