Entwicklung von AEM-Projekten mit IntelliJ IDEA

Überblick

Die folgenden Schritte sind erforderlich, um mit der AEM-Entwicklung unter IntelliJ zu beginnen.

Im Rest dieser Anleitung werden die einzelnen Schritte genauer ausgeführt.

• Installieren von IntelliJ
• Einrichten Ihres AEM-Projekts auf Grundlage von Maven
• Vorbereiten der JSP-Unterstützung für IntelliJ im Maven-POM
• Importieren des Maven-Projekts in IntelliJ

Installieren von IntelliJ IDEA

Laden Sie IntelliJ IDEA auf der Downloadseite bei JetBrains herunter.

Folgen Sie anschließend den Installationsanweisungen auf der Seite.

Einrichten Ihres AEM-Projekts auf Grundlage von Maven

Richten Sie anschließend Ihr Projekt mithilfe von Maven ein, wie unter So erstellen Sie AEM Projekte mit Apache Maven beschrieben.

Um mit AEM Projekten in IntelliJ IDEA zu arbeiten, reicht die grundlegende Einrichtung in Erste Schritte in 5 Minuten aus.

Vorbereiten der JSP-Unterstützung für IntelliJ IDEA

IntelliJ IDEA bietet darüber hinaus Unterstützung für die Arbeit mit JSP, z. B.

• automatische Vervollständigung von Tag-Bibliotheken,
• Bewusstsein der von <cq:defineObjects /> und <sling:defineObjects /> definierten Objekte

Damit dies funktioniert, befolgen Sie die Anweisungen unter So arbeiten Sie mit JSPs in So erstellen Sie AEM Projekte mit Apache Maven.

Importieren des Maven-Projekts

1. Öffnen Sie das Dialogfeld Import in IntelliJ IDEA durch

   • Wählen Sie Projekt importieren auf dem Willkommensbildschirm aus, wenn Sie noch kein Projekt geöffnet haben
   • Wählen Sie Datei -> Projekt importieren aus dem Hauptmenü aus.

2. Wählen Sie im Importdialogfeld die POM-Datei Ihres Projekts aus.

   

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

   

4. Fahren Sie mit den folgenden Dialogfeldern fort, indem Sie auf Weiter und Beenden klicken.

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

   

Debuggen von JSPs mit IntelliJ IDEA

Zum Debuggen von JSPs mit IntelliJ IDEA sind die folgenden Schritte notwendig:

• Richten Sie ein Web-Facet im Projekt ein.
• Installieren des Plug-ins zur JSR45-Unterstützung
• Konfigurieren Sie ein Debugprofil.
• Konfigurieren Sie AEM für den Debugmodus.

Richten Sie ein Web-Facet im Projekt ein.

IntelliJ IDEA muss wissen, wo die JSPs zum Debuggen gefunden werden können. Da IDEA die content-package-maven-plugin-Einstellungen nicht interpretieren kann, muss dies manuell konfiguriert werden.

1. Wechseln Sie zu Datei -> Projektstruktur
2. Wählen Sie das Modul Content aus.
3. Klicken Sie auf + oberhalb der Modulliste und wählen Sie Web aus.
4. Wählen Sie als Verzeichnis der Web-Ressourcen das content/src/main/content/jcr_root subdirectory Ihres Projekts aus, wie im Screenshot unten dargestellt.

Installieren des Plug-ins zur JSR45-Unterstützung

1. Wechseln Sie in den IntelliJ IDEA-Einstellungen zum Bereich Plugins .
2. Navigieren 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.

Konfigurieren Sie ein Debugprofil.

1. Navigieren Sie zu Ausführen -> Konfigurationen bearbeiten
2. Drücken Sie + und wählen Sie JSR45 Remote aus.
3. Wählen Sie im Konfigurationsdialogfeld Konfigurieren neben Anwendungsserver 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, wenn Sie die automatische Synchronisierung von vlt verwenden, oder konfigurieren Sie geeignete Maven-Aufgaben, wenn Sie dies nicht tun
6. Passen Sie im Bereich Startup/Connection den Anschluss ggf. an
7. Kopieren Sie die Befehlszeilenargumente, die IntelliJ IDEA vorschlägt.

Konfigurieren Sie AEM für den Debugmodus.

Starten Sie als letzten erforderlichen Schritt AEM mit den von IntelliJ IDEA vorgeschlagenen JVM-Optionen.

Starten Sie dazu die AEM-JAR-Datei direkt und fügen Sie diese Optionen hinzu, zum Beispiel 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.

# ...

# default JVM options
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"

# ...

Starten des Debuggens

Sie können nun mit dem Debuggen Ihrer JSPs in AEM beginnen.

1. Wählen Sie Ausführen -> Debuggen -> Ihr Debug-Profil aus.
2. Legen Sie in Ihrem Komponentencode Haltepunkte fest.
3. Greifen Sie in Ihrem Browser auf eine Seite zu.

Debuggen von Paketen mit IntelliJ IDEA

Code in Paketen können Sie mithilfe einer standardmäßigen generischen Debug-Remoteverbindung debuggen. Weitere Informationen finden Sie in der JetBrains-Dokumentation zum Remote-Debugging.