Entwicklung von AEM-Projekten mit IntelliJ IDEA

Letzte Aktualisierung: 2023-12-07

Übersicht

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

Jeder Schritt wird später in diesem Thema ausführlicher erläutert.

  • 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
HINWEIS

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

Installieren von IntelliJ IDEA

Laden Sie IntelliJ IDEA von der Download-Seite bei JetBrains herunter.

Folgen Sie anschließend den Installationsanweisungen auf der Seite.

Einrichten Ihres AEM-Projekts auf Grundlage von 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 dem in Erste Schritte in 5 Minuten beschriebenen grundlegenden Setup orientieren.

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
    • Auswählen Datei > Projekt importieren aus dem Hauptmenü
  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

Debuggen von JSPs mit IntelliJ IDEA

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

  • Einrichten einer Web-Facette im Projekt
  • Installieren des Plug-ins zur JSR45-Unterstützung
  • Konfigurieren eines Debug-Profils
  • AEM für den Debugging-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 nicht interpretieren kann, muss es manuell konfiguriert werden.

  1. Navigieren 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 Webressourcen-Verzeichnis das content/src/main/content/jcr_root subdirectory Ihres Projekts, wie im folgenden Screenshot gezeigt.

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. Navigieren 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 Debugging-Modus konfigurieren

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

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"

# ...

Starten des Debuggens

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

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

chlimage_1-52

Debuggen von Paketen mit IntelliJ IDEA

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

Auf dieser Seite