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

Öffnen 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.

Suchen Sie im Menü Datei > Neu > Projekt den Abschnitt AEM und wählen Sie AEM-Multi-Modul-Beispielprojekt.

Klicken Sie auf Weiter.

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:

• 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.

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.

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-Inhalte
• PROJECT.ui.content für /content, der erstellt wird
• PROJECT.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 Integrationstests

Ersetzen Sie den Inhalt Ihres PROJECT.ui.apps-Projekts durch die Ordner apps und etc Ihres Pakets:

1. Erweitern Sie im Bedienfeld „Projekt-Explorer“ PROJECT.ui.apps > src > main > content > jcr_root > apps.
2. Klicken Sie mit der rechten Maustaste auf den Ordner apps und wählen Sie Anzeigen in > System-Explorer aus.
3. Löschen Sie die Ordner apps und etc, die jetzt angezeigt werden sollten, und platzieren Sie hier die Ordner apps und etc Ihres Inhaltspakets.
4. Klicken Sie in Eclipse mit der rechten Maustaste auf das Projekt PROJECT.ui.apps und wählen Sie Aktualisieren aus.

Führen Sie dann dasselbe für PROJECT.ui.content aus und ersetzen Sie den Inhaltsordner durch den Ordner aus Ihren Paketen:

1. Erweitern Sie im Bedienfeld „Projekt-Explorer“ PROJECT.ui.content > src > main > content > jcr_root > content.
2. Klicken Sie mit der rechten Maustaste auf den unteren Inhaltsordner und wählen Sie Anzeigen in > System-Explorer aus.
3. Löschen Sie die Inhaltsordner, der jetzt angezeigt werden sollte, und platzieren Sie hier den Inhaltsordner Ihres Inhaltspakets.
4. Klicken Sie in Eclipse mit der rechten Maustaste auf das Projekt PROJECT.ui.content und wählen Sie Aktualisieren aus.

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.

• Dies ist ein Beispiel dafür, wie Ihre Datei filter.xmlaussehen 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.

1. Öffnen Sie in Eclipse PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

2. 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>

3. Öffnen Sie dann PROJECT.ui.content/src/main/content/META-INF/filter.xml.

4. 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.

Stellen Sie im Bedienfeld „Server“ sicher, dass die Verbindung hergestellt wurde. Andernfalls starten Sie sie.

Klicken Sie auf das Symbol Bereinigen und veröffentlichen.