Entwickeln von AEM-Projekten mit Eclipse

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

Übersicht

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

Next, set up your project using Maven as described in How-To Build AEM Projects using Apache Maven.

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. Follow the instructions on How-To Work with JSPs in How-To Build AEM Projects using 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.

   This is not a problem: as noted in How-To Work with JSPs, the maven-jspc-plugin in this setup is only used to validate that JSPs compile as part of the build process. 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

   If you include /libs/foundation/global.jsp or other JSPs in /libs, you will need to copy that to your project so Eclipse can resolve the inclusion. Zudem müssen Sie darauf achten, dass sie nicht von Maven in Ihr Inhaltspaket mit eingeschlossen werden. How to achieve this is described in How to Build AEM Projects using Apache Maven.