Développement de projets AEM à l’aide d’Eclipse

Ce guide décrit comment utiliser Eclipse pour le développement de projets basés sur AEM.

REMARQUE

Adobe fournit désormais les outils de développement AEM pour Eclipse qui vous aident à développer des solutions AEM avec Eclipse.

Présentation

Pour commencer le développement d’AEM avec Eclipse, procédez comme suit :

Chacune des étapes suivantes est expliquée plus en détail dans le reste de cette rubrique d’aide.

Installation d’Eclipse 4.3 (Kepler)
Configuration du projet AEM basé sur Maven
Préparation de la prise en charge des JSP pour Eclipse dans le POM Maven
Importation du projet Maven dans Eclipse

REMARQUE

Cette rubrique est basée sur Eclipse 4.3 (Kepler) et AEM 5.6.1.

Installation d’Eclipse

Téléchargez l’« IDE Eclipse pour le développement Java EE » depuis la page des téléchargements d’Eclipse.

Installez Eclipse en suivant les instructions d’installation.

Configuration du projet AEM basé sur Maven

Ensuite, configurez le projet en utilisant Maven comme décrit dans la rubrique Création de projets AEM à l’aide d’Apache Maven.

Préparation de la prise en charge des JSP pour Eclipse

Eclipse peut également fournir une assistance lors de l’utilisation des JSP, par exemple pour

le renseignement automatique des bibliothèques de balises
la reconnaissance par Eclipse des objets définis par <cq:defineObjects /> et <sling:defineObjects />

Pour que cela fonctionne :

Suivez les instructions de la section Comment travailler avec des JSP de la rubrique Création de projets AEM à l’aide d’Apache Maven.

Ajoutez la section <build /> suivante au POM du module de contenu.

Maven d’Eclipse prend en charge le plugin m2e, ne prend pas en charge le plugin maven-jspc-plugin et cette configuration indique à m2e d’ignorer le plugin et la tâche associée consistant à nettoyer les résultats de la compilation temporaire.

Ce n’est pas un problème : comme indiqué dans la section Comment travailler avec des JSP, le plugin maven-jspc-plugin de cette configuration n’est utilisé que pour valider la compilation des JSP dans le cadre du processus de création. Eclipse signale déjà les problèmes rencontrés dans les JSP et ne se repose pas sur ce plugin Maven pour le faire.

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>

Importation du projet Maven dans Eclipse

Dans Eclipse, sélectionnez File (Ficher) > Import (Importer)…
Dans la boîte de dialogue d’importation, sélectionnez Maven > Existing Maven Projects (Projets Maven existants), puis cliquez sur Next (Suivant).
Saisissez le chemin d’accès au dossier de niveau supérieur du projet et cliquez sur « Tout sélectionner » et « Terminer ».
Vous êtes à présent prêt à utiliser Eclipse pour développer le projet AEM, notamment la saisie semi-automatique.

REMARQUE

Si vous incluez /libs/foundation/global.jsp ou d’autres JSP dans /libs, vous devez les copier dans le projet afin qu’Eclipse puisse résoudre l’inclusion. En même temps, vous devez vous assurer qu’ils ne sont pas inclus dans le module de contenu Maven. La rubrique Création de projets AEM à l’aide d’Apache Maven décrit comment réaliser cette opération.