AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse
Ü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.inibearbeiten, wie in den Eclipse-FAQ beschrieben.
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:
-
Durchsuchen Sie die AEM Developer Tools-Website.
-
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.
-
Öffnen Sie in Eclipse die Hilfe Menü.
-
Klicken Neue Software installieren.
-
Klicken Sie auf Hinzufügen….
-
In Name Geben Sie AEM Entwicklertools ein.
-
Unter Standort kopieren Sie die Installations-URL.
-
Klicken Sie auf OK.
-
Überprüfen Sie beide AEM und Sling Plug-ins.
-
Klicken Sie auf Weiter.
-
Klicken Sie auf Weiter.
-
Akzeptieren Sie die Lizenzvereinbarungen und klicken Sie auf Beenden.
-
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.
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:
-
Im Datei > Neu > Projekt Menü, navigieren Sie zum AEM und wählen Sie AEM Beispiel für ein Projekt mit mehreren Modulen.
-
Klicken Sie auf Weiter.
note note NOTE Dieser Schritt kann einige Zeit in Anspruch nehmen, da m2eclipse die Archetypkataloge scannen muss. 
-
Wählen Sie com.adobe.granite.archetypes: sample-project-archetype: (höchste Zahl) aus dem Menü aus und klicken Sie auf Weiter.
-
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.
-
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
-
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:
- Wählen Sie alle erstellten Projekte.
- Klicken Sie mit der rechten Maustaste. Im Menü Maven select Projekte aktualisieren.
- Aktivieren Sie Aktualisierungen von Snapshots/Releases erzwingen.
- 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:
- Das Handbuch zu Apache Sling IDE tooling for Eclipse führt Sie durch die von den AEM-Entwicklungstools unterstützten Konzepte, Serverintegrationen und Implementierungsfunktionen.
- Der Abschnitt zur Fehlerbehebung.
- Die Liste der bekannten Probleme.
Die folgende offizielle Eclipse-Dokumentation kann dabei helfen, Ihre Umgebung einzurichten: