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

    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 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 "Run/Debug Configurations".

    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.

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

    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

Como receber suporte

Para enviar feedback, relate problemas no GitHub ou faça uma pergunta no Stack Overflow.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Code para IntelliJ