Entwicklung von AEM-Projekten mit IntelliJ IDEA

Übersicht

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

Jeder Schritt wird im Rest dieses Themas 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
HINWEIS

Dieses Handbuch basiert auf IntelliJ IDEA Ultimate Edition 12.1.4 und AEM 5.6.1.

Installieren von 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.

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

Um mit AEM Projekten in IntelliJ IDEA zu arbeiten, müssen Sie die grundlegende Einrichtung in Erste Schritte in 5 Minuten ausreichend ist.

Vorbereiten der JSP-Unterstützung für 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

  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

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

IntelliJ IDEA muss wissen, wo die JSPs zum Debugging zu finden sind. Da IDEA die content-package-maven-plugin -Einstellungen, muss sie 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 als Verzeichnis der Web-Ressourcen die content/src/main/content/jcr_root subdirectory des Projekts, wie im Screenshot unten dargestellt.

chlimage_1-48

Installieren des Plug-ins zur JSR45-Unterstützung

  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.

  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. Im Start/Verbindung Bereich, passen Sie bei Bedarf den Anschluss an.
  7. Kopieren Sie die Befehlszeilenargumente, die IntelliJ IDEA vorschlägt.

chlimage_1-50 chlimage_1-51

AEM für den Debug-Modus konfigurieren

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

Starten Sie die AEM JAR-Datei direkt und fügen Sie diese Optionen hinzu, z. B. mit der folgenden Befehlszeile:

java -Xdebug -Xrunjdwp:transport=dt_socket,address=58242,suspend=n,server=y -Xmx1024m -jar cq-quickstart-6.5.0.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 -Djava.awt.headless=true'
fi

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

# ...

Debugging starten

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

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

Auf dieser Seite