Archétype de projet AEM

L’archétype de projet AEM est un modèle Maven qui crée un projet Adobe Experience Manager (AEM) minimal qui s’appuie sur des bonnes pratiques pour démarrer votre site web.

Ressources

• Documentation de l’archétype (ce document) : présentation de l’architecture de l’archétype et de ses différents modules.
  • Utilisation de l’archétype : détails supplémentaires sur l’utilisation de l’archétype et des modules disponibles.
  • ui.frontend : utilisation du module de création front-end.
• Les tutoriels suivants sont basés sur cet archétype :
  • Site WKND : apprenez à créer un site web attrayant.
  • Application monopage WKND : découvrez comment concevoir une application web React ou Angular offrant des fonctions de création complètes dans AEM.

Fonctions

• Bonne pratique : démarrez votre site en suivant toutes les dernières pratiques recommandées par Adobe.
• Peu de code requis : modifiez vos modèles, créez du contenu, déployez votre feuille de style CSS et votre site est prêt à être publié.
• Prêt pour le cloud : si vous le souhaitez, utilisez AEM as a Cloud Service pour publier votre site en quelques jours seulement, ainsi que pour faciliter l’évolutivité et la maintenance.
• Dispatcher : un projet ne sera complet qu’avec une configuration du Dispatcher qui assure vitesse et sécurité.
• Multi-site : si nécessaire, l’archétype génère la structure de contenu pour une configuration multilingue et multi-région.
• Composants principaux : les auteurs peuvent créer pratiquement n’importe quelle disposition grâce à notre ensemble polyvalent de composants standardisés.
• Modèles modifiables : assemblez pratiquement n’importe quel modèle sans code et définissez ce que les auteurs sont autorisés à modifier.
• Disposition en responsive design : sur les modèles ou les pages individuelles, définissez la manière dont les éléments se redistribuent pour les points d’arrêt définis.
• En-tête et pied de page : assemblez-les et localisez-les sans code, à l’aide des fonctionnalités de localisation des composants.
• Système de style : évitez de devoir créer des composants personnalisés en permettant aux auteurs de leur appliquer différents styles.
• Création front-end : les développeurs front-end peuvent concevoir des maquettes de pages AEM et créer des bibliothèques clientes avec Webpack, TypeScript et SASS.
• Prêt pour WebApp : pour les sites qui utilisent React ou Angular, utilisez le SDK SPA afin de conserver la création en contexte au sein de l’application.
• Compatible Commerce : pour les projets qui souhaitent intégrer AEM Commerce à des solutions commerciales comme Magento à l’aide des composants principaux Commerce.
• Exemple de code : vous pouvez extraire le composant HelloWorld, ainsi que les exemples de modèles, servlets, filtres et planificateurs.
• Open source : si quelque chose ne va pas, contribuez en apportant vos améliorations.

Utilisation

Pour générer un projet, ajustez la ligne de commande suivante en fonction de vos besoins :

mvn -B archetype:generate \
 -D archetypeGroupId=com.adobe.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=XX \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \

• Remplacez XX par le dernier numéro de version de l’archétype.
• Définissez aemVersion=cloud pour AEM as a Cloud Service.
  Définissez aemVersion=6.5.0 pour Adobe Managed Services ou On-Premise.
  La dépendance des composants principaux n’est ajoutée que pour les versions d’AEM hors du cloud, car ils sont fournis prêts à l’emploi pour AEM as a Cloud Service.
• Ajustez appTitle="My Site" de façon à définir le titre du site web et les groupes de composants.
• Ajustez appId="mysite" afin de définir l’artifactId Maven, les noms des dossiers de composants, de configurations et de contenu, ainsi que les noms des bibliothèques clientes.
• Ajustez groupId="com.mysite" pour définir le groupId Maven et le package source Java.
• Parcourez la liste des propriétés disponibles pour déterminer si d’autres doivent être modifiées.

Propriétés disponibles

Configuration requise

Configurez votre environnement de développement local pour le SDK AEM as a Cloud Service ou pour les versions antérieures d’AEM.

Problèmes connus

Lorsque vous exécutez Windows et générez la configuration du Dispatcher, vous devez utiliser une invite de commande avec élévation de privilèges ou le sous-système Windows pour Linux (voir le problème 329).

Lors de l’exécution de l’archétype en mode interactif (sans le paramètre -B), les propriétés avec des valeurs par défaut ne peuvent pas être modifiées, sauf si la confirmation finale est rejetée, ce qui répète les questions en incluant les propriétés avec des valeurs par défaut (voir ARCHETYPE-308 pour plus de détails).

Vous ne pouvez pas utiliser cet archétype dans Eclipse lors du démarrage d’un nouveau projet avec File -> New -> Maven Project, car le script de post-génération archetype-post-generate.groovy ne sera pas exécuté en raison d’un problème concernant Eclipse. La solution consiste à utiliser la ligne de commande ci-dessus, puis, dans Eclipse, à utiliser File -> Import -> Existing Maven Project.

Informations complémentaires

Pour plus d’informations sur l’utilisation de l’archétype, notamment ses avantages, ses options et le fonctionnement de ses modules, consultez le document Utilisation de l’archétype.