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 « Eclipse IDE for Java EE Developers » (Environnement de développement intégré Eclipse pour développeurs 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 votre projet à l’aide de Maven, comme décrit dans la section Comment créer des 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 :

  1. Suivez les instructions de Comment travailler avec les JSP dans Comment créer des projets AEM à l'aide d'Apache Maven.

  2. 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 Comment travailler avec les JSP, le plug-in maven-jspc-plugin de cette configuration n'est utilisé que pour valider que les JSP compilent 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

  1. Dans Eclipse, sélectionnez File (Ficher) > Import (Importer)…

  2. Dans la boîte de dialogue d’importation, sélectionnez Maven > Existing Maven Projects (Projets Maven existants), puis cliquez sur Next (Suivant).

    chlimage_1-41

  3. Saisissez le chemin d’accès au dossier de niveau supérieur du projet et cliquez sur Select All (Tout sélectionner) et Finish (Terminer).

    chlimage_1-42

  4. Vous êtes à présent prêt à utiliser Eclipse pour développer le projet AEM, notamment la saisie semi-automatique.

    chlimage_1-43

    REMARQUE

    Si vous incluez /libs/foundation/global.jsp ou d'autres JSP dans /libs, vous devrez copier cela dans votre 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. Pour y parvenir, consultez la section Comment créer des projets AEM à l’aide d’Apache Maven.

Sur cette page