My favorites | Português | Sign in

Google Web Toolkit

Primeiros passos - Início rápido

Como instalar o Google Web Toolkit

Como instalar com o Eclipse

Se você usar o Eclipse IDE, poderá usar o Plug-in do Google para o Eclipse para instalar o Google Web Toolkit. Após reiniciar o Eclipse você poderá criar um novo aplicativo do GWT.

Como instalar sem o Eclipse

  1. Se você ainda não tiver o Java SDK, instale-o.
  2. Observação para usuários do Mac: o modo hospedado do GWT usa vínculos de 32 bits do SWT e exige um JVM de 32 bits. Infelizmente, o Java 6 para Mac usa um JVM de 64 bits. Para usar o modo hospedado do GWT, você precisará usar o Java 5. Leia mais sobre os requisitos de 32 bits nestas Perguntas frequentes

  3. Se você ainda não tiver o Apache Ant, faça o download e o descompacte.
  4. Faça o download e descompacte o Google Web Toolkit.
    No Windows, extraia os arquivos da pasta compactada gwt-windows-1.6.4.zip (ou use um programa como o WinZip). No Mac ou Linux, você pode descompactar o pacote com um comando, por exemplo
    tar zxvf gwt-mac-1.6.4.tar.gz
  5. O GWT não tem um aplicativo instalador. Todos os arquivos que você precisa para executar e usar o GWT estão localizados no diretório extraído. O principal aplicativo que você precisará para usar o GWT é o webAppCreator, descrito abaixo. Talvez seja mais fácil começar construindo um dos exemplos de aplicativos que acompanham o GWT.

    Como construir um exemplo de aplicativo

    Todos os exemplos de aplicativo estão no diretório samples/ no seu pacote GWT. Cada exemplo tem um script de construção do Ant, build.xml, que você pode usar para iniciá-lo no modo hospedado ou compilá-lo em JavaScript e HTML para executá-lo no modo da web.

    Como executar no modo hospedado

    Para executar o exemplo de aplicativo Mail no modo hospedado, navegue até o diretório samples/Mail/ e execute:

    ant hosted

    Isso executa o Ant de destino "hospedado" no samples/Mail/build.xml, o que abre o navegador GWT com o aplicativo Mail em execução:

    Captura de tela

    Como você está executando no modo hospedado, o aplicativo é executado no JVM (Java Virtual Machine). Normalmente, esse é o modo que você usará para depurar os seus aplicativos.

    Como executar no modo da web

    Para executar o aplicativo no modo da web, compile o aplicativo executando

    ant build

    A "construção" do Ant de destino invoca o compilador do GWT que gera diversos arquivos de JavaScript e HTML a partir do código fonte em Java do Mail no subdiretório samples/Mail/war/. Para ver o aplicativo, abra o arquivo samples/Mail/war/Mail.html no seu navegador da web favorito.

    Captura de tela

    Como você compilou o projeto, está executando JavaScript e HTML puros que devem funcionar no IE, Firefox, Safari ou Opera. Se você fosse implementar o projeto exemplo Mail na produção, teria que distribuir os arquivos do seu diretório samples/Mail/war/ nos seus servidores da web.

    Faça algumas alterações

    O código fonte para o Mail está no subdiretório samples/Mail/src/. Tente fechar as janelas do seu navegador e abrir o arquivo samples/Mail/src/com/google/gwt/sample/mail/client/Shortcuts.java em um editor de texto. A linha 54 do arquivo é a linha que constrói a guia "Mail".

    add(images, new Mailboxes(images), images.mailgroup(), "Mail");

    Altere o argumento final de "Mail" para "My Mail":

    add(images, new Mailboxes(images), images.mailgroup(), "My Mail");

    Agora, salve o arquivo e simplesmente clique em "Atualizar" no aplicativo no modo hospedado para ver sua alteração recente (se você tiver fechado o modo hospedado, execute novamente o ant hosted). A primeira guia deve mostrar "My Mail" em vez de "Mail":

    Captura de tela

    Como criar um aplicativo do zero (sem o Eclipse)

    O GWT tem um utilitário de linha de comando chamado webAppCreator que gera automaticamente todos os arquivos necessários para iniciar um projeto do GWT. Ele também gera arquivos de projeto do Eclipse e inicia arquivos de configuração para uma depuração simplificada do modo hospedado, conforme descrito abaixo.

    Você pode criar um novo aplicativo chamado MyApplication com o comando:

    webAppCreator -out MyApplication com.mycompany.MyApplication

    O script webAppCreator gerará alguns arquivos em MyApplication/, incluindo funcionalidades básicas de "Hello, world" na classe MyApplication/src/com/mycompany/client/MyApplication.java. O script também gera um script de construção do Ant MyApplication/build.xml, da mesma forma que o exemplo de aplicativo acima.

    Para executar o seu aplicativo recém-criado no modo hospedado, mude para o diretório MyApplication/ e execute:

    ant hosted

    Captura de tela

    Tente editar os arquivos MyApplication/src/com/mycompany/client/MyApplication.java e MyApplication/war/MyApplication.html para ver como isso muda o seu aplicativo.

    Como criar um aplicativo do zero (com o Eclipse)

    Usando o plug-in

    O Plug-in do Google para o Eclipse contém um assistente para a criação de aplicativos do GWT. Após a instalação do plug-in e a reinicialização do Eclipse, veja as etapas para criação de um aplicativo inicial.

    1. Na barra de ferramentas, clique no botão Novo projeto de aplicativo da web ícone.
    2. Preencha os detalhes do projeto:
      1. Insira o nome do projeto "MyApplication".
      2. Insira o pacote "com.mycompany".
      3. Use Google Web Toolkit deve estar marcado e Use default SDK (GWT) deve estar selecionado.
      4. (Opcional) Se você estiver usando o Google App Engine, Use Google App Engine deverá estar marcado e Use default SDK (App Engine) deverá estar selecionado.
      5. Se você não instalou os SDKs quando instalou o Plug-in do Google para o Eclipse, clique em Configure SDKs... para especificar o diretório no qual o GWT (e o SDK do Google App Engine) foi descompactado.
    3. Clique no botão Finish.

    Sem usar o plug-in

    Se você não quiser usar o Plug-in do Google para o Eclipse, poderá importar um projeto criado com o webAppCreator conforme descrito acima. Para abrir o seu projeto no Eclipse,

    1. No menu File, selecione a opção Import....
    2. Selecione a fonte de importação Geral > Projetos existentes no espaço de trabalho. Clique no botão Next.
    3. Para o diretório raiz, procure e selecione o diretório MyApplication criado pelo webAppCreator. Clique no botão Finish.

    Você deverá ver o seu projeto do GWT carregado no espaço de trabalho do seu Eclipse:

    Captura de tela

    Apenas clique no botão verde "Executar" na parte superior da janela para iniciar o seu projeto no modo hospedado.