AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse
Überblick overview
Experience Manager Developer Tools for Eclipse ist ein Eclipse-Plug-in, das auf dem Eclipse-Plug-in für Apache Sling basiert und 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-Bundles
- Debugging-Unterstützung mit Code-Hot-Swapping-Funktion
- 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:
- Herunterladen und Installieren von Eclipse IDE for Enterprise Java and Web Developers.
- Die Version 1.4.0 von AEM Developer Tools for Eclipse ist mit Eclipse 2022-12 (4.26) oder höher kompatibel und erfordert die Ausführung von Java 17 oder höher.
- Konfigurieren Sie Ihre Eclipse-Installation, um sicherzustellen, dass Sie mindestens 1 GB Heap-Speicher haben, indem Sie Ihre
eclipse.ini
Konfigurationsdatei bearbeiten, wie in den häufig gestellten Fragen zu beschrieben
eclipse.ini
zu finden.Installieren der AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse
Wenn Sie die oben genannten Anforderungen erfüllt haben, können Sie das Plug-in für Entwickler-Tools wie folgt installieren:
-
Durchsuchen Sie die AEM Developer Tools-Website.
-
Kopieren Sie den Installations-Link.
- Alternativ können Sie ein Archiv herunterladen, anstatt den Installations-Link zu verwenden.
- Diese Methode ermöglicht eine Offline-Installation, Sie erhalten jedoch keine automatischen Aktualisierungsbenachrichtigungen.
-
Öffnen Sie in Eclipse das Menü Hilfe.
-
Klicken Sie auf Neue Software installieren.
-
Klicken Sie auf Hinzufügen….
-
In das Feld Name geben Sie
AEM Developer Tools
ein. -
Kopieren Sie in das Feld Speicherort die Installations-URL.
-
Klicken Sie auf Hinzufügen.
-
Prüfen Sie die beiden Plug-ins für AEM und Sling.
-
Klicken Sie auf Weiter.
-
Überprüfen Sie im Fenster Installationsdetails die zu installierenden Elemente und klicken Sie erneut Weiter.
-
Akzeptieren Sie die Lizenzvereinbarungen und klicken Sie auf Beenden.
-
Wählen Sie angezeigten Dialogfeld Trust Authorities“ die
https://eclipse.adobe.com
Behörde/Site aus und klicken Sie auf Trust Selected. -
Wählen Sie im Trust Artifacts angezeigten Dialogfeld die Code-Unterzeichner aus und klicken Sie auf Trust Selected.
-
Klicken Sie auf Jetzt neu starten, um Eclipse neu zu starten.
Die AEM-Perspektive the-aem-perspective
In Eclipse bestimmt Perspektive die innerhalb eines Fensters verfügbaren Aktionen und Ansichten und ermöglicht eine aufgabenorientierte Interaktion mit Ressourcen in Eclipse. Weitere Informationen zu Perspektiven finden Sie in der Eclipse-Dokumentation..
Die Experience Manager-Entwicklungs-Tools für Eclipse bieten eine AEM-Perspektive, die Ihnen volle Kontrolle über Ihre AEM-Projekte und -Instanzen bietet. So öffnen Sie die AEM-Perspektive:
- Wählen Sie in der Eclipse-Menüleiste Fenster > Perspektive > Perspektive öffnen > Andere aus.
- Wählen Sie im Dialogfeld AEM aus und klicken Sie auf Öffnen.
Multi-Modul-Beispielprojekt sample-multi-module-project
Die Experience Manager Developer Tools for Eclipse enthalten ein Beispielprojekt mit mehreren Modulen, das Ihnen den Einstieg in das Projekt-Setup von Eclipse erleichtert. Es dient auch als Best-Practice-Leitfaden für mehrere AEM-Funktionen, die den AEM-Projektarchetyp nutzen.
Führen Sie die folgenden Schritte aus, um das Beispielprojekt zu erstellen:
-
Suchen Sie im Menü Datei > Neu > Projekt den Abschnitt AEM und wählen Sie AEM-Multi-Modul-Beispielprojekt.
-
Klicken Sie auf Weiter.
note note NOTE Dieser Schritt kann einen Moment dauern, da m2eclipse die Archetypkataloge scannen muss. -
com.adobe.aem : aem-project-archetype : <highest-number>
sollte automatisch in der Dropdown-Liste Archetyp ausgewählt werden. Wählen Sie bei Bedarf eine frühere Version aus. Klicken Sie auf Weiter. -
Geben Sie in die folgenden Felder Daten für das Beispielprojekt ein:
- Name
- Gruppen-ID
- Artefakt-ID
- appID – Sie müssen die Optionen unter Erweitert erweitern, um diesen Wert festzulegen.
- appTitle – Sie müssen ggf. die Optionen unter Erweitert erweitern, um diesen Wert festzulegen.
- Package – Sie müssen die Optionen unter Erweitert erweitern, um diesen Wert festzulegen.
-
Klicken Sie auf Weiter.
-
Konfigurieren Sie einen AEM-Server, mit dem sich Eclipse verbindet, indem Sie Neuen Server einrichten auswählen und einen Servernamen und die erforderlichen Verbindungsdetails angeben.
- Um die Debugger-Funktion verwenden zu können, müssen Sie AEM im Debugging-Modus starten, indem Sie den
-agentlib
angeben, z. B.:
code language-text $ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar aem-author-p4502.jar
note tip TIP Weitere Informationen zum Debugging Ihres auf einer lokalen AEM-SDK ausgeführten Projekts finden Sie im Dokument Remote-Debugging der AEM-SDK. - Um die Debugger-Funktion verwenden zu können, müssen Sie AEM im Debugging-Modus starten, indem Sie den
-
Klicken Sie auf Beenden.
Die Projektstruktur wird erstellt. Es kann einen Moment dauern, bis die erforderlichen Artefakte zum Projekt heruntergeladen sind.
Importieren vorhandener Projekte how-to-import-existing-projects
Verwenden Sie die Funktion Neues Projekt, um die grundlegende Projektstruktur zu erstellen.
-
Befolgen Sie die Anweisungen, um ein Multi-Modul-Beispielprojekt“ zu erstellen das eine grundlegende Projektstruktur mit einer sinnvollen Trennung der Belange erstellt:
PROJECT.ui.apps
für/apps
- und/etc
-InhaltePROJECT.ui.content
für/content
, der erstellt wirdPROJECT.core
für Java-BundlesPROJECT.it.launcher
undPROJECT.it.tests
für Integrationstests
-
Ersetzen Sie den Inhalt Ihres
PROJECT.ui.apps
-Projekts durch die Ordnerapps
undetc
Ihres Pakets:- Erweitern Sie im Projekt Explorer-Bedienfeld
PROJECT.ui.apps
>src
>main
>content
>jcr_root
>apps
. - Klicken Sie mit der rechten Maustaste auf den Ordner
apps
und wählen Sie Anzeigen in > System-Explorer aus. - Löschen Sie die
apps
undetc
dort. - Platzieren Sie die
apps
undetc
Ordner Ihres Inhaltspakets am selben Speicherort. - Klicken Sie in Eclipse mit der rechten Maustaste auf das Projekt
PROJECT.ui.apps
und wählen Sie Aktualisieren aus.
- Erweitern Sie im Projekt Explorer-Bedienfeld
-
Führen Sie dann dasselbe für
PROJECT.ui.content
aus und ersetzen Sie den Inhaltsordner durch den Ordner aus Ihren Paketen:- Erweitern Sie im Projekt Explorer-Bedienfeld
PROJECT.ui.content
>src
>main
>content
>jcr_root
>content
. - Klicken Sie mit der rechten Maustaste auf den unteren Inhaltsordner und wählen Sie Anzeigen in > System-Explorer aus.
- Löschen Sie den Inhaltsordner dort.
- Platzieren Sie den Inhaltsordner Ihres Inhaltspakets am selben Speicherort.
- Klicken Sie in Eclipse mit der rechten Maustaste auf das Projekt
PROJECT.ui.content
und wählen Sie Aktualisieren aus.
- Erweitern Sie im Projekt Explorer-Bedienfeld
-
Aktualisieren Sie die
filter.xml
dieser beiden Projekte entsprechend dem Inhalt Ihres Inhaltspakets, indem Sie dieMETA-INF/vault/filter.xml
Datei Ihres Inhaltspakets in einem separaten Text-/Code-Editor öffnen.- Dies ist ein Beispiel dafür, wie Ihre Datei
filter.xml
aussehen kann:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
- Dies ist ein Beispiel dafür, wie Ihre Datei
-
Für den Inhalt Ihres Pakets, der in zwei Projekte aufgeteilt wurde, müssen Sie diese Filterregeln ebenfalls in zwei Teile aufteilen und die
filter.xml
der beiden Projekte entsprechend aktualisieren.-
Öffnen Sie in Eclipse
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
. -
Ersetzen Sie den Inhalt des
<workspaceFilter>
-Elements durch die Regeln Ihres Pakets, die mit/apps
und/etc
beginnen.-
Zum Beispiel:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/apps/foo"/> <filter root="/apps/foundation/components/bar"/> <filter root="/etc/designs/foo"/> </workspaceFilter>
-
-
Öffnen Sie dann
PROJECT.ui.content/src/main/content/META-INF/filter.xml
. -
Ersetzen Sie die Regeln durch die Ihres Pakets, die mit
/content
beginnen.-
Zum Beispiel:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <workspaceFilter version="1.0"> <filter root="/content/foo"/> <filter root="/content/dam/foo"/> <filter root="/content/usergenerated/content/foo"/> </workspaceFilter>
-
-
-
Denken Sie daran, alle Änderungen zu speichern. Sie können diesen neuen Inhalt jetzt mit Ihrer AEM-Instanz synchronisieren.
-
Vergewissern Sie Bedienfeld Server“, dass Ihre Verbindung gestartet wurde. Falls nicht, starten Sie sie.
-
Klicken Sie auf das Symbol Bereinigen und veröffentlichen.
Danach sollte Ihr Paket auf Ihrer Instanz ausgeführt werden. Beim Speichern werden alle Änderungen automatisch mit der Instanz synchronisiert.
Wenn Sie ein Paket aus Ihrem Projekt neu erstellen möchten, klicken Sie mit der rechten Maustaste auf PROJECT.ui.apps
oder PROJECT.ui.content
und wählen Sie Ausführen als > Maven-Installation aus.
Jetzt verfügen Sie über einen Zielordner, der Ihr Paket enthält (z. B. mit dem Namen PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
).
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.
- Wählen Sie im Kontextmenü Maven > Projekte aktualisieren aus.
- Aktivieren Sie Aktualisierungen von Snapshots/Releases erzwingen.
- Klicken Sie auf OK.
Eclipse lädt die erforderlichen Abhängigkeiten herunter. Das kann einen Moment dauern.
Weitere Informationen more-information
Die offizielle Website Apache Sling IDE tooling for Eclipse bietet nützliche zusätzliche Informationen:
- Das Benutzerhandbuch zu Apache Sling IDE-Tooling Eclipse führt Sie durch die allgemeinen Konzepte, die Server-Integration und die von den AEM-Entwicklungs-Tools unterstützten Bereitstellungsfunktionen.
- Fehlerbehebung für Apache Sling-IDE-Tools
- Liste der bekannten Probleme
Die folgende offizielle Eclipse-Dokumentation kann dabei helfen, Ihre Umgebung einzurichten: