Execute e depure uma app do App Engine Standard localmente no Cloud Code para IntelliJ

Aviso: a partir de 31 de janeiro de 2024, o suporte do Java 8 para o App Engine foi descontinuado e vai ser desativado a 31 de janeiro de 2026. Como resultado, o Cloud Code desativa o App Engine por predefinição. Para ativar o App Engine no seu IDE, navegue para Definições > Google Cloud Code > App Engine. Devido à descontinuação do App Engine, não recomendamos a criação de novos projetos do App Engine. Para mais informações sobre as descontinuações do App Engine, consulte o artigo Descontinuações de funcionalidades. Para mais informações sobre o calendário de suporte de tempo de execução do App Engine, consulte o artigo Calendário de suporte de tempo de execução.

Antes de implementar a sua aplicação no App Engine, pode executar e depurar a sua aplicação padrão do App Engine localmente. Este documento descreve como configurar o IDE para execução e depuração locais a partir do IntelliJ IDEA.

Nota: os seguintes IDEs suportam esta funcionalidade:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Community

Nota: para o ambiente padrão do App Engine, apenas as aplicações Java que usam o tempo de execução do Java 8 são suportadas no Cloud Code.

Antes de começar

• Certifique-se de que a sua aplicação é um projeto padrão do App Engine que contém um ficheiro appengine-web.xml

• Para aceder às bibliotecas de cliente do Google Cloud localmente, conclua os procedimentos de adicionar bibliotecas de cliente do Google Cloud aos seus projetos do Maven.

Nota: as configurações de execução para execução e depuração locais só estão disponíveis no IntelliJ Ultimate Edition. Se estiver a usar a Community Edition, pode seguir as instruções de depuração da sua aplicação localmente na Community Edition para usar os plug-ins Maven ou Gradle para a sua execução local.

Executar a aplicação localmente

Se estiver a usar o IntelliJ IDEA Ultimate Edition, pode executar uma aplicação do App Engine localmente seguindo estas instruções:

1. Selecione Ficheiro > Abrir para abrir o projeto que quer executar.

2. Navegue até ao diretório que contém o seu projeto.

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

A criação do projeto demora alguns instantes.

Editar a configuração de execução

Configure o servidor

Pode editar a configuração de execução do seu servidor local:

1. Selecione Executar > Editar configurações.

2. Na caixa de diálogo Configurações de execução/depuração, atualize as definições de configuração conforme necessário. Algumas definições comuns incluem:

   • Artefacto a implementar.
   • Anfitrião do App Engine.
   • Porta do App Engine.

Adicione variáveis de ambiente

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

1. Selecione o separador Arranque/Ligação.

2. Selecione Executar.

3. Selecione a caixa de verificação Passar variáveis de ambiente.

4. Adicione as variáveis necessárias.

5. Selecione Depurar.

6. Selecione a caixa de verificação Passar variáveis de ambiente.

7. Adicione as variáveis necessárias.

   

8. Quando terminar, clique em OK.

Parar o servidor

Para parar o servidor de apps de desenvolvimento, escolha Executar > Parar "Servidor local padrão do Google App Engine".

Depurar a aplicação

Pode usar a configuração de execução que criou anteriormente para executar a sua aplicação no modo de depuração da seguinte forma:

1. Selecione Executar > Depurar.

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

3. Depois de criar o projeto, pode definir pontos de interrupção para depurar a sua app.

Depurar a sua aplicação localmente na Community Edition

O IntelliJ Community Edition não oferece suporte integrado para a execução de aplicações locais baseadas em servlets Java. Para depurar a sua aplicação localmente com o IntelliJ Community Edition, configure o seu projeto para usar o plug-in Maven ou Gradle.

Maven

Configurar o projeto através do plug-in Maven

1. Adicione o plug-in do App Engine Maven ao ficheiro pom.xml do seu projeto.

2. Configure a depuração num servidor de desenvolvimento.

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

   

   1. Selecione Executar > Editar configurações.

   2. Clique em + Adicionar nova configuração.

   3. Selecione Maven.

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

   5. Clique em OK.

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

   

   1. Selecione Executar > Editar configurações.

   2. Clique em + Adicionar nova configuração.

   3. Selecione Comando.

   4. Certifique-se de que o número da porta é o mesmo que o da porta que configurou na configuração do plugin do Maven App Engine. A porta 5005 é a predefinição.

   5. Na secção Antes do lançamento, clique em + Adicionar.

   6. Selecione Executar outra configuração.

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

   8. Clique em OK.

5. Para depurar a sua aplicação localmente:

   1. Selecione Executar > Depurar.

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

      

      Já pode depurar a sua aplicação localmente.

Gradle

Configurar o seu projeto com o plug-in Gradle

1. Crie um novo projeto do Gradle.

2. Configure a depuração num servidor de desenvolvimento.

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

   

   1. Selecione Executar > Editar configurações.

   2. Clique em + Adicionar nova configuração.

   3. Selecione Gradle.

   4. No campo Projeto Gradle, selecione o módulo onde configurou o plug-in appengine-gradle-plugin.

   5. No campo Tasks, introduza appengineRun.

   6. Clique em OK.

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

   

   1. Selecione Executar > Editar configurações.

   2. Clique em + Adicionar nova configuração.

   3. Selecione Comando.

   4. Certifique-se de que o número da porta é o mesmo que o da porta que configurou na configuração do plugin do App Engine do Gradle. A porta 5005 é a porta predefinida.

   5. Na secção Antes do lançamento, clique em + Adicionar.

   6. Selecione Executar outra configuração.

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

   8. Clique em OK.

5. Para depurar a sua aplicação localmente:

   1. Selecione Executar > Depurar.

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

      

      Já pode depurar a sua aplicação localmente.

   3. Se o link Anexar depurador aparecer no registo da consola, clique no link.

      Nota: se a porta que escolheu estiver bloqueada, configure um número de porta diferente (por exemplo, 5009) na configuração do plug-in do Gradle App Engine e atualize o número da porta na configuração remota para o mesmo número de porta.

O que se segue?

• Em seguida, pode implementar a sua app no ambiente padrão do App Engine.

Obter apoio técnico

Para enviar feedback ou comunicar um problema no seu IDE IntelliJ, aceda a Tools > Cloud Code > Help / About > Submit feedback or report an issue para comunicar um problema no GitHub.