Exécuter et déboguer une application standard App Engine localement

Avant de déployer votre application sur App Engine, vous pouvez exécuter et déboguer votre application standard App Engine localement. Ce document explique comment configurer l'IDE pour une exécution locale et un débogage à partir d'IntelliJ IDEA.

Avant de commencer

Exécuter votre application localement

Pour exécuter une application App Engine localement :

  1. Sélectionnez File > Open (Fichier > Ouvrir) pour ouvrir le projet à exécuter.

  2. Accédez au répertoire contenant votre projet.

  3. Sélectionnez Tools > Cloud Code > Run on a local App Engine Standard dev server (Outils > Cloud Code > Exécuter sur un serveur de développement App Engine standard local).

La compilation du projet peut prendre un moment.

Modifier la configuration d'exécution

Configurer le serveur

Vous pouvez modifier la configuration d'exécution de votre serveur local :

  1. Sélectionnez Run > Edit Configurations (Exécuter > Modifier les configurations).

  2. Dans la boîte de dialogue Run/Debug Configurations (Configurations d'exécution/de débogage), mettez à jour les paramètres de configuration si nécessaire. Voici quelques paramètres courants à vérifier :

    • Artifact to deploy (Artefact à déployer)
    • App Engine Settings (Paramètres App Engine) - Host (Hôte)
    • App Engine Settings (Paramètres App Engine) - Port.

Ajouter des variables d'environnement

Si nécessaire, ajoutez des variables d'environnement à votre configuration.

  1. Sélectionnez l'onglet Startup/Connection (Démarrage/Connexion).

  2. Sélectionnez Run (Exécuter).

  3. Cochez la case Pass environment variables (Passer les variables d’environnement).

  4. Ajoutez les variables nécessaires.

  5. Sélectionnez Debug (Déboguer).

  6. Cochez la case Pass environment variables (Passer les variables d’environnement).

  7. Ajoutez les variables nécessaires.

    Capture d'écran montrant la boîte de dialogue

  8. Lorsque vous avez terminé, cliquez sur OK.

Arrêter le serveur

Pour arrêter le serveur de développement d'applications, choisissez Run > Stop 'Google App Engine Standard Local Server' (Exécuter > Arrêter 'Google App Engine Standard Local Server').

Déboguer l'application

Vous pouvez utiliser la configuration d'exécution que vous avez précédemment créée pour exécuter votre application en mode débogage comme suit :

  1. Sélectionnez Run > Debug (Exécuter > Déboguer).

  2. Dans la boîte de dialogue, cliquez sur Google App Engine Standard Local Server (Serveur local en environnement standard Google App Engine).

  3. Une fois le projet créé, vous pouvez définir des points d'arrêt pour déboguer votre application.

Déboguer votre application localement dans Community Edition

IntelliJ Community Edition ne propose aucune compatibilité native pour l'exécution d'applications locales basées sur des servlets Java. Pour déboguer votre application localement à l'aide d'IntelliJ Community Edition, configurez votre projet afin d'utiliser le plug-in Maven ou le plug-in Gradle.

Maven

Configurer votre projet en utilisant le plug-in Maven

  1. Ajoutez le plug-in Maven pour App Engine dans le fichier pom.xml de votre projet.

  2. Configurez le débogage sur un serveur de développement.

  3. Créez une configuration d'exécution/de débogage pour Maven.

    Capture d'écran montrant la boîte de dialogue Run/Debug Configurations (Configurations d'exécution/de débogage).

    1. Sélectionnez Run > Edit Configurations (Exécuter > Modifier les configurations).

    2. Cliquez sur plus (+) pour ajouter une nouvelle configuration.

    3. Sélectionnez Maven.

    4. Dans le champ Command line (Ligne de commande), saisissez appengine:run.

    5. Cliquez sur OK.

  4. Créez une configuration de débogage à distance.

    Capture d'écran montrant la boîte de dialogue

    1. Sélectionnez Run > Edit Configurations (Exécuter > Modifier les configurations).

    2. Cliquez sur le signe plus (+) pour ajouter une nouvelle configuration.

    3. Sélectionnez Remote (Distante).

    4. Assurez-vous que le numéro de port est identique à celui que vous avez configuré dans la configuration du plug-in Gradle pour App Engine. Le port 5005 est le port par défaut.

    5. Dans la section Before launch (Avant le lancement), cliquez sur le signe plus (+).

    6. Sélectionnez Run Another Configuration (Exécuter une autre configuration).

    7. Sélectionnez la configuration d'exécution pour votre projet Gradle.

    8. Cliquez sur OK.

  5. Pour déboguer votre application localement :

    1. Sélectionnez Run > Debug (Exécuter > Déboguer).

    2. Sélectionnez votre configuration de débogage distante.

      Capture d'écran montrant la boîte de dialogue

      Vous pouvez maintenant déboguer votre application localement.

Gradle

Configurer votre projet en utilisant le plug-in Gradle

  1. Créez un projet Gradle.

  2. Configurez le débogage sur un serveur de développement.

  3. Créez une configuration d'exécution/de débogage pour Gradle.

    Capture d'écran montrant la boîte de dialogue Run/Debug Configurations (Configurations d'exécution/de débogage).

    1. Sélectionnez Run > Edit Configurations (Exécuter > Modifier les configurations).

    2. Cliquez sur plus (+) pour ajouter une nouvelle configuration.

    3. Sélectionnez Gradle.

    4. Dans le champ Gradle project (Projet Gradle), sélectionnez le module dans lequel vous avez configuré le plug-in appengine-gradle-plugin.

    5. Dans le champ Tasks (Tâches), saisissez appengineRun.

    6. Cliquez sur OK.

  4. Créez une configuration de débogage à distance.

    Capture d'écran montrant la boîte de dialogue

    1. Sélectionnez Run > Edit Configurations (Exécuter > Modifier les configurations).

    2. Cliquez sur le signe plus (+) pour ajouter une nouvelle configuration.

    3. Sélectionnez Remote (Distante).

    4. Assurez-vous que le numéro de port est identique à celui que vous avez configuré dans la configuration du plug-in Gradle pour App Engine. Le port 5005 est le port par défaut.

    5. Dans la section Before launch (Avant le lancement), cliquez sur le signe plus (+).

    6. Sélectionnez Run Another Configuration (Exécuter une autre configuration).

    7. Sélectionnez la configuration d'exécution pour votre projet Gradle.

    8. Cliquez sur OK.

  5. Pour déboguer votre application localement :

    1. Sélectionnez Run > Debug (Exécuter > Déboguer).

    2. Sélectionnez votre configuration de débogage distante.

      Capture d'écran montrant la boîte de dialogue

      Vous pouvez maintenant déboguer votre application localement.

Étape suivante

Assistance

Pour envoyer vos commentaires, signalez tout problème sur GitHub ou posez une question sur Stack Overflow.