Executar e depurar localmente um aplicativo do App Engine padrão

Antes de implantar o aplicativo no App Engine, execute e depure localmente o aplicativo padrão do App Engine. Neste documento, descrevemos como configurar o ambiente de desenvolvimento integrado (IDE, na sigla em inglês) para execução e depuração locais pelo IntelliJ IDEA.

Observação: veja abaixo os ambientes de desenvolvimento integrado compatíveis com este recurso:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Community

Observação: apenas aplicativos Java são compatíveis.

Antes de começar

• Siga o Guia de início rápido para instalar e configurar o IntelliJ IDEA, Ultimate Edition.

• Verifique se o aplicativo é um projeto padrão do App Engine que contém um arquivo appengine-web.xml.

• Para acessar as bibliotecas de cliente do Cloud localmente, realize os procedimentos em Como adicionar as bibliotecas de cliente do Google Cloud aos seus Projetos do Maven.

Observação: as configurações para execução e depuração local estão disponíveis apenas no IntelliJ Ultimate Edition. Se você estiver usando o Community Edition, siga as instruções sobre como depurar seu aplicativo localmente no Community Edition para usar os plug-ins do Maven ou Gradle para execução local.

Como executar o aplicativo localmente

Para executar um aplicativo do App Engine localmente, faça o seguinte:

1. Selecione File > Open para abrir o projeto que você quer executar.

2. Procure o diretório que contém o projeto.

3. Selecione Ferramentas > Cloud Code > Executar em um servidor de desenvolvimento padrão do App Engine local.

O projeto demora um pouco para ser criado.

Como editar a configuração de execução

Configurar o servidor

Você pode editar a configuração de execução para seu servidor local da seguinte maneira:

1. Selecione Run > Edit Configurations.

   A caixa de diálogo Run/Debug Configurations é exibida.

   

2. Atualize as configurações conforme necessário. Algumas configurações comuns:

   • artefato a ser implantado;
   • host do App Engine;
   • porta do App Engine.

Adicionar variáveis de ambiente

Se necessário, adicione variáveis de ambiente à sua configuração.

1. Selecione a guia Startup/Connection.

2. Selecione Run.

3. Marque a caixa de seleção Pass environment variables.

4. Adicione as variáveis necessárias.

5. Selecione Debug.

6. Marque a caixa de seleção Pass environment variables.

7. Adicione as variáveis necessárias.

   

8. Quando terminar, clique em OK.

Como parar o servidor

Para parar o Dev App Server, selecione Run > Stop 'Google App Engine Standard Local Server'.

Como depurar o aplicativo

Use a configuração de execução que você criou anteriormente para executar seu aplicativo no modo de depuração da seguinte maneira:

1. Selecione Run > Debug.

2. Na caixa de diálogo, clique em Google App Engine Standard Local Server.

3. Após a criação do projeto, defina pontos de interrupção para depurar seu aplicativo.

Como depurar o aplicativo localmente no Community Edition

O IntelliJ Community Edition não é compatível nativamente com a execução de aplicativos com base em servlets Java locais. Para depurar o aplicativo localmente usando o IntelliJ Community Edition, configure o projeto para usar o plug-in do Maven ou do Gradle.

Maven

Como configurar seu projeto com o plug-in do Maven

1. Adicione o plug-in do Maven para App Engine ao arquivo pom.xml do projeto.

2. Configure a depuração em um servidor de desenvolvimento.

3. Crie a configuração de execução/depuração para Maven.

   

   1. Selecione Run > Edit Configurations.

   2. Clique em (+) para adicionar uma nova configuração.

   3. Selecione Maven.

   4. No campo Command line, insira appengine:run.

   5. Clique em OK.

4. Crie uma configuração de depuração remota.

   

   1. Selecione Run > Edit Configurations.

   2. Clique em (+) para adicionar uma nova configuração.

   3. Selecione Remoto.

   4. Verifique se o número da porta é igual ao que você definiu na configuração do Maven App Engine Plugin. A porta 5005 é o padrão.

   5. Na seção Antes do lançamento, clique em (+).

   6. Selecione Run Another Configuration.

   7. Selecione a configuração de execução do seu projeto Maven.

   8. Clique em OK.

5. Para depurar seu aplicativo localmente, faça o seguinte:

   1. Selecione Run > Debug.

   2. Selecione sua configuração de depuração remota.

      

      Agora você pode depurar seu aplicativo localmente.

Gradle

Como configurar seu projeto usando o plug-in Gradle

1. Crie um novo projeto do Gradle.

2. Configure a depuração em um servidor de desenvolvimento.

3. Crie a configuração de execução/depuração para Gradle.

   

   1. Selecione Run > Edit Configurations.

   2. Clique em (+) para adicionar uma nova configuração.

   3. Selecione Gradle.

   4. No campo Gradle project, selecione o módulo em que o plug-in appengine-gradle-plugin foi configurado.

   5. No campo Tasks, insira appengineRun.

   6. Clique em OK.

4. Crie uma configuração de depuração remota.

   

   1. Selecione Run > Edit Configurations.

   2. Clique em (+) para adicionar uma nova configuração.

   3. Selecione Remoto.

   4. Verifique se o número da porta é igual ao que você definiu na configuração do Maven App Engine Plugin. A porta 5005 é o padrão.

   5. Na seção Antes do lançamento, clique em (+).

   6. Selecione Run Another Configuration.

   7. Selecione a configuração de execução do seu projeto Maven.

   8. Clique em OK.

5. Para depurar seu aplicativo localmente, faça o seguinte:

   1. Selecione Run > Debug.

   2. Selecione sua configuração de depuração remota.

      

      Agora você pode depurar seu aplicativo localmente.

Próximos passos

• Em seguida, implante o aplicativo no ambiente padrão do App Engine.

Como receber suporte

Para enviar feedback, relate problemas no GitHub ou faça uma pergunta no Stack Overflow.