Configurare l’SDK AEM locale set-up-local-aem-sdk

Adobe Experience Manager (AEM) può essere eseguito localmente utilizzando il file Quickstart Jar dell’SDK di AEM as a Cloud Service. Consente agli sviluppatori di distribuire e testare il codice, la configurazione e i contenuti personalizzati prima di passare al controllo del codice sorgente e di distribuirli in un ambiente AEM as a Cloud Service.

Tieni presente che ~ viene utilizzato come abbreviazione per la directory utente. In Windows, equivale a %HOMEPATH%.

Installare Java™

Experience Manager è un’applicazione Java™ e pertanto richiede Oracle Java™ SDK per supportare gli strumenti di sviluppo.

$ java --version

$ java -version

$ java --version

Scaricare l’SDK as a Cloud Service dell’AEM

L’SDK per AEM as a Cloud Service, o SDK AEM, contiene il Jar Quickstart utilizzato per eseguire AEM Author e Publish localmente per lo sviluppo, nonché la versione compatibile degli strumenti di Dispatcher.

Estrarre il file JAR Quickstart dallo zip dell’SDK dell’AEM

Configurare il servizio Autore AEM locale set-up-local-aem-author-service

Il servizio di authoring AEM locale offre agli sviluppatori un’esperienza locale che gli esperti di marketing digitale e gli autori di contenuti condivideranno per creare e gestire i contenuti. Il servizio di authoring AEM è progettato sia come ambiente di authoring che come ambiente di anteprima, consentendo di eseguire la maggior parte delle convalide dello sviluppo delle funzioni in base a esso, rendendolo un elemento fondamentale del processo di sviluppo locale.

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar

$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

Configurare il servizio di pubblicazione AEM locale

Il servizio di pubblicazione AEM locale offre agli sviluppatori l’esperienza locale di cui godono gli utenti finali dell’AEM, ad esempio navigando nel sito Web ospitato su AEM. È importante un servizio di pubblicazione AEM locale, in quanto si integra con l’SDK dell’AEM Strumenti di Dispatcher e consente agli sviluppatori di testare e mettere a punto l’esperienza finale per l’utente finale.

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-Quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar

$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-Quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

Configurare i servizi AEM locali in modalità prerelease

Il runtime AEM locale può essere avviato in modalità prerelease consentire a uno sviluppatore di utilizzare le funzioni della versione successiva dell’AEM as a Cloud Service. La versione prerelease è abilitata trasmettendo il -r prerelease discussione sul primo avvio del runtime locale dell’AEM. Può essere utilizzato sia con i servizi locali di creazione AEM che con i servizi di pubblicazione AEM.

# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

Simula distribuzione contenuto content-distribution

In un ambiente di Cloud Service reale, il contenuto viene distribuito dal servizio di authoring al servizio di pubblicazione utilizzando Distribuzione dei contenuti Sling e la pipeline di Adobe. Il Pipeline Adobe è un microservizio isolato disponibile solo nell’ambiente cloud.

Durante lo sviluppo, può essere opportuno simulare la distribuzione dei contenuti utilizzando il servizio Author e Publish locale. Ciò può essere ottenuto abilitando gli agenti di replica legacy.

Modalità di avvio di Quickstart Jar

Denominazione del file JAR Quickstart, aem-<tier>_<environment>-p<port number>.jar specifica la modalità di avvio. Una volta avviato in un livello specifico, di authoring o pubblicazione, l’AEM non può essere modificato nel livello alternativo. Per eseguire questa operazione, il crx-Quickstart La cartella generata durante la prima esecuzione deve essere eliminata e Quickstart Jar deve essere eseguito nuovamente. L’ambiente e le porte possono essere modificati, ma richiedono l’arresto/avvio dell’istanza AEM locale.

Modifica degli ambienti dev, stage e prod, può essere utile per gli sviluppatori per garantire che le configurazioni specifiche dell’ambiente siano definite e risolte correttamente dall’AEM. Si consiglia di eseguire lo sviluppo locale principalmente in base all’impostazione predefinita dev modalità di esecuzione dell’ambiente.

Le permutazioni disponibili sono le seguenti:

Il numero di porta può essere una qualsiasi porta disponibile sul computer di sviluppo locale, tuttavia per convenzione:

Cambiarli potrebbe richiedere modifiche alle configurazioni dell’SDK dell’AEM

Arresto di un runtime AEM locale

Per arrestare un runtime AEM AEM locale, aprire la finestra della riga di comando utilizzata per avviare il runtime AEM, quindi toccare Ctrl-C. Attendere la chiusura dell'AEM. Al termine del processo di arresto, è disponibile il prompt dei comandi.

Attività di configurazione runtime AEM locali opzionali

Quando aggiornare Quickstart Jar

Aggiorna l’SDK dell’AEM almeno mensilmente l’ultimo giovedì di ogni mese, o poco dopo, cioè la data di rilascio delle "funzioni" as a Cloud Service dell’AEM.

Come evitare la perdita di contenuti durante l’aggiornamento dell’SDK per AEM

L’aggiornamento dell’SDK dell’AEM crea effettivamente un nuovo runtime dell’AEM, incluso un nuovo archivio, il che significa che tutte le modifiche apportate a un precedente archivio dell’SDK dell’AEM vengono perse. Di seguito sono riportate alcune valide strategie per contribuire a mantenere contenuti permanenti tra gli aggiornamenti dell’SDK AEM e possono essere utilizzate in modo discreto o insieme:

Ricorda che l’utilizzo degli approcci di cui sopra per mantenere il codice tra gli aggiornamenti dell’SDK AEM indica un anti-pattern di sviluppo. Il codice non monouso deve avere origine nell’IDE di sviluppo e fluire nell’SDK dell’AEM tramite le implementazioni.

Risoluzione dei problemi

Se si fa doppio clic sul file Jar Quickstart, viene generato un errore troubleshooting-double-click

Quando si fa doppio clic sul file JAR Quickstart per iniziare, viene visualizzato un messaggio di errore modale che impedisce l’avvio dell’AEM a livello locale.

Questo perché Quickstart Jar as a Cloud Service dall’AEM non supporta il doppio clic sul Jar Quickstart per avviare l’AEM a livello locale. È invece necessario eseguire il file Jar da tale riga di comando.

Per avviare il servizio di creazione AEM: cd nella directory contenente il file Jar Quickstart ed esegui il comando:

$ java -jar aem-author-p4502.jar

$ java -jar aem-author-p4502.jar

$ java -jar aem-author-p4502.jar

oppure, per avviare il servizio di pubblicazione AEM, cd nella directory contenente il file Jar Quickstart ed esegui il comando:

$ java -jar aem-publish-p4503.jar

$ java -jar aem-publish-p4503.jar

$ java -jar aem-publish-p4503.jar

L’avvio del file JAR Quickstart dalla riga di comando si interrompe immediatamente troubleshooting-java-8

Quando si avvia Quickstart Jar dalla riga di comando, il processo si interrompe immediatamente e il servizio AEM non si avvia, con il seguente errore:

➜  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

Questo perché AEM as a Cloud Service richiede Java™ SDK 11 e stai eseguendo una versione diversa, molto probabilmente Java™ 8. Per risolvere il problema, scaricare e installare [Oracle Java™ SDK 11](https://experience.adobe.com/#/downloads/content/software-distribution/en/general.html?1_group.propertyvalues.property=.%2Fjcr%3Acontent%2Fmetadata%2Fdc%3AsoftwareType&1_group.propertyvalues.operation=equals&1_group.propertyvalues.0_values=tipo di software%3Atooling&fulltext=Oracle%7E+JDK%7E+11%7E&orderby=%40jcr%3Acontent%2Fjcr%3AlastModified&orderby.sort=desc&layout=list&p.offset=0&p.limit=14).

Una volta installato l’SDK Oracle Java™ 11, verifica che si tratti della versione attiva eseguendo il comando dalla riga di comando:

$ java --version

$ java -version

$ java --version

Risorse aggiuntive