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:
Bevor Sie die AEM Developer Tools verwenden, müssen Sie Folgendes tun:
eclipse.ini
bearbeiten, wie in den häufig gestellten Fragen zu Eclipse beschrieben.In macOS müssen Sie mit der rechten Maustaste klicken Eclipse.app und wählen Sie Paketinhalt anzeigen um eclipse.ini
.
Sobald die oben genannten Voraussetzungen erfüllt sind, können Sie das Plug-in wie folgt installieren:
Durchsuchen Sie die AEM Developer Tools-Website.
Kopieren Sie den Installations-Link.
Alternativ können Sie auch ein Archiv herunterladen, anstatt den Installations-Link zu verwenden. Diese Methode ermöglicht eine Offline-Installation, aber Sie erhalten auf diese Weise keine automatischen Update-Benachrichtigungen.
Ö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.
Klicken Sie im Fenster Installationsdetails erneut auf Weiter.
Akzeptieren Sie die Lizenzvereinbarungen und klicken Sie auf Beenden.
Klicken Sie auf Jetzt neu starten, um Eclipse neu zu starten.
In Eclipse bestimmt eine Perspektive die innerhalb eines Fensters verfügbaren Aktionen und Ansichten und ermöglicht eine aufgabenorientierte Interaktion mit Ressourcen in Eclipse. Weitere Informationen zur Perspektive finden Sie in der Eclipse-Dokumentation.
Experience Manager Developer Tools for Eclipse bieten eine AEM-Perspektive, die Ihnen volle Kontrolle über Ihre AEM-Projekte und -Instanzen bietet. So öffnen Sie die AEM-Perspektive:
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 verschiedene AEM-Funktionen. Erfahren Sie mehr über den Projektarchetyp.
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.
Dieser Schritt kann einen Moment dauern, da m2eclipse die Archetypkataloge scannen muss.
Wählen Sie im Menü com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
aus und klicken Sie dann auf Weiter.
Geben Sie in die folgenden Felder Daten für das Beispielprojekt ein:
Klicken Sie auf Weiter.
Anschließend konfigurieren Sie einen AEM-Server, mit dem sich Eclipse verbindet.
Um die Debugger-Funktion zu verwenden, müssen Sie AEM im Debugging-Modus starten. Dies kann z. B. erreicht werden, indem Sie Folgendes zur Befehlszeile hinzufügen:
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
Klicken Sie auf Beenden. Die Projektstruktur wird erstellt.
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.
Mit der Funktion Neues Projekt können Sie die richtige Struktur für Ihre Anforderungen erstellen:
Folgen Sie den Anweisungen, um ein Multi-Modul-Beispielprojekt zu erstellen, und es werden die folgenden Projekte für Sie erstellt, die eine sinnvolle Trennung der Belange ermöglichen:
PROJECT.ui.apps
für /apps
- und /etc
-InhaltePROJECT.ui.content
für /content
, der erstellt wirdPROJECT.core
für Java™-Bundles (diese werden relevant, sobald Sie Java™-Code hinzufügen möchten)PROJECT.it.launcher
und PROJECT.it.tests
für IntegrationstestsErsetzen Sie den Inhalt Ihres PROJECT.ui.apps
-Projekts durch die Ordner apps
und etc
Ihres Pakets:
PROJECT.ui.apps
> src
> main
> content
> jcr_root
> apps
.apps
Ordner und wählen Sie Einblenden > System Explorer.apps
und etc
, die jetzt angezeigt werden sollten, und platzieren Sie hier die Ordner apps
und etc
Ihres Inhaltspakets.PROJECT.ui.apps
Projekt und wählen Sie Aktualisieren.Führen Sie dann dasselbe für PROJECT.ui.content
aus und ersetzen Sie den Inhaltsordner durch den Ordner aus Ihren Paketen:
PROJECT.ui.content
> src
> main
> content
> jcr_root
> content
.PROJECT.ui.content
Projekt und wählen Sie Aktualisieren.Jetzt müssen Sie die filter.xml
-Dateien dieser beiden Projekte aktualisieren, damit sie dem Inhalt Ihres Inhaltspakets entsprechen. Öffnen Sie dazu die Datei META-INF/vault/filter.xml
Ihres Inhaltspakets in einem gesonderten Text-/Code-Editor.
filter.xml
aussehen kann:<?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>
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
-Dateien 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.
Beispiel:
<?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.
Beispiel:
<?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.
Stellen Sie im Bedienfeld „Server“ sicher, dass die Verbindung hergestellt wurde. Andernfalls starten Sie sie.
Klicken Sie auf Bereinigen und veröffentlichen Symbol.
Nach Abschluss des Vorgangs sollte das Paket auf Ihrer Instanz ausgeführt werden und 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 das PROJECT.ui.apps
oder PROJECT.ui.content
und wählen Ausführen als > Maven-Installation.
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
).
Um ungültige Abhängigkeiten und Projektdefinitionen aufzulösen, gehen Sie wie folgt vor:
Eclipse lädt die erforderlichen Abhängigkeiten herunter. Das kann einen Moment dauern.
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: