Show Menu
ARGOMENTI×

AEM Project Archetype

AEM Project Archetype è un modello Maven che crea un progetto Adobe Experience Manager (AEM) minimale basato sulle best practice come punto di partenza per il sito Web.
L'ultimo AEM Project Archetype è 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: Bootstrap il tuo sito con tutte Adobe procedure consigliate più recenti.
  • 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 Cloud Service 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: Gli sviluppatori front-end possono mascherare AEM pagine 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 .
  • Commerce abilitato: Per progetti che desiderano integrare AEM Commerce con soluzioni di commercio come Magento utilizzando i componenti core di Commerce.
  • Esempio di codice: Estrarre il componente HelloWorld e i modelli, servlet, filtri e pianificatori di esempio.
  • 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.aem \
 -D archetypeArtifactId=aem-project-archetype \
 -D archetypeVersion=24 \
 -D appTitle="My Site" \
 -D appId="mysite" \
 -D groupId="com.mysite" \

  • Impostare aemVersion=cloud per AEM come 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 Cloud Service OOOTB 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
cloud
AEM versione di destinazione (può essere cloud AEM come Cloud Service ; oppure 6.5.0 , 6.4.4 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
general
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 editor-overview.html SPA).
language
en
Codice della lingua (ISO 639-1) per creare la struttura del contenuto da (ad esempio en , deu ).
country
us
Codice del paese (ISO 3166-1) per creare la struttura del contenuto da (ad esempio US ).
singleCountry
y
Include una struttura del contenuto master del linguaggio (può essere y o n ).
includeExamples
n
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 ).
includeCommerce
n
Include dipendenze CIF dei componenti core e genera artefatti corrispondenti.
commerceEndpoint
Obbligatorio solo per CIF. Endpoint opzionale del servizio GraphQL del sistema commerciale da utilizzare (ad esempio https://hostname.com/grapql ).
datalayer
y
Attiva l'integrazione con livello dati client Adobe.
amp
n
Abilita il supporto AMP per i modelli di progetto generati.

Requisiti di sistema

Archetype
AEM as a Cloud Service
AEM 6.5
AEM 6.4
Java SE
Paradiso
Continuo
6.5.5.0+
6.4.8.1+
8, 11
3.3.9+
Imposta l’ambiente di sviluppo locale per AEM come SDK Cloud Service o per 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.