É fácil de usar o ambiente de desenvolvimento Eclipse para desenvolver o seu aplicativo do Google App Engine em Java, da mesma forma que você pode desenvolver qualquer outro aplicativo da web com base em servlet. Com o Plug-in do Google para Eclipse, é ainda mais fácil. O plug-in permite que você crie, teste e envie aplicativos do Google App Engine de dentro do Eclipse.
O Plug-in do Google para Eclipse também facilita o desenvolvimento de aplicativos usando o Google Web Toolkit (GWT), para executar no Google App Engine ou em qualquer outro ambiente.
Este artigo descreve como instalar o Plug-in do Google para o Eclipse, criar um novo projeto do Google App Engine e depurá-lo usando o servidor de desenvolvimento em execução no Eclipse. O artigo também descreve como usar o plug-in para enviar o seu projeto para o Google App Engine.
Para obter mais informações sobre o plug-in, incluindo como usá-lo para projetos do Google Web Toolkit, consulte a documentação do Plug-in do Google para o Eclipse.
Você pode obter o Eclipse no site do Eclipse. O "Eclipse IDE for Java EE Developers" (IDE Eclipse para desenvolvedores em Java EE) inclui todos os componentes necessários para o desenvolvimento de aplicativos da web.
O Plug-in do Google para o Eclipse está disponível para Eclipse 3.3 (Europa) ou Eclipse 3.4 (Ganymede).
Além do Plug-in do Google para o Eclipse, recomendamos os plug-ins da WTP (Web Tools Platform) para desenvolvimento da web. Consulte o site da Web Tools Platform. Entre outras coisas, a WTP fornece modos de edição para arquivos JSP e HTML.
Você pode instalar o Plug-in do Google para o Eclipse usando o recurso Software Update (Atualização de software) do Eclipse.
Para instalar o plug-in, usando o Eclipse 3.4 (Ganymede):
http://dl.google.com/eclipse/plugin/3.4Clique em OK. A caixa de diálogo fecha e o novo local é adicionado à lista de softwares disponíveis.
Clique no triângulo próximo ao novo local de instalação e, em seguida, clique no triângulo próximo a "Google" para exibir as opções de instalação. Marque as caixas ao lado de "Google Plugin for Eclipse 3.4" e "Google App Engine Java SDK". Você também pode selecionar o "Google Web Toolkit SDK" se você quiser usar o Google Web Toolkit com os seus aplicativos. Clique no botão Install... (Instalar...). Siga as instruções para aceitar os termos de serviço e instalar o plug-in.
Observação: O processo de instalação do plug-in pode demorar alguns minutos para ser concluído enquanto o Eclipse atualiza as dependências. Para obter mais informações, consulte as Perguntas frequentes.
O processo de instalação do plug-in para Eclipse 3.3 (Europa) é parecido, mas com solicitações diferentes e um local de instalação diferente. O local do Plug-in do Google para o Eclipse 3.3 é o seguinte:
http://dl.google.com/eclipse/plugin/3.3
Consulte a documentação do Eclipse para obter mais informações sobre o recurso Software Update.
Para criar um novo projeto do Google App Engine:
|
Guestbook para o projeto descrito no Guia Primeiros passos. Para "Package" (Pacote), insira um nome de pacote apropriado, como guestbook.appengine-java-sdk/ do seu SDK.O assistente cria uma estrutura de diretórios para o projeto, incluindo um diretório src/ para arquivos de origem Java e um diretório war/ para classes compiladas e outros arquivos do aplicativo, bibliotecas, arquivos de configuração, arquivos estáticos como imagens e CSS e outros arquivos de dados. O assistente também cria um arquivo de origem servlet e dois arquivos de configuração. A estrutura de diretórios completa tem a seguinte aparência:
Guestbook/
src/
guestbook/
server/
GuestbookServlet.java
META-INF/
jdoconfig.xml
log4j.properties
logging.properties
war/
WEB-INF/
lib/
...App Engine JARs...
appengine-web.xml
web.xml
index.html
O diretório war/ usa o layout WAR padrão para agrupar aplicativos da web (os arquivos WAR ainda não são suportados pelo SDK). O plug-in para Eclipse usa esse diretório para execução do servidor de desenvolvimento e para implementação do aplicativo no Google App Engine.
Quando o Eclipse constrói o seu projeto, ele cria um diretório chamado classes/ no war/WEB-INF/ e coloca arquivos de classe compilados nesse local. O Eclipse também copia arquivos que não são de origem encontrados no src/ para o war/WEB-INF/classes/, incluindo os arquivos META-INF/, log4j.properties e logging.properties. O conteúdo final do diretório war/ prepara o seu aplicativo para teste e implementação.
Para obter detalhes sobre o novo projeto criado pelo plug-in, consulte o Guia Primeiros passos.
O SDK do Google App Engine inclui um servidor da web para testar o seu aplicativo em um ambiente simulado. O Plug-in do Google para o Eclipse adiciona novos itens ao menu Run (Executar) para iniciar esse servidor.
Para executar o seu aplicativo no servidor da web dentro do depurador do Eclipse, selecione o menu Run (Executar), Debug As (Depurar como) > Web Application (Aplicativo da web). O Eclipse constrói o projeto, alterna para a perspectiva Debug (Depuração) e o servidor inicia. Se o servidor iniciar, ele exibirá diversas mensagens, incluindo uma mensagem parecida com a apresentada a seguir, no Console:
The server is running at http://localhost:8080/
Se você quiser personalizar a forma de inicialização do servidor, poderá criar uma nova configuração de Run/Debug (Executar/Depurar) do tipo "Web Application" (Aplicativo da web).
Para testar o novo aplicativo criado pelo plug-in, inicie o servidor conforme descrito acima, visite o seguinte URL no seu navegador (usando um caminho de URL apropriado para o seu aplicativo):
Com o Eclipse, você pode deixar o servidor executando no depurador enquanto faz as alterações no código fonte, nos JSPs, nos arquivos estáticos e no appengine-web.xml. Ao salvar as alterações no código fonte, o Eclipse compila a classe automaticamente e tenta inseri-la no servidor da web em execução dinamicamente. Na maioria dos casos, você pode simplesmente recarregar a página no seu navegador para testar a nova versão do código. As alterações feitas nos JSPs, arquivos estáticos e no appengine-web.xml são reconhecidas automaticamente pelo servidor de desenvolvimento e também entram em vigor sem a reinicialização do servidor. Se você alterar o web.xml ou outros arquivos de configuração, precisará interromper e iniciar o servidor para que as alterações entrem em vigor.
Para interromper o servidor, verifique se o painel Debug (Depuração) está selecionado e clique no botão Terminate (Encerrar): 
O Plug-in do Google para o Eclipse adiciona diversos botões à barra de ferramentas do Eclipse. O botão de implementação do Google App Engine envia o seu aplicativo ao Google App Engine: 
Antes de enviar o seu aplicativo pela primeira vez, você precisa registrar um ID de aplicativo com o Google App Engine usando o Console de administração. Registre um ID de aplicativo, edite o arquivo appengine-web.xml e altere o elemento <application>...</application> para conter o novo ID.
Ao clicar no botão de implementação do Google App Engine, o Eclipse solicita o nome de usuário (seu endereço de e-mail) e a senha da conta do administrador. Insira as informações da sua conta e clique no botão Upload (Enviar) para concluir o envio. O Eclipse obtém o ID do aplicativo e as informações sobre a versão do arquivo appengine-web.xml e envia o conteúdo do diretório war/.
Teste o seu aplicativo no Google App Engine visitando o URL:
http://<your application ID>.appspot.com/guestbookAlguns recursos das ferramentas do SDK do Google App Engine em Java estão disponíveis apenas por meio da execução das ferramentas diretamente a partir da linha de comando. Se você instalou o SDK usando o Eclipse, poderá executar essas ferramentas a partir do diretório de instalação do plug-in do Eclipse.
O SDK está localizado no diretório de instalação do seu Eclipse, em plugins/com.google.appengine.eclipse.sdkbundle_VERSION/, em que VERSION é um identificador de versão do SDK. Nesse diretório está o subdiretório appengine-java-sdk/bin/ que contém as ferramentas.
Observação: Se você estiver usando o Mac OS X ou o Linux, deverá conceder a permissão de execução dos arquivos de comando antes de poder executá-los. Por exemplo, para conceder ao appcfg.sh uma permissão de execução, insira o seguinte comando do diretório appengine-java-sdk/bin/: chmod u+x appcfg.sh
Para obter mais informações sobre os recursos disponíveis exclusivamente a partir da linha de comando, consulte Como enviar e gerenciar.