Outils de développement AEM pour Eclipse

Ouvrez le site Web AEM Developer Tools.

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 une installation hors ligne, mais sans recevoir les notifications de mise à jour automatique.

Dans Eclipse, ouvrez le menu Aide.

Cliquez sur Installer un nouveau logiciel.

Cliquez sur Add… (Ajouter).

Dans le champ Nom, saisissez AEM Developer Tools.

Dans le champ Emplacement, copiez l’URL d’installation.

Cliquez sur Add (Ajouter).

Cochez les plug-ins 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 Redémarrer maintenant pour redémarrer Eclipse.

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

Cliquez sur Next (Suivant).

NOTE

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

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 :

• Name (Nom)
• Group Id (ID de groupe)
• Artifact Id (ID d’artefact)
• appId  : vous devrez peut-être développer les options Advanced (Avancé) pour définir cette valeur.
• appTitle  : vous devrez peut-être développer les options Advanced pour définir cette valeur.
• Package  : vous devrez peut-être développer les options Advanced pour définir cette valeur.

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 de débogage, ce qui peut être réalisé 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.

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.

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 bundles 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égration

Remplacez le contenu de votre projet PROJECT.ui.apps par les dossiers apps et etc de votre package :

1. Dans le panneau Project Explorer (Explorateur de projets), développez PROJECT.ui.apps > src > main > content > jcr_root > apps.
2. Cliquez avec le bouton droit sur le dossier apps et choisissez Afficher dans > Explorateur système.
3. Supprimez les dossiers apps et etc que vous devriez voir maintenant et placez ici les dossiers apps et etc de votre package de contenu.
4. Dans Eclipse, cliquez avec le bouton droit sur le projet PROJECT.ui.apps et sélectionnez Actualiser.

Faites ensuite de même pour PROJECT.ui.content et remplacez son dossier de contenu par celui de vos packages :

1. Dans le panneau Project Explorer (Explorateur de projets), développez PROJECT.ui.content > src > main > content > jcr_root > content.
2. Cliquez avec le bouton droit sur le dossier de contenu le plus profond et sélectionnez Afficher dans > Explorateur système.
3. Supprimez le dossier de contenu que vous devriez voir maintenant et placez ici le dossier de contenu de votre package de contenu.
4. Dans Eclipse, cliquez avec le bouton droit sur le projet PROJECT.ui.content et sélectionnez 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.

• Voici un exemple de l’aspect que peut avoir votre fichier 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 diviser ces règles de filtrage en deux et mettre à jour les fichiers filter.xml de ces deux projets en conséquence.

1. Dans Eclipse, ouvrez PROJECT.ui.apps/src/main/content/META-INF/filter.xml.

2. Remplacez le contenu de l’élément <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>
     

3. Ouvrez ensuite PROJECT.ui.content/src/main/content/META-INF/filter.xml.

4. Remplacez les règles par celles de votre package qui commencent par /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 Nettoyer et Publish.