terça-feira, 2 de dezembro de 2008

Instalação do Ruby on Rails no Windows XP


Olá amigos. Hora de colocar a mão na massa!



Muitos fóruns e artigos que são encontrados na web não dão o suporte necessário ao usuário iniciante. Vou procurar atendê-los neste artigo, para darmos sequência aos nossos estudos. Veremos quais são as principais dificuldades.



Teoricamente, o que os sites divulgam é uma instalação fácil (e realmente é), mas às vezes surgem "probleminhas", e devemos saber como proceder.



Mostrarei a instalação por etapas. No primeiro momento, irei detalhar a instalação do Ruby e do Rails. Em outra oportunidade irei complementar com a instalação do bando de dados, que por minha opção, utilizaremos o MySQL.



Serei cuidadoso em explicar as possíveis complicações com a instalação e teste de funcionamento, pois a maiorias dos artigos encontrados na internet não os abordam. Preparado?



Pois bem. Instalaremos:



  • Ruby

  • Rails framework



1ª Etapa: Instalando o Ruby





Para iniciarmos a instalação, precisamos obviamente do software de instalação do Ruby: http://rubyforge.org/frs/?group_id=167


Entre e baixe a última versão do Ruby para Windows.

Enquanto baixa... Empolgue-se ainda mais :)



Vídeo no YouTube



Por mais difícil que seja, desligue-se do que acabara de ver, e vamos voltar ao procedimento de instalação :P



Baixou o programa? Então execute-o para iniciar a instalação:



Após abrir, clique em "Next>".



Fig.1: Janela de boas vindas do RubyFig.1: Janela de boas vindas do Ruby



Se estiver de acordo com os termos de licença, clique em "I Agree".



Fig.2: Licença para usoFig.2: Licença para uso



Na escolha dos componentes que serão instalados, mantenha o padrão (Ruby, SciTE e Enable RubyGems marcados). Clique em "Next>" para continuar.



Fig.3: Escolhendo componentes de instalaçãoFig.3: Escolhendo componentes de instalação



Agora escolha a pasta de destino. Preferencialmente, mantenha "c:\ruby\" e clique em "Next>".



Fig.4: Selecionando pasta de destino.Fig.4: Selecionando pasta de destino.



Escolha o nome do atalho para sua aplicação. Em seguida clique em "Install".



Fig.5: Colocando nome para atalhoFig.5: Colocando nome para atalho.



Instalando...



Fig.6: Progresso de instalação.Fig.6:Progresso de instalação.



Instalação completa!



Fig.7: Instalação concluída.Fig.7: Instalação concluída.



Finalizando o instalador.



Fig.8: Finalizando janela de instalação.Fig.8: Finalizando janela de instalação.



2ª Etapa: Instalando o Rails





Agora iremos instalar o Rails e suas dependências. Para isso, precisamos do Prompt de comando do Windows aberto.



Iniciar > Todos os programas > Acessórios > Prompt de comando


Ou simplesmente:

Iniciar > Executar > cmd



Fig.9: Executar.Fig.9: Executar.



O gem é um gerenciador de pacotes/plugins/engine do ruby. Ele instalará o Rails e suas dependências automaticamente.



Para isso digite: gem install rails -include-dependecies



Fig.10: Instalando o RailsFig.10: Instalando o Rails



O gem é, normalmente, reconhecido em qualquer diretório, mas às vezes apenas no diretório que se encontra ("c:\ruby\bin"), evitando isso:



Fig.11: gem não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.Fig.11: gem não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.



Aceite todos os frameworks e dependências, colocando "y" de YES se perguntar.



Fig.12: Iniciando a instalação do rails.Fig.12: Iniciando a instalação do rails.



Fim de instalação!



Fig.13: Instalação concluídaFig.13: Instalação concluída



Uma forma de certificar a instalação, é verificando a versão de ambos os softwares (Ruby e o Rails).



Para isso, digite no Prompt de comando:


ruby -v

logo em seguida:


rails -v

Fig.14: Verificando versões.Fig.14: Verificando versões.



Que tal agora testarmos o funcionamento do servidor?



Vamos então criar um projeto para testá-lo. Pode ser o nome que quiser. Escolhi "projeto". Digite no Prompt de comando:



rails projeto



Fig.15: Criando projeto para teste.Fig.15: Criando projeto para teste.




Em seguida, entre no diretório criado:


cd projeto

Dentro da pasta, inicialize o servidor (WEBrick) com o seguinte comando:


ruby script\server

Fig.16: Inicializando o servidor.Fig.16: Inicializando o servidor.



Mantenha o Prompt de comando aberto com a execução do servidor. Se fechar não funcionará. Abra seu browser. Acesse o servidor pelo http://localhost:3000/.



Se tudo der certo, aparecerá:


Fig.17: Sucesso no teste do servidor.Fig.17: Sucesso no teste do servidor.

Se não....



Fig.18: Falha no teste do servidor.Fig.18: Falha no teste do servidor.



Obs.: Será necessário rever os passos para detectar o erro.



Então é isso pessoal!


Qualquer dúvida, comente com o respectivo e-mail para contato.

Até a próxima!


Nenhum comentário: