Entwickeln von AEM-Projekten mit Eclipse

In dieser Anleitung erfahren Sie, wie Sie Eclipse zur Entwicklung von AEM-basierten Projekten verwenden.

Überblick

Die folgenden Schritte sind erforderlich, um mit der AEM-Entwicklung unter Eclipse zu beginnen.

Im Rest dieser Anleitung werden die einzelnen Schritte genauer ausgeführt.

• Installieren von Eclipse 4.3 (Kepler)
• Einrichten Ihres AEM-Projekts auf Grundlage von Maven
• Vorbereiten der JSP-Unterstützung für Eclipse im Maven-POM
• Importieren des Maven-Projekts in Eclipse

Installieren von Eclipse

Laden Sie „Eclipse IDE for Java EE Developers“ von der Eclipse-Downloadseite herunter.

Installieren Sie Eclipse anhand der Installationsanweisungen.

Einrichten Ihres AEM-Projekts auf Grundlage von Maven

Richten Sie anschließend Ihr Projekt mit Maven ein, wie unter Wie Sie AEM Projekte mit Apache Maven erstellen beschrieben.

Vorbereiten der JSP-Unterstützung für Eclipse

Eclipse bietet darüber hinaus Unterstützung für die Arbeit mit JSP, z. B.

• automatische Vervollständigung von Tag-Bibliotheken,
• Eclipse-Präsenz von durch <cq:defineObjects /> und <sling:defineObjects /> definierten Objekten

Damit das funktioniert:

1. Befolgen Sie die Anweisungen unter Vorgehensweise beim Arbeiten mit JSPs in Anleitung zum Erstellen AEM Projekte mit Apache Maven.

2. Fügen Sie Folgendes zum <build />-Abschnitt im POM Ihres Inhaltsmoduls hinzu.

   Das Eclipse-Plug-in zur Unterstützung von Maven, m2e, bietet keine Unterstützung für das Plug-in maven-jspc und diese Konfiguration weist m2e an, das Plug-in und die zugehörige Aufgabe zur Bereinigung der temporären Kompilierungsergebnisse zu ignorieren.

   Das ist kein Problem: Wie in How-To Work with JSPs beschrieben, wird das maven-jspc-Plug-in in diesem Setup nur verwendet, um zu überprüfen, ob JSPs als Teil des Build-Prozesses kompiliert werden. Eclipse meldet sämtliche Probleme in JSPs bereits und ist dazu nicht von diesem Maven-Plug-in abhängig.

   myproject/content/pom.xml

   <build>
     <!-- ... -->
     <pluginManagement>
       <plugins>
         <!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself.-->
         <plugin>
           <groupId>org.eclipse.m2e</groupId>
           <artifactId>lifecycle-mapping</artifactId>
           <version>1.0.0</version>
           <configuration>
             <lifecycleMappingMetadata>
               <pluginExecutions>
                 <pluginExecution>
                   <pluginExecutionFilter>
                     <groupId>org.apache.sling</groupId>
                     <artifactId>maven-jspc-plugin</artifactId>
                     <versionRange>[2.0.6,)</versionRange>
                     <goals>
                       <goal>jspc</goal>
                     </goals>
                   </pluginExecutionFilter>
                   <action>
                     <ignore/>
                   </action>
                 </pluginExecution>
                 <pluginExecution>
                   <pluginExecutionFilter>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-clean-plugin</artifactId>
                     <versionRange>[2.4.1,)</versionRange>
                     <goals>
                       <goal>clean</goal>
                     </goals>
                   </pluginExecutionFilter>
                   <action>
                     <ignore/>
                   </action>
                 </pluginExecution>
               </pluginExecutions>
             </lifecycleMappingMetadata>
           </configuration>
         </plugin>
       </plugins>
     </pluginManagement>
   </build>
   

Importieren des Maven-Projekts in Eclipse

1. Öffnen Sie Eclipse und wählen Sie „Datei“ > „Importieren“.

2. Wählen Sie im Dialogfeld zum Importieren „Maven“ > „Bestehende Maven-Projekte“ aus und klicken Sie auf „Weiter“.

   

3. Geben Sie den Pfad zum Ordner auf der obersten Ebene Ihres Projekts an und klicken Sie auf „Alle auswählen“ > „Fertig“.

   

4. Sie können nun mit der Entwicklung Ihres AEM-Projekts in Eclipse beginnen und auch die automatische Vervollständigung für JSP nutzen.

   

   HINWEIS

   Wenn Sie /libs/foundation/global.jsp oder andere JSPs in /libs einschließen, müssen Sie dies in Ihr Projekt kopieren, damit Eclipse die Einbindung lösen kann. Zudem müssen Sie darauf achten, dass sie nicht von Maven in Ihr Inhaltspaket mit eingeschlossen werden. Wie Sie dies erreichen, wird unter Wie Sie AEM Projekte mit Apache Maven erstellen beschrieben.