Show Menu
TOPICS×

AEM Project Archetype

AEM Project Archetype è un modello Maven che crea un progetto Adobe Experience Manager (AEM) minimo basato sulle best practice come punto di partenza per il sito Web.
L’ultimo tipo di archivio dei progetti AEM è disponibile su GitHub .

Riferimenti

  • Documentazione Archetype (questo documento):
    Panoramica dell'architettura archetype e dei suoi diversi moduli.
  • Le seguenti esercitazioni sono basate su questo tipo di archetipo:

Funzioni

  • Best practice:
    Avviate il sito con tutte le procedure consigliate più recenti di Adobe.
  • Codice basso:
    Modificate i modelli, create contenuti, distribuite i CSS e il sito è pronto per essere trasmesso in diretta.
  • Pronto per il cloud:
    Se lo desiderate, utilizzate AEM come servizio cloud per vivere in pochi giorni e semplificare la scalabilità e la manutenzione.
  • Dispatcher:
    Un progetto è completo solo con una configurazione dispatcher.html Dispatcher che ne garantisca la velocità e la sicurezza.
  • Più siti:
    Se necessario, l'archetipo genera la struttura del contenuto per una configurazione in più lingue e in più aree.
  • Componenti di base:
    Gli autori possono creare praticamente qualsiasi layout con il nostro set versatile di componenti standardizzati.
  • Modelli modificabili:
    Assemblate praticamente qualsiasi modello senza codice e definite gli elementi che gli autori possono modificare.
  • Layout reattivo:
    Nei modelli o nelle singole pagine, definite il modo in cui gli elementi si ridispongono per i punti di interruzione definiti.
  • Intestazione e piè di pagina:
    Assemblate e localizzate i componenti senza codice, utilizzando le funzioni di localizzazione dei componenti .
  • Sistema di stile:
    Evitate di creare componenti personalizzati consentendo agli autori di applicare stili diversi.
  • Build front-end:
    I dispositivi front-end possono mascherare le pagine AEM e creare librerie client con Webpack, TypeScript e SASS.
  • WebApp-Ready:
    Per i siti che utilizzano React o Angular , utilizzate SPA SDK per mantenere la creazione contestuale dell’app .
  • Esempio di codice:
    Estrarre il componente HelloWorld e i modelli di esempio, i servelet, i filtri e i pianificatori.
  • Apri origine:
    Se qualcosa non è come dovrebbe, contribuire ai vostri miglioramenti!

Utilizzo

Per generare un progetto, regola la seguente riga di comando in base alle tue esigenze:
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
  • Set
    aemVersion=cloud
    for AEM as a Cloud Service ; Impostato
    aemVersion=6.5.0
    per Adobe Managed Services o locale. La dipendenza Componenti di base viene aggiunta solo per le versioni Aem non cloud, in quanto i Componenti di base vengono forniti come servizio Cloud per AEM.
  • Regolate
    appTitle="My Site"
    per definire il titolo del sito Web e i gruppi di componenti.
  • Regolate
    appId="mysite"
    per definire il Maven artifactId, i nomi delle cartelle dei componenti, delle configurazioni e dei contenuti, nonché i nomi delle librerie dei client.
  • Regola
    groupId="com.mysite"
    per definire il Maven groupId e il pacchetto di origine Java.
  • Consultate l’elenco delle proprietà disponibili per verificare se vi sono altre proprietà da regolare.

Proprietà disponibili

Nome
Predefiniti
Descrizione
appTitle
Titolo applicazione, verrà utilizzato per il titolo del sito Web e i gruppi di componenti (ad es.
"My Site"
).
appId
Nome tecnico, verrà utilizzato per i nomi dei componenti, delle cartelle di configurazione e di contenuto, nonché per i nomi delle librerie client (ad esempio
"mysite"
).
artifactId
${appId}
ID artifact di base Maven (ad es.
"mysite"
).
groupId
ID gruppo Base Paradiso (ad es.
"com.mysite"
).
package
${groupId}
Pacchetto di origine Java (ad esempio
"com.mysite"
).
version
1.0-SNAPSHOT
Versione del progetto (ad es.
1.0-SNAPSHOT
).
aemVersion
6.5.0
versione di destinazione di AEM (può essere
cloud
per AEM come servizio cloud); oppure
6.5.0
,
6.4.4
, o
6.3.3
per i servizi gestiti Adobe o locali).
sdkVersion
latest
Quando è possibile specificare
aemVersion=cloud
una versione SDK (ad es.
2020.02.2265.20200217T222518Z-200130
).
includeDispatcherConfig
y
Include una configurazione dispatcher sia per il cloud che per AMS/locale, a seconda del valore di
aemVersion
(può essere
y
o
n
).
frontendModule
none
Include un modulo di generazione frontale Webpack che genera le librerie client (può essere
general
o
none
per siti regolari); può essere
angular
o
react
per un'app a pagina singola che implementa l'Editor spa-overview.html SPA).
languageCountry
en_us
Lingua e codice del paese da cui creare la struttura del contenuto (ad esempio
en_us
).
singleCountry
y
Include una struttura del contenuto master del linguaggio (può essere
y
o
n
).
includeExamples
y
Include un sito di esempio della libreria di componenti (può essere
y
o
n
).
includeErrorHandler
n
Include una pagina di risposta personalizzata 404 che sarà globale per l'intera istanza (può essere
y
o
n
).

Requisiti di sistema

Archetype
AEM as a Cloud Service
AEM 6.5
AEM 6.4
AEM 6.3
Java SE
Paradiso
Continuo
6.5.0.0+
6.4.4.0+
6.3.3.4+
8, 11
3.3.9+
Imposta l’ambiente di sviluppo locale per AEM come SDK di servizio cloud o per le versioni precedenti di AEM .

Problemi noti

Quando si esegue in Windows e si genera la configurazione del dispatcher, è necessario eseguire un prompt di comando elevato o il sottosistema Windows per Linux (vedere #329 ).
Durante l'esecuzione dell'archetype in modalità interattiva (senza il
-B
parametro), le proprietà con i valori predefiniti non possono essere modificate, a meno che la conferma finale non venga chiusa, il che ripete le domande includendo nelle domande le proprietà con i valori predefiniti (consultate ARCHETYPE-308 per i dettagli).

Lettura

Per ulteriori dettagli sull'utilizzo dell'archetipo, compresi i vantaggi, le opzioni e il funzionamento dei moduli, vedere il documento Utilizzo di Archetype.