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 :
Avant d’utiliser AEM Developer Tools, vous devez :
eclipse.ini
de la manière décrite dans la FAQ Eclipse.Sous macOS, vous devez cliquer avec le bouton droit de la souris sur Eclipse.app, puis sélectionner Voir le contenu du paquet pour trouver le fichier eclipse.ini
.
Une fois les conditions préalables ci-dessus réunies, vous pouvez installer le plug-in comme suit :
Ouvrez 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 une installation hors ligne, mais sans recevoir les notifications de mise à jour automatique.
Dans Eclipse, ouvrez le menu Help (Aide).
Cliquez sur Install New Software (Installer un nouveau logiciel).
Cliquez sur Add… (Ajouter).
Dans Name (Nom), saisissez AEM Developer Tools
.
Dans Location (Emplacement), copiez l’URL d’installation.
Cliquez sur Add (Ajouter).
Cochez les deux modules externes AEM et Sling.
Cliquez sur Next (Suivant).
Dans la fenêtre Install Details (Détails de l’installation), cliquez de nouveau sur Next (Suivant).
Acceptez les contrats de licence et cliquez sur Finish (Terminer).
Cliquez sur Restart Now (Redémarrer maintenant) pour redémarrer Eclipse.
Dans Eclipse, une perspective détermine les actions et les vues disponibles dans une fenêtre et permet une interaction axée sur les tâches avec les ressources dans Eclipse. Pour plus d’informations sur les perspectives, consultez la documentation d’Eclipse.
AEM Development Tools for Eclipse propose une perspective offrant un contrôle total sur vos projets et instances AEM. Pour ouvrir la perspective AEM :
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.
Suivez les étapes ci-après pour créer l’exemple de projet :
Dans le menu Fichier > Nouveau > Projet, accédez à la section AEM et sélectionnez Exemple de projet multi-module AEM.
Cliquez sur Next (Suivant).
Cette étape peut prendre un certain temps, car m2eclipse doit analyser les catalogues d’archétype.
Sélectionnez com.adobe.granite.archetypes : sample-project-archetype : <highest-number>
dans le menu, puis cliquez sur Next (Suivant).
Fournissez les champs suivants pour l’exemple de projet :
Cliquez sur Next (Suivant).
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 :
-nofork -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=10123
Cliquez sur Finish (Terminer). La structure du projet est créée.
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.
Vous pouvez utiliser la fonction New Project (Nouveau projet) pour créer la structure qui vous convient :
Suivez les instructions afin de créer un exemple de projet multi-module et les projets suivants seront créés pour vous, ce qui permettra de séparer efficacement les préoccupations :
PROJECT.ui.apps
pour le contenu /apps
et /etc
PROJECT.ui.content
pour le /content
qui est crééPROJECT.core
pour les lots Java (ils deviennent intéressants dès que vous voulez ajouter du code Java)PROJECT.it.launcher
et PROJECT.it.tests
pour les tests d’intégrationRemplacez le contenu de votre projet PROJECT.ui.apps
par les dossiers apps
et etc
de votre package :
PROJECT.ui.apps
> src
> main
> content
> jcr_root
> apps
.apps
et choisissez Show In (Afficher dans) > System Explorer (Explorateur système).apps
et etc
que vous devriez voir maintenant et placez ici les dossiers apps
et etc
de votre package de contenu.PROJECT.ui.apps
et choisissez Refresh (Actualiser).Faites ensuite de même pour PROJECT.ui.content
et remplacez son dossier de contenu par celui de votre package :
PROJECT.ui.content
> src
> main
> content
> jcr_root
> content
.PROJECT.ui.content
et choisissez Refresh (Actualiser).Vous devez maintenant mettre à jour les fichiers filter.xml
de ces deux projets pour qu’ils correspondent au contenu de votre package de contenu. Pour cela, ouvrez le fichier META-INF/vault/filter.xml
de votre package de contenu dans un éditeur de texte/code distinct.
filter.xml
:<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
Concernant le contenu de votre package qui a été divisé en deux projets, vous devrez également scinder ces règles de filtrage en deux et mettre à jour les fichiers filter.xml
de ces deux projets en conséquence.
PROJECT.ui.apps/src/main/content/META-INF/filter.xml
.<workspaceFilter>
par les règles de votre package qui commencent par /apps
et /etc
.
Par exemple :
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/apps/foo"/>
<filter root="/apps/foundation/components/bar"/>
<filter root="/etc/designs/foo"/>
</workspaceFilter>
PROJECT.ui.content/src/main/content/META-INF/filter.xml
./content
.
Par exemple :
<?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
<filter root="/content/foo"/>
<filter root="/content/dam/foo"/>
<filter root="/content/usergenerated/content/foo"/>
</workspaceFilter>
Veillez à enregistrer toutes vos modifications. Vous pouvez désormais synchroniser ce nouveau contenu avec votre instance AEM.
Dans le panneau Servers (Serveurs), assurez-vous que votre connexion est démarrée. Si ce n’est pas le cas, démarrez-la.
Cliquez sur l’icône Clean and Publish (Nettoyer et publier).
Une fois cette opération terminée, votre package devrait être exécuté sur votre instance. Lors de l’enregistrement, toute modification est automatiquement synchronisée avec l’instance.
Si vous souhaitez recréer un package à partir de votre projet, cliquez avec le bouton droit de la souris sur PROJECT.ui.apps
ou PROJECT.ui.content
et choisissez Run As (Exécuter en tant que) > Maven Install (Installation Maven).
Vous disposez désormais d’un dossier cible créé avec votre package (nommé par ex. PROJECT.ui.apps-0.0.1-SNAPSHOT.zip
).
Pour résoudre des dépendances et une définition de projet non valides, procédez comme suit :
Eclipse télécharge les dépendances requises. Cela peut prendre un moment.
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 :