AEM Developer Tools for Eclipse aem-developer-tools-for-eclipse
Présentation overview
AEM Developer Tools for Eclipse 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 à chaud du code.
- Amorçage 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 AEM Developer Tools, vous devez :
-
Télécharger et installer Eclipse IDE pour les développeurs 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
-
configurer votre installation Eclipse pour vous assurer de disposer d’au moins 1 Go de mémoire de segment en modifiant votre fichier de configuration
eclipse.inide la manière décrite dans la FAQ Eclipse.
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 :
-
Parcourez le site Web AEM Developer Tools.
-
Copiez le Lien d’installation.
Notez que vous pouvez également télécharger un fichier d’archives au lieu d’utiliser le lien d’installation. Cela permet l’installation hors ligne, mais les notifications de mise à jour automatique ne sont pas prises en compte de cette manière.
-
Dans Eclipse, ouvrez le Aide .
-
Cliquez sur Installer le nouveau logiciel.
-
Cliquez sur Add… (Ajouter).
-
Dans Nom saisissez AEM Outils de développement.
-
Dans Location (Emplacement), copiez l’URL d’installation.
-
Cliquez sur OK.
-
Cochez les deux AEM et Sling modules externes.
-
Cliquez sur Next (Suivant).
-
Cliquez sur Suivant.
-
Acceptez les contrats de licence et cliquez sur Terminer.
-
Cliquez sur Yes 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.
Exemple de projet multi-module sample-multi-module-project
AEM Developer Tools for Eclipse est fourni avec un exemple de projet multi-module qui vous aide à vous familiariser rapidement avec une configuration de projet dans Eclipse, et sert également de guide de bonnes pratiques pour plusieurs fonctionnalités AEM. En savoir plus sur l’archétype du projet.
Pour créer l’exemple de projet, procédez comme suit :
-
Dans le menu Fichier > Nouveau > Projet, accédez à la section AEM et sélectionnez Exemple de projet multi-module AEM.
-
Cliquez sur Suivant.
note note NOTE Cette étape peut prendre un certain temps car m2eclipse doit analyser les catalogues d’archétype. 
-
Choisissez com.adobe.granite.archetypes : sample-project-archetype : (numéro le plus élevé) dans le menu, puis cliquez sur Suivant.
-
Entrez un nom, un id de groupe et un id d’artefact pour le projet exemple. Vous pouvez également choisir de définir certaines propriétés avancées.
-
Vous devez ensuite configurer un serveur AEM auquel Eclipse se connectera.
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
-
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, veuillez suivre la procédure décrite dans Résolution d’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 :
- Sélectionnez tous les projets créés.
- Faites un clic-droit. Dans le menu Maven select Mettre à jour les projets.
- Cochez Force Updates of Snapshot/Releases (Forcer les mises à jour d’instantané/de versions).
- Cliquez sur OK. Eclipse essaie de télécharger les dépendances demandées.
Activation de la saisie semi-automatique 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’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 de classe avant le fichier 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 :
- Le guide de l’utilisateur Apache Sling IDE tooling for Eclipse : cette documentation vous guide à travers les concepts généraux, l’intégration des serveurs et les fonctionnalités de déploiement pris en charge par AEM Development Tools.
- La section Dépannage.
- La liste des problèmes connus.
La documentation officielle Eclipse suivante peut vous aider à configurer votre environnement :