Sviluppo di Componenti core developing-core-components
Quando utilizzare i Componenti core? when-to-use-the-core-components
Poiché i Componenti core sono completamente nuovi e offrono molteplici vantaggi, si consiglia di utilizzarli nei nuovi progetti AEM. Per i progetti esistenti, è consigliabile prevedere una migrazione dei componenti solo nell’ambito di una sostanziale rilavorazione di un progetto, ad esempio in caso di rebranding o refactoring globale.
Pertanto, Adobe fornisce le seguenti raccomandazioni:
- Nuovi progetti
Per i nuovi progetti si deve sempre tentare di utilizzare i Componenti core. Se i Componenti core non possono essere utilizzati direttamente o nella versione estesa per soddisfare i requisiti del progetto, si consiglia di creare un componente personalizzato seguendo l’architettura dei componenti impostata nei Componenti core. Ad eccezione dei casi in cui non esiste un’alternativa possibile, evita di utilizzare i componenti di base. - Progetti esistenti
Si raccomanda di continuare a utilizzare i componenti di base, a meno che non sia pianificato il refactoring di un sito o di un componente.
In quanto ampiamente utilizzati nella maggior parte dei progetti esistenti, i componenti di base continueranno a essere supportati. - Nuovi componenti personalizzati
Valuta se è possibile personalizzare un componente core esistente.
In caso contrario, si consiglia di creare un nuovo componente personalizzato seguendo le Linee guida per i componenti. - Componenti personalizzati esistenti
Se i componenti funzionano come previsto, mantienili così come sono.
In caso contrario, vedi “Nuovi componenti personalizzati” sopra.
Come utilizzare in modo efficace i Componenti core how-to-succeed
I Componenti core sono efficienti, flessibili e facili da usare e personalizzare. L’aderenza ad alcune linee guida chiave garantirà il successo del tuo progetto con i Componenti core.
Migrazione ai Componenti core
Tutti i nuovi progetti devono essere implementati con i Componenti core. Tuttavia, i progetti esistenti hanno in genere implementazioni estese di componenti di base.
Migrazione dai componenti di base from-foundation
Una sostanziale rilavorazione di un progetto esistente (ad esempio, in caso di rebranding o refactoring globale) spesso offre la possibilità di migrazione ai Componenti core. Per facilitare questa migrazione, Adobe ha fornito una serie di strumenti di migrazione per incoraggiare l’adozione dei Componenti core e della tecnologia AEM più recente.
Gli strumenti di modernizzazione AEM consentono di convertire facilmente:
- Modelli statici in modelli modificabili
- Configurazioni di progettazione in criteri
- Componenti di base in Componenti core
- Interfaccia utente classica in interfaccia utente touch
Per ulteriori informazioni sull’utilizzo di questi strumenti, vedi la relativa documentazione.
Migrazione tramite il passaggio ad AEM as a Cloud Service via-aemaacs
Poiché AEM as a Cloud Service viene fornito automaticamente con l’ultima versione dei Componenti core, quando effettui il passaggio da un’installazione AEM on-premise, devi rimuovere qualsiasi dipendenza dai Componenti core nel file pom.xml
dei tuoi progetti.
I componenti proxy continueranno a funzionare come prima perché i proxy puntano al supertipo necessario e il percorso del supertipo contiene già la versione. In questo modo, la semplice rimozione della dipendenza consente ai Componenti core di funzionare in AEMaaCS proprio come accadeva con AEM on-premise.
Come per qualsiasi altro progetto AEMaaCS, dovrai aggiungere anche una dipendenza al jar del Software Development Kit (SDK) di AEM. Questa dipendenza non è specifica per i Componenti core, ma è obbligatoria.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Per ulteriori informazioni sui progetti AEMaaCS, vedi il documento Struttura dei progetti AEM.
Supporto dei Componenti core core-component-support
I Componenti core sono parte integrante di AEM e sono supportati in quanto tali, soggetti agli stessi termini e condizioni dei prodotti forniti con Quickstart.
Come altre caratteristiche dei prodotti AEM, la regola generale è: i componenti vengono inizialmente dichiarati obsoleti e i meno recenti vengono rimossi nella successiva versione di AEM. In questo modo i clienti hanno il tempo per passare alla nuova versione del componente prima della fine del supporto.
La versione di ogni componente indica chiaramente le versioni di AEM supportate. Quando cessa il supporto per una versione di AEM, cessa anche il supporto dei Componenti core per quella versione di AEM.
Per informazioni dettagliate sul supporto delle personalizzazioni dei componenti, visita la pagina Personalizzazione dei Componenti core.
Funzionalità tecniche technical-capabilities
La tabella che segue offre una panoramica delle differenze tra i Componenti core e i componenti di base.
Per informazioni dettagliate sulle loro funzionalità di authoring e sulle opzioni per preconfigurarle, visita la pagina di authoring relativa a tali funzionalità.
Elenco dei componenti component-list
La tabella che segue riporta i Componenti core disponibili, il collegamento alle relative API e l’indicazione di quali componenti di base sostituiscono.
/libs/foundation/components/page /libs/wcm/foundation/components/page
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/start /libs/foundation/components/form/end
/libs/foundation/components/form/text /libs/foundation/components/form/password
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
/libs/foundation/components/search
-
/libs/foundation/components/carousel
-
/libs/cq/experience-fragments/editor/components/experiencefragment
Aggiornamento dei Componenti core upgrade-of-core-components
Uno dei vantaggi dei componenti con versione è la possibilità di separare la migrazione a una nuova versione di AEM dalla migrazione a nuove versioni dei componenti. Inoltre, se sono disponibili nuove versioni dei componenti, consente la migrazione individuale di ciascun componente alla nuova versione.
Le migrazioni a una nuova versione di AEM non influiscono sul funzionamento dei Componenti core, purché le loro versioni supportino anche la nuova versione di AEM a cui si migra. Neppure le personalizzazioni apportate ai Componenti core vengono influenzate, a condizione che non utilizzino API obsolete o rimosse.
Le migrazioni a nuove versioni dei Componenti core non influiscono neppure sulla modalità di funzionamento del componente. Tuttavia, gli autori delle pagine potrebbero avere a disposizione nuove funzioni che potrebbero richiedere un aggiustamento della configurazione tramite un editor di modelli, nel caso in cui il comportamento predefinito non fosse quello desiderato. Inoltre, potrebbe essere necessario adattare le personalizzazioni. Per ulteriori dettagli, visita la pagina Personalizzazione dei Componenti core.