Executar e depurar um aplicativo do ambiente padrão do App Engine localmente no Cloud Code for IntelliJ

Antes de implantar o aplicativo no App Engine, execute e depure-o localmente. Neste documento, descrevemos como configurar o ambiente de desenvolvimento integrado para execução e depuração locais pelo IntelliJ IDEA.

Observação:os seguintes ambientes de desenvolvimento integrado são compatíveis com esse recurso:

• IntelliJ IDEA: Ultimate
• IntelliJ IDEA: Community

Observação: no ambiente padrão do App Engine, somente aplicativos Java que usam o ambiente de execução do Java 8 são compatíveis com o Cloud Code.

Antes de começar

• 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 Cloud aos seus projetos Maven.

Observação: as configurações para execução e depuração locais 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 nessa versão para usar os plug-ins do Maven ou Gradle na execução local.

Executar o aplicativo localmente

Se você estiver usando o IntelliJ IDEA Ultimate Edition, poderá executar um aplicativo do App Engine localmente seguindo estas instruções:

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 > App Engine 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.

2. Na caixa de diálogo Configurações de execução/depuração, atualize as definições conforme necessário. Veja a seguir 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. Ao concluir, 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 oferece suporte integrado para executar aplicativos locais baseados em servlet Java. 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 Adicionar nova configuração.

   3. Selecione Maven.

   4. No campo Linha de comando, digite appengine:run.

   5. Clique em OK.

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

   

   1. Selecione Run > Edit Configurations.

   2. Clique em Adicionar 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 + adicionar.

   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 Adicionar nova configuração.

   3. Selecione Gradle.

   4. No campo Projeto do Gradle, selecione o módulo em que você configurou o plug-in appengine-gradle-plugin.

   5. No campo Tarefas, digite appengineRun.

   6. Clique em OK.

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

   

   1. Selecione Run > Edit Configurations.

   2. Clique em Adicionar nova configuração.

   3. Selecione Remoto.

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

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

   6. Selecione Run Another Configuration.

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

   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.

   3. Se o link Anexar depurador aparecer no registro do console, clique no link.

      Observação: se a porta escolhida estiver bloqueada, configure um número de porta diferente (por exemplo, 5009) no app Gradle, a configuração do plug-in do mecanismo e atualize o número da porta na configuração remota para o mesmo número de porta.

A seguir

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

Receba ajuda

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Help / About > Envie feedback ou informe um problema para informar um problema no GitHub ou faça uma pergunta no Stack Overflow.