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 para execução e depuração locais pelo IntelliJ IDEA.

Antes de começar

Executar o aplicativo localmente

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

  1. Selecione Arquivo e Abrir para abrir o projeto.

  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.

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 "Configurações de execução/depuração", com foco nas variáveis de ambiente para o servidor local.

  8. Ao concluir, clique em OK.

Como parar o servidor

Para interromper o servidor do app para desenvolvedores, selecione Executar > Parar "Servidor local padrão do Google App Engine".

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.

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

    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 "Configurações de execução/depuração".

    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 "Configurações de execução/depuração".

      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 "Configurações de execução/depuração".

    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 "Configurações de depuração".

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

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

      Agora você pode depurar seu aplicativo localmente.

Próximos passos

Como receber suporte

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

Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.