Entwicklung von AEM-Projekten mit IntelliJ IDEA how-to-develop-aem-projects-using-intellij-idea

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Übersicht overview

Um mit AEM Entwicklung auf IntelliJ zu beginnen, sind die folgenden Schritte erforderlich.

Jede davon wird im Rest dieser Anleitung ausführlicher erläutert.

  • Installieren von IntelliJ
  • Richten Sie Ihr AEM Projekt auf Grundlage von Maven ein.
  • Vorbereiten der JSP-Unterstützung für IntelliJ im Maven-POM
  • Importieren des Maven-Projekts in IntelliJ
NOTE
Dieses Handbuch basiert auf IntelliJ IDEA Ultimate Edition 12.1.4 und AEM 5.6.1.

Installieren von IntelliJ IDEA install-intellij-idea

IntelliJ IDEA herunterladen die Downloadseite bei JetBrains.

Folgen Sie dann den Installationsanweisungen auf dieser Seite.

Richten Sie Ihr AEM Projekt auf Grundlage von Maven ein. set-up-your-aem-project-based-on-maven

Richten Sie Ihr Projekt anschließend wie in So erstellen Sie AEM-Projekte mit Apache Maven beschrieben mit Maven ein.

Beginnen Sie damit, AEM-Projekte in IntelliJ IDEA zu bearbeiten, indem Sie sich an der in Einstieg in 5 Minuten beschriebenen grundlegenden Einrichtung orientieren.

Vorbereiten der JSP-Unterstützung für IntelliJ IDEA prepare-jsp-support-for-intellij-idea

IntelliJ IDEA kann auch die Arbeit mit JSP unterstützen, z. B.

  • automatische Vervollständigung von Tag-Bibliotheken
  • Wahrnehmung von Objekten, die durch <cq:defineObjects /> und <sling:defineObjects /> definiert sind

Folgen Sie den Anweisungen im Abschnitt So arbeiten Sie mit JSPs in So erstellen Sie AEM-Projekte mit Apache Maven, damit das funktioniert.

Importieren des Maven-Projekts import-the-maven-project

  1. Öffnen Sie das Dialogfeld Importieren in IntelliJ IDEA, indem Sie

    • auf dem Willkommensbildschirm Projekt importieren auswählen, sofern Sie noch kein Projekt geöffnet haben, oder
    • Datei -> Projekt importieren im Hauptmenü auswählen.
  2. Wählen Sie im Importdialogfeld die POM-Datei Ihres Projekts aus.

    chlimage_1-45

  3. Fahren Sie, wie im folgenden Dialogfeld zu sehen, mit den Standardeinstellungen fort.

    chlimage_1-46

  4. Navigieren Sie durch die folgenden Dialogfelder, indem Sie auf Weiter und Beenden klicken.

  5. Sie können nun mit der AEM-Entwicklung mit IntelliJ IDEA beginnen!

    chlimage_1-47

Debugging von JSPs mit IntelliJ IDEA debugging-jsps-with-intellij-idea

Die folgenden Schritte sind zum Debugging von JSPs mit IntelliJ IDEA erforderlich

  • Einrichten einer Web-Facette im Projekt
  • Installieren des Plug-ins zur JSR45-Unterstützung
  • Konfigurieren eines Debug-Profils
  • AEM für den Debug-Modus konfigurieren

Einrichten einer Web-Facette im Projekt set-up-a-web-facet-in-the-project

IntelliJ IDEA muss wissen, wo die JSPs zum Debugging zu finden sind. Da IDEA die content-package-maven-plugin-Einstellungen nicht interpretieren kann, muss dies manuell konfiguriert werden.

  1. Gehen Sie zu Datei -> Projektstruktur
  2. Wählen Sie das Modul Inhalte aus
  3. Klicken Sie über der Modulliste auf + und wählen Sie Web aus.
  4. Wählen Sie, wie im Folgenden zu sehen, das Verzeichnis content/src/main/content/jcr_root subdirectory Ihres Projekts als Verzeichnis für Web-Ressourcen aus.

chlimage_1-48

Installieren des Plug-ins zur JSR45-Unterstützung install-the-jsr-support-plugin

  1. Rufen Sie in den Einstellungen von IntelliJ IDEA das Fenster Plug-ins auf.
  2. Gehen Sie zum Plug-in JSR45-Integration und aktivieren Sie das Kontrollkästchen daneben.
  3. Klicken Sie auf Übernehmen
  4. Starten Sie IntelliJ IDEA neu, wenn Sie dazu aufgefordert werden.

chlimage_1-49

Konfigurieren Sie ein Debugprofil. configure-a-debug-profile

  1. Gehen Sie zu Ausführen -> Konfigurationen bearbeiten
  2. Klicken Sie auf das + und wählen Sie JSR45 Remote aus.
  3. Wählen Sie im Konfigurationsdialogfeld Konfigurieren neben Anwendungsserver aus und konfigurieren Sie einen generischen Server.
  4. Legen Sie die Startseite auf eine passende URL fest, wenn Sie beim Beginn des Debuggens einen Browser öffnen möchten.
  5. Entfernen Sie alle Vor dem Start-Aufgaben, falls Sie die automatische Synchronisierung von VLT nutzen, oder konfigurieren Sie geeignete Maven-Aufgaben, falls nicht.
  6. Passen Sie im Fenster Start/Verbindung den Port an, sofern erforderlich.
  7. Kopieren Sie die Befehlszeilenargumente, die IntelliJ IDEA vorschlägt.

chlimage_1-50 chlimage_1-51

AEM für den Debug-Modus konfigurieren configure-aem-for-debug-mode

Der letzte erforderliche Schritt besteht darin, mit den von IntelliJ IDEA vorgeschlagenen JVM-Optionen zu AEM.

Dazu können Sie die JAR-Datei direkt starten und diese Optionen hinzufügen, z. B. mit der folgenden Befehlszeile:

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -XX:MaxPermSize=256M -jar cq-quickstart-5.6.1.jar

Sie haben auch die Möglichkeit, diese Optionen, wie im Folgenden zu sehen, Ihrem Startskript in crx-quickstart/bin/start hinzuzufügen.

# ...

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/de/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=de).

# default JVM options

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/de/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=de).
if [ -z "$CQ_JVM_OPTS" ]; then
 CQ_JVM_OPTS='-server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true'
fi

CQ_JVM_OPTS="$CQ_JVM_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y"

# ...

>[!CAUTION]
>
>AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our [technical support periods](https://helpx.adobe.com/de/support/programs/eol-matrix.html). Find the supported versions [here](https://experienceleague.adobe.com/docs/?lang=de).

Debugging starten start-debugging

Sie sind jetzt alle für das Debugging Ihrer JSPs in AEM eingerichtet.

  1. Wählen Sie Ausführen -> Debuggen und anschließend Ihr Debugprofil aus.
  2. Festlegen von Haltepunkten im Komponenten-Code
  3. Zugriff auf eine Seite in Ihrem Browser

chlimage_1-52

Debuggen von Paketen mit IntelliJ IDEA debugging-bundles-with-intellij-idea

Code in Bundles kann mit einer standardmäßigen generischen Remote-Debug-Verbindung debuggt werden. Sie können dem JetBrain-Dokumentation zum Remote-Debugging.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e