Show Menu
TOPICS×

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.
Le dernier archétype de projet AEM est disponible sur GitHub .

Ressources

  • Documentation de l’archétype (ce document) :
    présentation de l’architecture de l’archétype et de ses différents modules.
  • Les tutoriels suivants reposent sur cet archétype :

Fonctionnalités

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.granite.archetypes \ -D archetypeArtifactId=aem-project-archetype \ -D archetypeVersion=23 \ -D aemVersion=cloud \ -D appTitle="My Site" \ -D appId="mysite" \ -D groupId="com.mysite" \ -D frontendModule=general \ -D includeExamples=n
  • 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

Nom
Valeur par défaut
Description
appTitle
Titre de l’application qui sera utilisé comme titre du site web et des groupes de composants (par exemple,
"My Site"
).
appId
Nom technique qui sera utilisé pour les noms des dossiers de composants, de configurations et de contenu, ainsi que pour les noms des bibliothèques clientes (par exemple,
"mysite"
).
artifactId
${appId}
ID d’artefact Maven de base (par exemple,
"mysite"
).
groupId
ID de groupe Maven de base (par exemple,
"com.mysite"
).
package
${groupId}
Package source Java (par exemple,
"com.mysite"
).
version
1.0-SNAPSHOT
Version du projet (par exemple,
1.0-SNAPSHOT
).
aemVersion
6.5.0
Version d’AEM cible (par exemple,
cloud
pour AEM as a Cloud Service  ; ou
6.5.0
,
6.4.4
ou
6.3.3
pour Adobe Managed Services ou On-Premise).
sdkVersion
latest
Lorsque
aemVersion=cloud
, une version de SDK peut être spécifiée (par exemple,
2020.02.2265.20200217T222518Z-200130
).
includeDispatcherConfig
y
Inclut une configuration du Dispatcher pour le cloud ou pour AMS/On-Premise, selon la valeur de
aemVersion
(par exemple,
y
ou
n
).
frontendModule
none
Comprend un module de création front-end Webpack qui génère les bibliothèques clientes (par exemple,
general
ou
none
pour les sites standard ; ou
angular
ou
react
pour une application monopage qui implémente l’ éditeur d’application monopage ).
languageCountry
en_us
Code de langue et de pays utilisé pour créer la structure de contenu (par exemple,
en_us
).
singleCountry
y
Inclut une structure de contenu servant de gabarit de langue (par exemple,
y
ou
n
).
includeExamples
y
Inclut un exemple de site de bibliothèque de composants (par exemple,
y
ou
n
).
includeErrorHandler
n
Inclut une page de réponse personnalisée 404 qui sera globale pour l’ensemble de l’instance (par exemple,
y
ou
n
).
includeCommerce
n
Inclut des dépendances CIF Core Components et génère des artefacts correspondants.
commerceEndpoint
Requis pour CIF uniquement. Point de terminaison facultatif du service GraphQL du système de commerce à utiliser (ex.
https://hostname.com/grapql
).
datalayer
y
Activez l’intégration avec la couche de données du client d’Adobe.
amp
n
Activez la prise en charge AMP pour les modèles de projet générés.

Configuration requise

Archétype
AEM as a Cloud Service
AEM 6.5
AEM 6.4
Java SE
Maven
Suite
6.5.5.0+
6.4.8.1+
8, 11
3.3.9+
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).

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 .