App Engine-Standardanwendung lokal in Cloud Code for IntelliJ ausführen und debuggen

Vor der Bereitstellung Ihrer Anwendung in App Engine haben Sie die Möglichkeit, Ihre App Engine-Standardanwendung lokal auszuführen und eventuelle Fehler zu beheben. In diesem Dokument wird gezeigt, wie Sie die IDE für die lokale Ausführung und die Fehlerbehebung in IntelliJ IDEA konfigurieren.

Hinweis:Diese Funktion wird von folgenden IDEs unterstützt:

• IntelliJ IDEA Ultimate
• IntelliJ IDEA Community

Hinweis: Für die App Engine-Standardumgebung werden in Cloud Code nur Java-Anwendungen unterstützt, die die Java 8-Laufzeit verwenden.

Hinweise

• Ihre Anwendung muss ein App Engine-Standardprojekt sein, das eine appengine-web.xml-Datei enthält.

• Führen Sie die Verfahren für das Hinzufügen von Cloud-Clientbibliotheken zu einem Maven-Projekt durch, um lokal auf die Cloud-Clientbibliotheken zuzugreifen.

Hinweis: Konfigurationen für die lokale Ausführung und die Fehlerbehebung stehen nur in der IntelliJ Ultimate Edition zur Verfügung. Wenn Sie die Community Edition verwenden, können Sie der Anleitung Fehler in der Anwendung in der Community Edition lokal beheben folgen, um die Plug-ins Maven oder Gradle für die lokale Ausführung zu verwenden.

Anwendung lokal ausführen

Wenn Sie die IntelliJ IDEA Ultimate Edition verwenden, können Sie eine App Engine-Anwendung lokal ausführen. Gehen Sie dazu so vor:

1. Wählen Sie File > Open (Datei > Öffnen), um das Projekt zu öffnen, das Sie ausführen möchten.

2. Gehen Sie zum Verzeichnis mit Ihrem Projekt.

3. Wählen Sie Tools > Cloud Code > App Engine auf einem lokalen App Engine Standard-Entwicklungsserver ausführen.

Das Erstellen des Projekts dauert einen Moment.

Ausführungskonfiguration bearbeiten

Server konfigurieren

So können Sie die Ausführungskonfiguration für Ihren lokalen Server bearbeiten:

1. Wählen Sie Run > Edit Configurations aus.

2. Aktualisieren Sie im Dialogfeld Run/Debug Configurations die Konfigurationseinstellungen je nach Bedarf. Zu den gängigsten Einstellungen gehören:

   • Bereitzustellendes Artefakt
   • App Engine-Host
   • App Engine-Port

Umgebungsvariablen hinzufügen

Fügen Sie Ihrer Konfiguration gegebenenfalls Umgebungsvariablen hinzu.

1. Wählen Sie den Tab Startup/Connection (Start/Verbindung) aus.

2. Wählen Sie Run (Ausführen) aus.

3. Klicken Sie das Kästchen Pass environment variables (Umgebungsvariablen übergeben) an.

4. Fügen Sie die erforderlichen Variablen hinzu.

5. Wählen Sie Debug (Fehler beheben) aus.

6. Klicken Sie das Kästchen Pass environment variables (Umgebungsvariablen übergeben) an.

7. Fügen Sie die erforderlichen Variablen hinzu.

   

8. Klicken Sie auf OK, wenn Sie fertig sind.

Server stoppen

Wählen Sie Run > Stop 'Google App Engine Standard Local Server' (Ausführen > "Lokalen Google App Engine-Standardserver" stoppen), um den Entwicklungsanwendungsserver zu stoppen.

Fehler in einer Anwendung beheben

So können Sie mit der zuvor erstellten Ausführungskonfiguration die Anwendung im Fehlerbehebungsmodus ausführen:

1. Wählen Sie Run > Debug (Ausführen > Fehlerbehebung) aus.

2. Klicken Sie im Dialogfeld auf Google App Engine Standard Local Server (Lokaler Google App Engine-Standardserver).

3. Wenn das Projekt erstellt ist, können Sie Haltepunkte zur Fehlerbehebung der Anwendung festlegen.

Fehler in einer Anwendung in der Community Edition lokal beheben

IntelliJ Community Edition bietet keine integrierte Unterstützung für die Ausführung lokaler Java-Servlet-basierter Anwendungen. Für die lokale Fehlerbehebung der Anwendung mit der IntelliJ Community Edition müssen Sie Ihr Projekt für die Verwendung der Plug-ins Maven oder Gradle konfigurieren.

Maven

So konfigurieren Sie Ihr Projekt mit dem Maven-Plug-in

1. Tragen Sie das App Engine-Plug-in Maven in die Datei pom.xml Ihres Projekts ein.

2. Konfigurieren Sie die Fehlerbehebung auf einem Entwicklungsserver.

3. Erstellen Sie für Maven eine Ausführungs-/Fehlerbehebungskonfiguration.

   

   1. Wählen Sie Run > Edit Configurations aus.

   2. Klicken Sie auf + Neue Konfiguration hinzufügen.

   3. Wählen Sie Maven aus.

   4. Geben Sie im Feld Command line den Wert appengine:run ein.

   5. Klicken Sie auf OK.

4. Erstellen Sie eine Remote-Fehlerbehebungskonfiguration.

   

   1. Wählen Sie Run > Edit Configurations aus.

   2. Klicken Sie auf + Neue Konfiguration hinzufügen.

   3. Wählen Sie Remote aus.

   4. Achten Sie darauf, dass die Portnummer mit dem Port übereinstimmt, den Sie in der Maven-Plug-in-Konfiguration Ihrer App Engine konfiguriert haben. Port 5005 ist die Standardeinstellung.

   5. Klicken Sie im Abschnitt Before launch (Vor dem Start) auf das Pluszeichen (+).

   6. Wählen Sie Run Another Configuration (Weitere Konfiguration ausführen) aus.

   7. Wählen Sie die Ausführungskonfiguration für Ihr Maven-Projekt aus.

   8. Klicken Sie auf OK.

5. So beheben Sie Fehler in Ihrer Anwendung lokal:

   1. Wählen Sie Run > Debug (Ausführen > Fehlerbehebung) aus.

   2. Wählen Sie Ihre Remote-Fehlerbehebungskonfiguration aus.

      

      Jetzt können Sie Fehler in Ihrer Anwendung lokal beheben.

Gradle

So konfigurieren Sie Ihr Projekt mit dem Gradle-Plug-in

1. Erstellen Sie ein neues Gradle-Projekt.

2. Konfigurieren Sie die Fehlerbehebung auf einem Entwicklungsserver.

3. Erstellen Sie eine Ausführungs-/Fehlerbehebungskonfiguration für Gradle.

   

   1. Wählen Sie Run > Edit Configurations aus.

   2. Klicken Sie auf + Neue Konfiguration hinzufügen.

   3. Wählen Sie Gradle aus.

   4. Wählen Sie im Feld Gradle project das Modul aus, in dem Sie das Plug-in appengine-gradle-plugin konfiguriert haben.

   5. Geben Sie im Feld Tasks den Wert appengineRun ein.

   6. Klicken Sie auf OK.

4. Erstellen Sie eine Remote-Fehlerbehebungskonfiguration.

   

   1. Wählen Sie Run > Edit Configurations aus.

   2. Klicken Sie auf + Neue Konfiguration hinzufügen.

   3. Wählen Sie Remote aus.

   4. Achten Sie darauf, dass die Portnummer mit dem Port übereinstimmt, den Sie in der Gradle-Plug-in-Konfiguration Ihrer App Engine konfiguriert haben. Port 5005 ist die Standardeinstellung.

   5. Klicken Sie im Abschnitt Before launch (Vor dem Start) auf das Pluszeichen (+).

   6. Wählen Sie Run Another Configuration (Weitere Konfiguration ausführen) aus.

   7. Wählen Sie die Ausführungskonfiguration für Ihr Gradle-Projekt aus.

   8. Klicken Sie auf OK.

5. So beheben Sie Fehler in Ihrer Anwendung lokal:

   1. Wählen Sie Run > Debug (Ausführen > Fehlerbehebung) aus.

   2. Wählen Sie Ihre Remote-Fehlerbehebungskonfiguration aus.

      

      Jetzt können Sie Fehler in Ihrer Anwendung lokal beheben.

   3. Wenn der Link Debugger anhängen im Konsolenlog angezeigt wird, klicken Sie auf den Link.

      Hinweis: Wenn der ausgewählte Port blockiert ist, konfigurieren Sie in Ihrer Gradle-Anwendung eine andere Portnummer (z. B. 5009). Engine-Plug-in-Konfiguration und aktualisieren Sie die Portnummer in der Remote-Konfiguration auf dieselbe Portnummer.

Nächste Schritte

• Anwendung in der App Engine-Standardumgebung bereitstellen

Support kontaktieren

So senden Sie Feedback oder melden ein Problem in Ihrer IntelliJ-IDE: Tools > Cloud Code > Hilfe / Info > Feedback geben oder Problem melden, um ein Problem auf GitHub zu melden oder stellen Sie eine Frage zu Stack Overflow.