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.

Antes de começar

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 seu projeto.

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

O projeto leva um momento 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.

    Captura de tela mostrando a caixa de diálogo Configurações de execução/depuração.

  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.

    Captura de tela mostrando a caixa de diálogo "Run/Debug Configurations", com foco nas variáveis de ambiente para o servidor local.

  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 seu aplicativo localmente usando o IntelliJ Community Edition, configure o projeto para usar o plug-in do Maven ou 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.

    Captura de tela mostrando a caixa de diálogo "Run/Debug Configurations".

    1. Selecione Run > Edit Configurations.

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

    3. Selecione Maven.

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

    5. Clique em OK.

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

    Captura de tela mostrando a caixa de diálogo "Run/Debug Configurations".

    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.

      Captura de tela mostrando a caixa de diálogo "Run/Debug Configurations".

      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.

    Captura de tela mostrando a caixa de diálogo "Run/Debug Configurations".

    1. Selecione Run > Edit Configurations.

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

    3. Selecione Gradle.

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

    5. No campo Tarefas, insira appengineRun.

    6. Clique em OK.

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

    Captura de tela mostrando a caixa de diálogo "Debug Configurations".

    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.

      Captura de tela mostrando a caixa de diálogo "Debug Configurations".

      Agora você pode depurar seu aplicativo localmente.

Próximos passos

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Tools for IntelliJ
Precisa de ajuda? Acesse nossa página de suporte.