My favorites | Português | Sign in

Como instalar o SDK para Java

Use o SDK (kit de desenvolvimento de software) em Java do Google App Engine para desenvolver e enviar aplicativos do Google App Engine em Java.

O SDK inclui software de um servidor da web que pode ser executado no seu próprio computador para testar os aplicativos Java. O servidor simula todos os serviços do Google App Engine, incluindo uma versão local do armazenamento de dados, Contas do Google e a capacidade de obter URLs e enviar e-mails do seu computador usando as APIs do Google App Engine.

Como obter o Java

O Google App Engine suporta Java 5 e Java 6. Quando executado no Google App Engine, o seu aplicativo Java usa a JVM (máquina virtual Java) 6 e as bibliotecas padrão. Idealmente, o Java 6 deveria ser usado para compilar e testar o seu aplicativo para garantir que o servidor local se comporte de maneira semelhante ao Google App Engine.

Para os desenvolvedores que não têm acesso fácil ao Java 6 (como desenvolvedores que usam Mac OS X), o SDK do Google App Engine é compatível com o Java 5. O Google App Engine aceita o envio de classes compiladas e JARs feitos com o Java 5.

Se necessário, faça o download e instale o JDK (Kit de desenvolvimento Java) SE na sua plataforma. Os usuários do Mac devem consultar o site do desenvolvedor Java da Apple para fazer o download e instalar a versão mais recente do Kit do desenvolvedor Java disponível para Mac OS X.

Após instalar o JDK, execute os comandos a seguir a partir de um prompt de comando (no Windows, o Prompt de comando; no Mac OS X, Terminal) para verificar se os comandos podem ser executados e determinar qual versão está instalada. Se você tiver o Java 6 instalado, esses comandos mostrarão o número da versão semelhante a 1.6.0. Se você tiver o Java 5, o número da versão será semelhante a 1.5.0.

java -version

javac -version

Como usar o Eclipse e o Plug-in do Google para o Eclipse

Se estiver usando o ambiente de desenvolvimento Eclipse, a maneira mais fácil de desenvolver, testar e enviar os aplicativos do Google App Engine é usar o Plug-in do Google para o Eclipse. O plug-in inclui tudo o que você precisa para criar, testar e implementar o seu aplicativo, inteiramente no Eclipse.

O plug-in está disponível para as versões 3.3 e 3.4 do Eclipse. Ele pode ser instalado usando o recurso Software Update (Atualização do software) do Eclipse. Os locais de instalação são os seguintes:

  • O Plug-in do Google para o Eclipse, para o Eclipse 3.3 (Europa):
    http://dl.google.com/eclipse/plugin/3.3
  • O Plug-in do Google para o Eclipse, para o Eclipse 3.4 (Ganymede):
    http://dl.google.com/eclipse/plugin/3.4

Para obter detalhes sobre como usar o Software Update (Atualização do software) para instalar o plug-in e como criar um projeto novo, consulte Como usar o Plug-in para Eclipse do Google.

Como obter o SDK

Se estiver usando o Eclipse e o Plug-in do Google, instale o SDK do Google App Engine a partir do Eclipse usando o Software Update (Atualização do software). Se ainda não o fez, instale o componente "Google App Engine Java SDK" (SDK para Java do Google App Engine) usando os locais acima.

Se não estiver usando o Eclipse nem o Plug-in do Google, você pode fazer o download do SDK para Java do Google App Engine como um arquivo Zip.

Faça o download do SDK para Java do Google App Engine. Descompacte o arquivo em um local apropriado no seu disco rígido.

Observação: Ao descompactar o arquivo, é criado um diretório cujo nome se parece com appengine-java-sdk-X.X.X, em que X.X.X é o número da versão do SDK. Ao longo desta documentação, esse diretório será chamado de appengine-java-sdk/. Se desejar, é possível alterar o nome do diretório depois de descompactar o arquivo.

Como experimentar um aplicativo demonstrativo

O SDK para Java do Google App Engine inclui vários aplicativos de demonstração no diretório demos/. A versão final do aplicativo de livro de visitas que você criará neste tutorial está no diretório guestbook/. Esta demonstração foi pré-compilada para que você possa experimentá-la imediatamente.

Se estiver usando o Eclipse, o SDK estará no diretório de instalação do Eclipse, em plugins/com.google.appengine.eclipse.sdkbundle_VERSION/, em que VERSION identifica a versão do SDK. Para executar o comando a seguir, altere o diretório atual de trabalho para esse diretório a partir da linha de comando. Se estiver usando o Mac OS X ou o Linux, pode ser preciso conceder permissão de execução aos arquivos de comando antes de executá-los (como, por exemplo, acontece com o comando chmod u+x dev_appserver.sh).

Se estiver usando o Windows, inicie a demonstração do livro de visitas no servidor de desenvolvimento executando o comando a seguir no prompt de comando:

appengine-java-sdk\bin\dev_appserver.cmd appengine-java-sdk\demos\guestbook\war

Se estiver usando o Mac OS X ou o Linux, execute o seguinte comando:

./appengine-java-sdk/bin/dev_appserver.sh appengine-java-sdk/demos/guestbook/war

O servidor de desenvolvimento é iniciado e atende às solicitações na porta 8080. No navegador, acesse o seguinte URL:

Para obter mais informações sobre como executar o servidor da web para desenvolvimento a partir da linha de comando, incluindo como alterar a porta a ser utilizada, consulte a referência Servidor da web para desenvolvimento.

Para interromper o servidor, verifique se a janela do prompt de comando está ativada e, em seguida, pressione Ctrl + C.

Próximo passo...

O ambiente de desenvolvimento permite desenvolver e testar aplicativos completos do Google App Engine no seu computador. Vamos começar com um projeto simples.

Vá para Como criar um projeto.