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

Zirkuläres Bildmotiv für AEM-Entwickler-Tools für Eclipse.

Übersicht overview

„AEM Developer Tools“ 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 Code-Hot-Swapping-Funktion.
  • Einfaches Bootstrap von AEM-Projekten über einen speziellen Projekterstellungsassistenten.
  • Einfache Bearbeitung von JCR-Eigenschaften.

Voraussetzungen requirements

Bevor Sie die AEM Developer Tools verwenden, gehen Sie wie folgt vor:

  • Laden Sie Eclipse IDE for Java™ EE Developers herunter und installieren Sie es. 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
Klicken Sie unter macOS mit der rechten Maustaste auf Eclipse.app und wählen Sie Paketinhalt anzeigen, um Ihre eclipse.ini zu 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 Website AEM Developer Tools unter https://eclipse.adobe.com/aem/dev-tools/.

  2. Kopieren Sie den Installations-Link.

    Beachten Sie, dass Sie alternativ auch ein Archiv herunterladen können, anstatt den Installations-Link zu verwenden. Dies ermöglicht eine Offline-Installation, doch Ihnen entgehen die automatischen Aktualisierungsbenachrichtigungen.

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

  4. Klicken Sie auf Neue Software installieren.

  5. Klicken Sie auf Hinzufügen….

  6. Geben Sie als Namen „AEM Developer Tools“ ein.

  7. Unter Standort kopieren Sie die Installations-URL.

  8. Klicken Sie auf OK.

  9. Überprüfen Sie die beiden Plug-ins für AEM und Sling.

  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

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

chlimage_1-2

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

AEM Developer Tools enthält ein Beispielprojekt mit mehreren Modulen, durch das Sie sich schnell mit der Projekteinrichtung in Eclipse vertraut machen können. Es dient auch als Best-Practice-Leitfaden für verschiedene AEM-Funktionen. Erfahren Sie mehr über den Projektarchetyp.

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

  1. Gehen Sie im Menü Datei > Neu > Projekt zum Abschnitt AEM und wählen Sie AEM-Multi-Modul-Beispielprojekt aus.

    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. Konfigurieren Sie nun einen AEM-Server, zu dem Eclipse eine Verbindung herstellen kann.

    Um die Debugger-Funktion 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. Folgen Sie in diesem Fall den Anweisungen unter Beheben einer ungültigen Projektdefinition.

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. Wählen Sie im Menü Maven die Option Projekte aktualisieren aus.
  3. Aktivieren Sie Aktualisierungen von Snapshots/Releases erzwingen.
  4. Klicken Sie auf OK. Eclipse versucht, die erforderlichen Abhängigkeiten herunterzuladen.

Aktivieren der automatischen Vervollständigung von Tag-Bibliotheken in JSP-Dateien 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 von AEM Uber Jar, das nicht die erforderlichen tld- und TagExtraInfo-Dateien enthält.

Stellen Sie sicher, dass das Artefakt org.apache.sling.scripting.jsp.taglib im Klassenpfad vor AEM Uber Jar liegt, um das Problem 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
19ffd973-7af2-44d0-84b5-d547b0dffee2