Outils de développement AEM pour Eclipse aem-developer-tools-for-eclipse

Motif d’image circulaire pour AEM Developer Tools pour Eclipse.

Vue d’ensemble overview

« AEM Developer Tools » est un plug-in Eclipse basé sur le plug-in Eclipse pour Apache Sling disponible avec Apache License 2.

Il offre plusieurs fonctionnalités qui facilitent le développement d’AEM :

  • Intégration transparente avec les instances AEM via Eclipse Server Connector.
  • Synchronisation pour les bundles de contenu et d’OSGI
  • Prise en charge du débogage avec fonctionnalité de remplacement de code à chaud.
  • Bootstrap simple de projets AEM avec un assistant de création de projet spécifique.
  • Modification facile des propriétés JCR.

Conditions requises requirements

Avant d’utiliser les outils de développement AEM, effectuez les étapes suivantes :

  • Téléchargez et installez Eclipse IDE pour les développeurs et développeuses Java™ EE. Les outils de développement AEM prennent actuellement en charge Eclipse Kepler ou une version plus récente.

  • Peut être utilisé avec AEM version 5.6.1 ou supérieure

  • Configurez votre installation Eclipse pour vous assurer de disposer d’au moins 1 Go de mémoire de tas en modifiant votre fichier de configuration eclipse.ini de la manière décrite dans la FAQ Eclipse.

NOTE
Sous macOS, cliquez avec le bouton droit sur Eclipse.app, puis sélectionnez Afficher le contenu du package pour rechercher votre eclipse.ini.

Installation de AEM Developer Tools for Eclipse how-to-install-the-aem-developer-tools-for-eclipse

Une fois les conditions préalables ci-dessus réunies, vous pouvez installer le plug-in comme suit :

  1. Accédez au site web AEM Developer Tools à l’adresse https://eclipse.adobe.com/aem/dev-tools/.

  2. Copiez le lien d’installation.

    Notez que vous pouvez également télécharger une archive au lieu d’utiliser le lien d’installation. Cela permet l’installation hors ligne, mais les notifications de mise à jour automatiques ne sont alors pas activées.

  3. Dans Eclipse, ouvrez le menu Aide.

  4. Cliquez sur Installer un nouveau logiciel.

  5. Cliquez sur Add… (Ajouter).

  6. Dans le champ Nom, saisissez AEM Developer Tools.

  7. Dans Location (Emplacement), copiez l’URL d’installation.

  8. Cliquez sur OK.

  9. Cochez les deux plug-ins AEM et Sling.

  10. Cliquez sur Next (Suivant).

  11. Cliquez sur Suivant.

  12. Acceptez les contrats de licence et cliquez sur Terminer.

  13. Cliquez sur Oui pour redémarrer Eclipse.

Importation de projets existants how-to-import-existing-projects

La perspective AEM the-aem-perspective

AEM Developer Tools for Eclipse est proposé avec une perspective offrant un contrôle total sur vos projets et instances AEM.

chlimage_1-2

Exemple de projet multi-module sample-multi-module-project

« AEM Developer Tools » contient un exemple de projet multi-module qui vous permet de vous familiariser rapidement avec la configuration d’un projet dans Eclipse. Considérez-le également comme un guide de bonnes pratiques pour plusieurs fonctionnalités d’AEM. En savoir plus sur l’archétype du projet.

Pour créer l’exemple de projet, procédez comme suit :

  1. Dans le menu Fichier  > Nouveau  > Projet, accédez à la section AEM et sélectionnez Exemple de projet multi-module AEM.

    chlimage_1-69

  2. Cliquez sur Suivant.

    note note
    NOTE
    Cette étape peut prendre un certain temps, car m2eclipse doit analyser les catalogues d’archétypes.

    chlimage_1-70

  3. Choisissez com.adobe.granite.archetypes : sample-project-archetype : (numéro le plus élevé) dans le menu, puis cliquez sur Suivant.

    chlimage_1-71

  4. Saisissez un Nom, un ID de groupe et un ID d’artefact pour l’exemple de projet. Vous pouvez également choisir de définir certaines propriétés avancées.

    chlimage_1-72

  5. Configurez maintenant un serveur AEM auquel Eclipse peut se connecter.

    Pour utiliser la fonctionnalité de débogage, vous devez avoir démarré AEM en mode débogage, ce qui peut être réalisé, par exemple, en ajoutant ce qui suit à la ligne de commande :

    code language-none
        -nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
    

    chlimage_1-73

  6. Cliquez sur Finish (Terminer). La structure du projet est créée.

    note note
    NOTE
    Sur une nouvelle installation (plus précisément : si les dépendances Maven n’ont jamais été téléchargées), vous risquez de créer le projet avec des erreurs. Dans ce cas, suivez la procédure décrite dans la section Résoudre une définition de projet non valide.

Résolution des problèmes troubleshooting

Résolution d’une définition de projet non valide resolving-invalid-project-definition

Pour résoudre des dépendances et une définition de projet non valides, procédez comme suit :

  1. Sélectionnez tous les projets créés.
  2. Faites un clic-droit. Dans le menu Maven, sélectionnez Mettre à jour les projets.
  3. Cochez Force Updates of Snapshot/Releases (Forcer les mises à jour d’instantané/de versions).
  4. Cliquez sur OK. Eclipse essaie de télécharger les dépendances demandées.

Activer l’auto-remplissage de la bibliothèque de balises dans les fichiers JSP enabling-tag-library-autocompletion-in-jsp-files

L’auto-remplissage de la bibliothèque de balises est prête à l’emploi, étant donné que les dépendances appropriées sont ajoutées au projet. Il existe un problème connu lors de l’utilisation de l’archive AEM Uber Jar, qui n’inclut pas les fichiers tld et TagExtraInfo nécessaires.

Pour contourner ce problème, assurez-vous que l’artefact org.apache.sling.scripting.jsp.taglib est présent dans le chemin d’accès aux classes avant l’archive AEM Uber Jar. Pour les projets Maven, placez la dépendance suivante dans le fichier pom.xml avant le fichier Uber Jar.

<dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.scripting.jsp.taglib</artifactId>
  <scope>provided</scope>
</dependency>

Assurez-vous d’ajouter la version appropriée pour votre déploiement d’AEM.

Informations supplémentaires more-information

Le site Web officiel Apache Sling IDE tooling for Eclipse fournit des informations utiles :

La documentation officielle Eclipse suivante peut vous aider à configurer votre environnement :

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2