Come strutturare i vari elementi - La tua app e il tuo contenuto in AEM headless

In questa parte del Percorso per sviluppatori AEM headless, scoprirai come utilizzare lo strumento di sviluppo AEM e l’SDK Headless per realizzare l’applicazione.

Percorso affrontato finora

Nel documento precedente del percorso AEM headless, Come aggiornare i contenuti tramite le API di AEM Assets hai imparato ad aggiornare il contenuto headless esistente in AEM tramite API e ora dovresti:

  • Comprendere l’API HTTP di AEM Assets.

Obiettivo

Questo articolo ha lo scopo di aiutarti a capire come strutturare la tua applicazione AEM headless:

  • Scoprire l’SDK di AEM Headless e gli strumenti di sviluppo necessari
  • Impostare un runtime di sviluppo locale per simulare il contenuto prima della pubblicazione
  • Comprendere le nozioni di base di AEM sulla replica dei contenuti

L’SDK di AEM

L’SDK di AEM viene utilizzato per generare e distribuire il codice personalizzato. È lo strumento principale di cui hai bisogno per sviluppare e testare la tua applicazione headless prima della pubblicazione. Contiene i seguenti artefatti:

  • Il file jar Quickstart: un file jar eseguibile che può essere utilizzato per impostare sia un’istanza di authoring che di pubblicazione
  • Strumenti di Dispatcher: il modulo Dispatcher e le sue dipendenze per i sistemi basati su Windows e UNIX®
  • Jar API Java™ - La dipendenza Java™ Jar/Maven che espone tutte le API Java™ consentite che possono essere utilizzate per lo sviluppo rispetto ad AEM
  • Jar Javadoc: i javadoc per il jar API Java™

L’SDK di AEM Headless

Diverso dall’SDK di AEM, l’SDK headless di AEM è un set di librerie che possono essere utilizzate dai client per interagire in modo rapido e semplice con le API di AEM headless tramite HTTP.

Per ulteriori informazioni sull’SDK headless di AEM, consulta la sezione documentazione qui.

Strumenti di sviluppo aggiuntivi

Oltre all’SDK di AEM, sono necessari strumenti aggiuntivi per lo sviluppo e il test locale del codice e del contenuto:

  • Java™
  • Git
  • Apache Maven
  • La libreria Node.js
  • L’IDE che preferisci

Poiché AEM è un’applicazione Java™, è necessario installare Java™ e l’SDK Java™ per supportare lo sviluppo di AEM as a Cloud Service.

Git è ciò che utilizzerai per gestire il controllo del codice sorgente e per tenere traccia delle modifiche a Cloud Manager e, quindi, distribuirle su un’istanza di produzione.

AEM utilizza Apache Maven per creare progetti generati dall’archetipo del progetto Maven di AEM. Tutti gli IDE principali forniscono supporto per l’integrazione per Maven.

Node.js è un ambiente di esecuzione di codice JavaScript utilizzato per lavorare con le risorse front-end di un ui.frontend sottoprogetto di un progetto AEM. Node.js è distribuito con npm, è di fatto Node.js Package Manager, utilizzato per gestire le dipendenze JavaScript.

Panoramica dei componenti di un sistema AEM

Ora, osserviamo le parti costitutive di un ambiente AEM.

Un ambiente AEM completo è costituito da authoring, pubblicazione e Dispatcher. Questi stessi componenti sono resi disponibili nel runtime di sviluppo locale per facilitare l’anteprima del codice e del contenuto prima della pubblicazione.

  • Il servizio di authoring è il luogo in cui gli utenti interni creano, gestiscono e visualizzano in anteprima i contenuti.

  • Il servizio di pubblicazione è considerato l’ambiente “live” ed è normalmente ciò con cui gli utenti finali interagiscono. I contenuti vengono modificati e approvati nel servizio di authoring e quindi distribuiti al servizio di pubblicazione. Il modello di implementazione più comune per le applicazioni headless AEM consiste nella connessione della versione di produzione dell’applicazione a un servizio di pubblicazione AEM.

  • Il Dispatcher è un server web statico potenziato con il modulo Dispatcher di AEM. Memorizza nella cache le pagine web prodotte dall’istanza di pubblicazione per migliorare le prestazioni.

Flusso di lavoro di sviluppo locale

Il progetto di sviluppo locale è basato su Apache Maven e utilizza Git per il controllo del codice sorgente. Per aggiornare il progetto, gli sviluppatori possono utilizzare, tra gli altri, il proprio ambiente di sviluppo integrato preferito, ad esempio Eclipse, Visual Studio Code o IntelliJ.

Per testare gli aggiornamenti di codice o contenuto acquisiti dall’applicazione headless, devi distribuire gli aggiornamenti al runtime AEM locale, che include le istanze locali dei servizi di authoring e pubblicazione AEM.

Assicurati di prendere nota delle distinzioni tra ogni componente nel runtime AEM locale, in quanto è importante testare gli aggiornamenti dove contano di più. Ad esempio, prova gli aggiornamenti del contenuto sull’authoring o testa il nuovo codice sull’istanza di pubblicazione.

In un sistema di produzione, un Dispatcher e un server http Apache saranno sempre posti davanti a un’istanza di pubblicazione AEM. Fornisce servizi di caching e sicurezza per il sistema AEM, pertanto è fondamentale testare il codice e gli aggiornamenti di contenuto anche in Dispatcher.

Anteprima del codice e del contenuto localmente con l’ambiente di sviluppo locale

Per preparare il progetto headless di AEM per il lancio, è necessario assicurarsi che tutte le sue parti costitutive funzionino bene.

Per farlo, devi mettere tutto insieme: codice, contenuto e configurazione e testarlo in un ambiente di sviluppo locale per renderlo disponibile dal vivo.

L’ambiente di sviluppo locale si articola in tre aree principali:

  1. Progetto AEM: questo progetto contiene tutto il codice personalizzato, la configurazione e il contenuto su cui gli sviluppatori di AEM lavoreranno
  2. Local AEM Runtime: versioni locali dei servizi di authoring e pubblicazione AEM utilizzati per distribuire il codice dal progetto AEM
  3. Esecuzione del Dispatcher locale: una versione locale del server Web Apache httpd che include il modulo Dispatcher

Una volta configurato l’ambiente di sviluppo locale, puoi simulare la gestione dei contenuti nell’app React distribuendo localmente un server nodo statico.

Passaggio successivo

Ora che hai completato questa parte del percorso per sviluppatori headless di AEM, dovresti:

  • Avere familiarità con gli strumenti di sviluppo di AEM
  • Comprendere il flusso di lavoro di sviluppo locale

Continua il tuo percorso headless di AEM passando alla prossima revisione del documento Come andare in diretta con la tua applicazione headless dove si trasmette il tuo progetto headless di AEM in diretta!

Risorse aggiuntive

In questa pagina