Como instalar o Grails

Muita gente me pergunta como instalar o Grails. Dada a quantidade de pedidos, resolvi escrever um guia bem simples sobre como instalar o Grails.

Requisitos:
Tenha o JDK 1.4 ou posterior (opte por pelo menos o 1.5, ok?) instalado.
Ter o Grails baixado
Observação: você não precisa instalar o Groovy, porque o Grails já vêm com o Groovy embutido

Passo 1: baixe o Grails em seu site oficial: http://grails.org. Para facilitar sua vida, baixe a versão binária (vêm nos formatos zip (comum no Windows) e gz (comum na plataforma *nix).

Passo 2: descompacte o conteúdo do arquivo que você baixou no diretório de sua escolha. Em nosso exemplo, vamos supor que você o descompactou no diretório raiz do seu sistema (~/grails se você está em um sistema *nix (corresponde ao meu diretório home), C:\Grails se está no Windows (raiz do sistema)).

Passo 3: Definindo variáveis do sistema.
Este é o passo no qual a maior parte das pessoas passam por dificuldades, e é exatamente neste ponto que os procedimentos irão variar de acordo com seu sistema operacional.
Apenas duas variáveis precisam ser editadas:
GRAILS_HOME = O diretório no qual o Grails foi instalado
PATH = Você deverá incluir no path do seu sistema o diretório bin, incluido na sua instalação do Grails.

Windows
Fiz um vídeo rápido (me desculpem pela qualidade da imagem) no qual vocês poderão ver como alterar estas variáveis no Windows Vista (no caso do XP e anteriores, é basicamente o mesmo procedimento, só que mais simples. Você será direcionado direto para a janela de Propriedades do Sistema do Windows).

Mac OS X, Linux, *nix em geral
Se estiver utilizando o bash, simplesmente edite o arquivo .bash_profile (Mac OS) ou .bashrc (Linux), presente no seu diretório home, tal como no exemplo abaixo:

export PATH=~/grails/bin:$PATH
export GRAILS_HOME=~/grails

Observação: só testei este procedimento no Mac OS X, mas acredito que deverá funcionar sem problemas no Linux e outros *nix da vida.

Passo 4: Testando sua instalação
Na sua interface de linha de comando, digite o comando grails.
Caso você seja recebido por uma mensagem de boas vindas do Grails, sua instalação esta concluída.

Simples assim.

29 comentários em “Como instalar o Grails”

  1. Quando eu instalei o Grails na mensagem de boa vindas apareceu:

    Welcome to Grails null – http://grails.org/
    Licensed under Apache Standard License 2.0
    Grails home is set to: /usr/share/grails

    No script name specified. Use ‘grails help’ for more info or ‘grails interactive’ to enter interactive mode

    ———–

    Note que onde era para aparece o numero da versão apareceu null
    a instalação está correta?

    Instalei apartir de um pacote deb, no ubuntu 8.10

  2. Kico

    Estou acompanhado todos os seus materiais a respeito deste framework, parabéns…

    1. Boa noite. Não acho o PATH na variável, só tenho um TEMP com seu valor e um TMP com o mesmo valor… uso o XP. Tem como fazer o PATH. Desculpe sou novato nessa área e to tentando aprender sozinho o q é muito difícil sem ajuda de voces. Se poderem mandar pro meu mail – everwf@yahoo.com – como devo proceder eu agradeço imensamente. Obrigado, Everton Fonseca.

  3. Desculpe mas eu consegui acompanhar até a variável de sistema, uso o XP. No tutorial onde trata do PATH do sistema no meu so tem TEMP como variável e valor C:\Documents and Settings\Usuário\Co…
    e na linha seguinte TMP como variável e valor C:\Documents and Settings\Usuário\Co…, não tem a variãvel PATH com seu respectivo valor como no tutorial… há algo errado tem como fazer isso. Desculpe mas estou tentando aprender programação sozinho e é bem difícil sem ajuda. Se poderem mandar para meu mail como resolvo isso eu agradeço imensamente. Obrigado, Everton Fonseca.

  4. cAROS ,

    o SEU TUTORIAL ESTA OTIMO sEGUIR OS PASSOS POREM RECEBO A MENSAGEM DE CAMINHO INVALIDO.
    oNDE SERA QUE ERREI????

  5. Olá Kico…

    Preciso da sua ajuda. Tenho que instalar o Grails na minha máquina e não dá certo, peguei um vídeo-tutorial com um amigo meu, que tenho quase certeza de que é seu. Nele, você ensina a instalar,mas não dá certo. Primeiro, quando eu vou de primeira no Prompt, ele dá um erro, dizendo que :” ‘groovy’ não é reconhecido como um comando interno ou exerno, um programa operável ou um arquivo em lotes depois, se eu fechar o Prompt e mexer nas variáveis, ele dá mais um erro ENORME!

    Vou colocar só a primeira linha do erro:
    java.lang,SecurityException: Prohibited package name java.lang

    Por favor, me ajude o mais rápido possível , pois tenho que continuar as suas aulas pois tenho pouco tempo pra aprender!

    Se possível, me responda no meu email, pois sempre olho

    1. O erro que você descreve é decorrente da ausência do diretório bin da instalação do Groovy no path do seu sistema.

  6. Kico, eu preciso saber qual eh a variavel de CLASSPATH e JAVA HOME, pq eu axo q eu naum sei :\ . Sou bem novim na área e preciso instalar esse grails

    1. Oi Raphael, beleza?

      A variável CLASSPATH é a que o Java usa pra carregar as classes dentro da máquina virtual.
      Já a variável JAVA_HOME é a que identifica qual versão da JVM será usada por default na sua máquina.

      1. Ei Kico, você poderia ser mais específico? Digo, exemplo da pasta e tudo. Quando digo que sou novo na área, eh q eu sou realmente MUITO novo na área :\

  7. Edmar Carvalhaes

    Oi amigo tudo bem? Eu sei que este post é antigo mas estou com o problema. Começei a estudar por agora com Grais (2 dias pra ser mais preciso) e não consegui fazer o GRAILS funcionar direito. Segui o tutorial, criei o GRAILS_HOME, GROOVY_HOME mas na hora de executar o comando “grails” dentro do prompt o sistema me deu a mensagem de que estava faltando o JAVA_HOME, blza fui lá e criei o mesmo de acordo com as informações abaixo:

    NOME DA VARIÁVEL: JAVA_HOME
    VALOR DA VARÁVEL: C:\Program Files (x86)\Java\jre6\

    Aí quando eu executo o comando “grails” no prompt ele me da a seguinte mensagem:

    ERROR: JAVA_HOME is set to invalid directory: C:\Program Files (x86)\Java\jre6\
    Please set the JAVA_HOME variabel in your envorionment to match the location of your Java installation

    Mas o java esta instalado nesta máquina deste jeito. Tanto que se eu executar o comento “goove -v” ele me traz a informação correta, se eu executar o comando “java -version” ele também me traz a informação correta . Sabe o que pode ser?

    1. Kico (Henrique Lobo Weissmann)

      Oi Edmar, rola de postar esta dúvida no Grails Brasil? Estou centralizando meu apoio aos demais programadores apenas por este site.

Deixe uma resposta

Esse site utiliza o Akismet para reduzir spam. Aprenda como seus dados de comentários são processados.

Rolar para cima