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.

SUGGERIMENTO

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

  • Procedure ottimali: Bootstrap del sito con tutte Adobi procedure consigliate più recenti.
  • Basso codice: modificate i modelli, create i contenuti, distribuite i CSS e il sito è pronto per essere live.
  • Cloud-Ready: Se lo desideri, usa 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 che garantisca velocità e sicurezza.
  • Multi-sito: se necessario, archetype genera la struttura del contenuto per una configurazione multi-lingua e multi-regione.
  • 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, definire il modo in cui gli elementi vengono ridisposti per i punti di interruzione definiti.
  • Intestazione e piè di pagina: Assemblare e localizzare 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 a tali componenti.
  • build front-end: gli sviluppatori front-end possono creare blocchi AEM pagine e creare librerie client con webpack, TypeScript e SASS.
  • WebApp-Ready: Per i siti che utilizzano Reactor Angular, utilizza l’ SPA SDKper mantenere la creazione contestuale dell’app.
  • Commerce abilitato: per progetti che desiderano integrare AEM Commerceologia con soluzioni commerciali come Magentousing the Commerce Core Components.
  • Esempio di codice: estraete il componente HelloWorld e i modelli, i servlet, i filtri e i pianificatori di esempio.
  • Open Sourced: se qualcosa non è come dovrebbe, contribuisci ai tuoi 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;
    Impostare aemVersion=6.5.0 per Adobe Managed Services o in sede.
    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 dei componenti, della configurazione e delle cartelle di contenuto, nonché i nomi delle librerie client.
  • Regolate 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 per AEM come Cloud Service; oppure 6.5.0 o 6.4.4 per Adobe Managed Services o in sede).
sdkVersion latest Quando è possibile specificare una versione aemVersion=cloud di SDK (ad esempio 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 dei frontend per webpack che genera le librerie client (può essere general o none per i siti regolari; può essere angular o react per un'app a pagina singola che implementa l'editor 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 principale per le lingue (può essere y o n).
includeExamples n Include un sito di esempio Libreria 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 Attivare l'integrazione con livello dati client Adobe.
amp n Abilita il supporto di 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
24 Continuo 6.5.5.0+ 6.4.8.1+ 8, 11 3.3.9+

Imposta l'ambiente di sviluppo locale per AEM come Cloud Service SDK o per versioni precedenti di AEM.

Problemi noti

Quando si esegue in Windows e si genera la configurazione del dispatcher, è necessario eseguire un prompt dei comandi elevato o il sottosistema Windows per Linux (vedere #329).

Durante l'esecuzione dell'archetype in modalità interattiva (senza il parametro -B), 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 (vedete
ARCHETYPE-308 per i dettagli).

Lettura successiva

Per ulteriori dettagli sull'utilizzo dell'archetype, compresi i vantaggi, le opzioni e il funzionamento dei moduli, vedere il documento Using the Archetype document.

In questa pagina