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

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.

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

  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.

    Captura de tela mostrando a caixa de diálogo

  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 é 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.

    Captura de tela mostrando a caixa de diálogo

    1. Selecione Run > Edit Configurations.

    2. Clique em (+) para adicionar uma 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.

    Captura de tela mostrando a caixa de diálogo

    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

      Agora você pode depurar seu aplicativo localmente.

Gradle

Como configurar seu projeto usando o plug-in do 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

    1. Selecione Run > Edit Configurations.

    2. Clique em (+) para adicionar uma 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.

    Captura de tela mostrando a caixa de diálogo

    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

      Agora você pode depurar seu aplicativo localmente.

A seguir

Como conseguir suporte

Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.