DocumentazioneAEMTutorial su AEMTutorial su AEM as a Cloud Service

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

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Principiante
  • Sviluppatore

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.

~ viene utilizzato come abbreviazione per la directory dell'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.

  1. [Scarica e installa il 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) più recente
  2. Verifica che Oracle Java™ 11 SDK sia installato eseguendo il comando:
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Java

Scarica AEM as a Cloud Service SDK

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

  1. Accedi a https://experience.adobe.com/#/downloads/content/software-distribution/en/aemcloud.html con il tuo Adobe ID
    • Tieni presente che l'organizzazione Adobe deve essere predisposta per consentire ad AEM as a Cloud Service di scaricare AEM as a Cloud Service SDK.
  2. Passa alla scheda AEM as a Cloud Service
  3. Ordina per Data pubblicazione in ordine decrescente
  4. Fai clic sull'ultima riga dei risultati di AEM SDK
  5. Rivedi e accetta il Contratto di licenza con l'utente finale e tocca il pulsante Scarica

Estrai il file JAR Quickstart dallo zip SDK di AEM

  1. Decomprimi il file aem-sdk-XXX.zip scaricato

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

Il servizio di authoring locale di AEM 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 di AEM è progettato sia come ambiente di authoring che come ambiente di anteprima; su di esso è possibile eseguire la maggior parte delle convalide dello sviluppo delle funzioni, il che lo rende un elemento fondamentale del processo di sviluppo locale.

  1. Crea la cartella ~/aem-sdk/author

  2. Copia il file Quickstart JAR in ~/aem-sdk/author e rinominalo in aem-author-p4502.jar

  3. Avvia il servizio AEM Author locale eseguendo quanto segue dalla riga di comando:

    • java -jar aem-author-p4502.jar
      • Specificare la password amministratore come admin. Qualsiasi password amministratore è accettabile, tuttavia si consiglia di utilizzare l’impostazione predefinita per lo sviluppo locale per ridurre la necessità di riconfigurare.

    impossibile avviare AEM as Cloud Service Quickstart Jar facendo doppio clic.

  4. Accedi al servizio AEM Author locale all'indirizzo http://localhost:4502 in un browser Web

macOS
code language-shell 
$ 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
Windows
code language-shell 
$ 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
Linux®
code language-shell 
$ 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 locale di AEM

Il servizio di pubblicazione locale di AEM offre agli sviluppatori l’esperienza locale che gli utenti finali di AEM avranno, ad esempio la navigazione nel sito web ospitato su AEM. Un servizio di pubblicazione locale di AEM è importante in quanto si integra con gli strumenti Dispatcher di AEM SDK e consente agli sviluppatori di testare e perfezionare l'esperienza finale per l'utente finale.

  1. Crea la cartella ~/aem-sdk/publish

  2. Copia il file Quickstart JAR in ~/aem-sdk/publish e rinominalo in aem-publish-p4503.jar

  3. Avvia il servizio AEM Publish locale eseguendo quanto segue dalla riga di comando:

    • java -jar aem-publish-p4503.jar
      • Specificare la password amministratore come admin. Qualsiasi password amministratore è accettabile, tuttavia si consiglia di utilizzare l’impostazione predefinita per lo sviluppo locale per ridurre la necessità di riconfigurare.

    impossibile avviare AEM as Cloud Service Quickstart Jar facendo doppio clic.

  4. Accedi al servizio di pubblicazione AEM locale all'indirizzo http://localhost:4503 in un browser Web

macOS
code language-shell 
$ 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
Windows
code language-shell 
$ 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
Linux®
code language-shell 
$ 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 locale di AEM può essere avviato in modalità prerelease per consentire a uno sviluppatore di eseguire la generazione in base alle funzionalità della versione successiva di AEM as a Cloud Service. La versione prerelease è abilitata trasmettendo l'argomento -r prerelease al primo avvio del runtime AEM locale. Può essere utilizzato sia con i servizi AEM Author locali che con i servizi AEM Publish.

macOS
code language-shell 
# 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
Windows
code language-shell 
# 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
Linux®
code language-shell 
# 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 Cloud Service vero e proprio, il contenuto viene distribuito dal servizio di authoring al servizio di pubblicazione utilizzando Distribuzione contenuto Sling e la pipeline di Adobe. La pipeline di 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.

NOTE
Gli agenti di replica sono disponibili solo per l’utilizzo nel file JAR Quickstart locale e forniscono solo una simulazione della distribuzione dei contenuti.

  1. Accedi al servizio Author e passa a http://localhost:4502/etc/replication/agents.author.html.

  2. Fare clic su Agente predefinito (pubblicazione) per aprire l'agente di replica predefinito.

  3. Fai clic su Modifica per aprire la configurazione dell'agente.

  4. Nella scheda Impostazioni, aggiorna i campi seguenti:

    • Abilitato - verifica true
    • ID utente agente - Lascia vuoto questo campo

    Configurazione agente di replica - Impostazioni

  5. Nella scheda Trasporto, aggiorna i campi seguenti:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Utente - admin
    • Password - admin

    Configurazione agente di replica - Trasporto

  6. Fare clic su Ok per salvare la configurazione e abilitare l'agente di replica Predefinito.

  7. Ora puoi apportare modifiche ai contenuti nel servizio di authoring e pubblicarli nel servizio di pubblicazione.

Pubblica pagina

Modalità di avvio di Quickstart Jar

La 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, AEM non può essere modificato nel livello alternativo. A questo scopo, la cartella crx-Quickstart 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.

La 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 da AEM. Si consiglia di eseguire lo sviluppo locale principalmente sulla modalità di esecuzione predefinita dell'ambiente dev.

Le permutazioni disponibili sono le seguenti:

Nome file JAR Quickstart
Descrizione modalità
aem-author-p4502.jar
Come Autore in modalità di esecuzione Dev sulla porta 4502
aem-author_dev-p4502.jar
Come Autore in modalità di esecuzione Dev sulla porta 4502 (come aem-author-p4502.jar)
aem-author_stage-p4502.jar
Autore in modalità di esecuzione Gestione temporanea sulla porta 4502
aem-author_prod-p4502.jar
Come Autore in modalità di esecuzione Produzione sulla porta 4502
aem-publish-p4503.jar
Come pubblicare in modalità di esecuzione Dev sulla porta 4503
aem-publish_dev-p4503.jar
Come pubblicazione in modalità di esecuzione Dev sulla porta 4503 (come aem-publish-p4503.jar)
aem-publish_stage-p4503.jar
Come pubblicare in modalità di esecuzione staging sulla porta 4503
aem-publish_prod-p4503.jar
Come pubblicare in modalità di esecuzione Produzione sulla porta 4503

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

  • Porta 4502 utilizzata per il servizio AEM Author locale
  • Porta 4503 utilizzata per il servizio di pubblicazione AEM locale

La modifica di queste impostazioni potrebbe richiedere modifiche alle configurazioni di AEM SDK

Arresto di un runtime AEM locale

Per arrestare un runtime AEM locale, AEM Author o Publish, aprire la finestra della riga di comando utilizzata per avviare AEM Runtime e toccare Ctrl-C. Attendere l'arresto di AEM. Al termine del processo di arresto, è disponibile il prompt dei comandi.

Attività di configurazione runtime locale AEM facoltative

Quando aggiornare Quickstart Jar

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

WARNING
L’aggiornamento del file JAR Quickstart a una nuova versione richiede la sostituzione dell’intero ambiente di sviluppo locale, con conseguente perdita di codice, configurazione e contenuto negli archivi AEM locali. Assicurati che qualsiasi codice, configurazione o contenuto che non deve essere eliminato sia salvato in modo sicuro in Git o esportato dall’istanza AEM locale come Pacchetti AEM.

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

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

  1. Crea un pacchetto di contenuti dedicato a contenere contenuti di "esempio" per facilitare lo sviluppo e mantienilo in Git. Tutti i contenuti che devono essere mantenuti tramite gli aggiornamenti di AEM SDK verranno mantenuti in questo pacchetto e ridistribuiti dopo l’aggiornamento di AEM SDK.
  2. Utilizza oak-upgrade con la direttiva includepaths per copiare il contenuto dal precedente archivio AEM SDK al nuovo archivio AEM SDK.
  3. Esegui il backup di qualsiasi contenuto utilizzando Gestione pacchetti di AEM e i pacchetti di contenuti sul SDK AEM precedente, quindi reinstallali sul nuovo SDK AEM.

Ricorda che l’utilizzo degli approcci di cui sopra per mantenere il codice tra gli aggiornamenti di AEM SDK indica un anti-pattern di sviluppo. Il codice non monouso deve avere origine nell’IDE di sviluppo e fluire in AEM SDK 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 locale di AEM.

Risoluzione dei problemi - Fare doppio clic sul file JAR Quickstart

Questo perché AEM as a Cloud Service Quickstart Jar non supporta il doppio clic su Quickstart Jar per avviare AEM localmente. È invece necessario eseguire il file Jar da tale riga di comando.

Per avviare il servizio AEM Author, cd nella directory contenente il file JAR Quickstart ed eseguire il comando:

macOS
code language-shell 
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ java -jar aem-author-p4502.jar
Linux®
code language-shell 
$ java -jar aem-author-p4502.jar

In alternativa, per avviare il servizio AEM Publish, cd nella directory contenente il file Jar Quickstart ed eseguire il comando:

macOS
code language-shell 
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ java -jar aem-publish-p4503.jar
Linux®
code language-shell 
$ 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 Oracle Java™ 11 SDK, verifica che sia la versione attiva eseguendo il comando dalla riga di comando:

macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Risorse aggiuntive

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69