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

Ouvrez le site web AEM Developer Tools.

Copiez le lien d’installation.

• Vous pouvez également télécharger une archive au lieu d’utiliser le lien d’installation.
• Cette méthode permet une installation hors ligne, mais vous ne recevez pas de 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 Détails de l’installation, passez en revue les éléments à installer et cliquez de nouveau sur Suivant.

Acceptez les contrats de licence et cliquez sur Finish (Terminer).

Dans la boîte de dialogue Autorités d’approbation qui s’affiche, sélectionnez l’https://eclipse.adobe.com d’autorité/de site et cliquez sur Approbation sélectionnée.

Dans la boîte de dialogue Artefacts d’approbation qui s’affiche, sélectionnez les signataires de code et cliquez sur Approbation sélectionnée.

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).

com.adobe.aem : aem-project-archetype : <highest-number> doit être sélectionné automatiquement dans la liste déroulante Archétype. Sélectionnez une version précédente, le cas échéant. Cliquez sur 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).

Configurez un serveur AEM auquel Eclipse se connecte en sélectionnant Configurer un nouveau serveur et en fournissant un nom de serveur et les informations de connexion nécessaires.

• Pour utiliser la fonctionnalité de débogage, vous devez démarrer AEM en mode débogage en fournissant le paramètre -agentlib, par exemple :

$ java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 -jar aem-author-p4502.jar

Cliquez sur Finish (Terminer).

Suivez les instructions pour créer un exemple de projet multi-module qui crée une structure de projet de base avec une séparation saine des 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
• 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 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.
4. Au même emplacement, placez les dossiers apps et etc de votre package de contenu.
5. 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 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 à cet endroit.
4. Placez le dossier de contenu de votre package de contenu au même emplacement.
5. Dans Eclipse, cliquez avec le bouton droit sur le projet PROJECT.ui.content et sélectionnez Actualiser.

Mettez à jour les fichiers filter.xml de ces deux projets pour qu’ils correspondent au contenu de votre package de contenu en ouvrant 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>

En ce qui concerne le contenu de votre package qui a été divisé en deux projets, vous devez également diviser ces règles de filtrage en deux et mettre à jour les fichiers filter.xml des 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 :

     code language-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"/> </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 :

     code language-xml
     <?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 Serveurs, assurez-vous que la connexion est démarrée, et si oui, ne la démarrez pas.

Cliquez sur l’icône Nettoyer et publier.