AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse

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

AEM Developer Tools for Eclipse ist ein Eclipse-Plug-in, das auf dem Eclipse-Plug-in für Apache Sling basiert, das unter der Apache-Lizenz 2 veröffentlicht wurde.

Es bietet mehrere Funktionen, die die AEM-Entwicklung vereinfachen:

  • Nahtlose Integration mit AEM-Instanzen über Eclipse Server Connector.
  • Synchronisierung für Inhalte und OSGI-Pakete.
  • Debugging-Unterstützung mit der Funktion zum Hot-Swap-Code.
  • Einfacher Bootstrap von AEM-Projekten über einen speziellen Projekterstellungsassistenten.
  • Einfache Bearbeitung von JCR-Eigenschaften.

Voraussetzungen requirements

Bevor Sie die AEM Developer Tools verwenden, müssen Sie Folgendes tun:

  • Downloaden und installieren Sie Eclipse IDE für Java EE Entwickler. AEM Developer Tools unterstützt derzeit Eclipse Kepler oder höher.

  • Kann mit AEM Version 5.6.1 oder höher verwendet werden.

  • Konfigurieren Sie Ihre Eclipse-Installation, um sicherzustellen, dass Sie mindestens 1 GB an Heap-Speicher haben, indem Sie Ihre Konfigurationsdatei eclipse.ini bearbeiten, wie in den Eclipse-FAQ beschrieben.

NOTE
Unter macOS müssen Sie mit der rechten Maustaste auf Eclipse.app klicken und dann Paketinhalt anzeigen auswählen, um Ihre eclipse.inizu finden.

So installieren Sie die AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

Sobald Sie die oben genannten Voraussetzungen erfüllt haben, können Sie das Plug-in wie folgt installieren:

  1. Durchsuchen Sie die AEM Developer Tools-Website.

  2. Kopieren Sie den Installations-Link.

    Beachten Sie, dass Sie alternativ ein Archiv herunterladen können, anstatt den Installations-Link zu verwenden. Dies ermöglicht die Offline-Installation, aber Sie verpassen automatische Aktualisierungsbenachrichtigungen auf diese Weise.

  3. Öffnen Sie in Eclipse die Hilfe Menü.

  4. Klicken Neue Software installieren.

  5. Klicken Sie auf Hinzufügen….

  6. In Name Geben Sie AEM Entwicklertools ein.

  7. Unter Standort kopieren Sie die Installations-URL.

  8. Klicken Sie auf OK.

  9. Überprüfen Sie beide AEM und Sling Plug-ins.

  10. Klicken Sie auf Weiter.

  11. Klicken Sie auf Weiter.

  12. Akzeptieren Sie die Lizenzvereinbarungen und klicken Sie auf Beenden.

  13. Klicken Sie auf Ja, um Eclipse neu zu starten.

Anleitung zum Importieren vorhandener Projekte how-to-import-existing-projects

Die AEM-Perspektive the-aem-perspective

Die AEM Development Tools for Eclipse enthalten eine Perspektive, die Ihnen die volle Kontrolle über Ihre AEM-Projekte und -Instanzen bietet.

chlimage_1-2

Multi-Modul-Beispielprojekt sample-multi-module-project

Die AEM Developer Tools for Eclipse werden mit einem Beispielprojekt mit mehreren Modulen geliefert, mit dem Sie schnell mit der Projektkonfiguration in Eclipse vertraut werden und das als Best Practice-Leitfaden für mehrere AEM-Funktionen dienen kann. Erfahren Sie mehr über den Projektarchetyp.

Führen Sie die folgenden Schritte aus, um das Beispielprojekt zu erstellen:

  1. Im Datei > Neu > Projekt Menü, navigieren Sie zum AEM und wählen Sie AEM Beispiel für ein Projekt mit mehreren Modulen.

    chlimage_1-69

  2. Klicken Sie auf Weiter.

    note note
    NOTE
    Dieser Schritt kann einige Zeit in Anspruch nehmen, da m2eclipse die Archetypkataloge scannen muss.

    chlimage_1-70

  3. Wählen Sie com.adobe.granite.archetypes: sample-project-archetype: (höchste Zahl) aus dem Menü aus und klicken Sie auf Weiter.

    chlimage_1-71

  4. Geben Sie einen Namen, eine Gruppen-ID und eine Artefakt-ID für das Beispielprojekt ein. Sie haben auch die Möglichkeit, mehrere erweiterte Eigenschaften festzulegen.

    chlimage_1-72

  5. Sie sollten dann einen AEM-Server konfigurieren, zu dem Eclipse eine Verbindung herstellen wird.

    Um das Debugger-Feature zu verwenden, müssen Sie AEM im Debug-Modus starten. Dies kann z. B. erreicht werden, indem Sie Folgendes zur Befehlszeile hinzufügen:

    code language-none
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    chlimage_1-73

  6. Klicken Sie auf Beenden. Die Projektstruktur wird erstellt.

    note note
    NOTE
    Bei einer Neuinstallation (genauer gesagt: wenn die Abhängigkeiten von Maven noch nie heruntergeladen wurden) wird das Projekt möglicherweise mit Fehlern erstellt. In diesem Fall folgen Sie den Anweisungen unter Ungültige Projektdefinition beheben.

Fehlerbehebung troubleshooting

Ungültige Projektdefinition beheben resolving-invalid-project-definition

Um ungültige Abhängigkeiten und Projektdefinitionen aufzulösen, gehen Sie wie folgt vor:

  1. Wählen Sie alle erstellten Projekte.
  2. Klicken Sie mit der rechten Maustaste. Im Menü Maven select Projekte aktualisieren.
  3. Aktivieren Sie Aktualisierungen von Snapshots/Releases erzwingen.
  4. Klicken Sie auf OK. Eclipse versucht, die erforderlichen Abhängigkeiten herunterzuladen.

Automatische Vervollständigung von Tag-Bibliotheken in JSP-Dateien aktivieren enabling-tag-library-autocompletion-in-jsp-files

Die automatische Vervollständigung der Tag-Bibliothek funktioniert sofort, da die richtigen Abhängigkeiten zum Projekt hinzugefügt werden. Es gibt ein bekanntes Problem bei der Verwendung des AEM Uber Jar, das nicht die erforderlichen tld- und TagExtraInfo-Dateien enthält.

Stellen Sie sicher, dass das org.apache.sling.scripting.jsp.taglib-Artefakt im Klassenpfad vor dem AEM-UberJar liegt, um es zu umgehen. Platzieren Sie für Maven-Projekte die folgende Abhängigkeit in der pom.xml vor dem UberJar.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Stellen Sie sicher, dass Sie die korrekte Version für Ihre Bereitstellung von AEM hinzuzufügen.

Weitere Informationen more-information

Die offizielle Website „Apache Sling IDE tooling for Eclipse“ bietet Ihnen nützliche Informationen:

Die folgende offizielle Eclipse-Dokumentation kann dabei helfen, Ihre Umgebung einzurichten:

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