DocumentazioneExperience Cloud KCS

Aggiornamento della versione standard di aem.js in Adobe Experience Manager as a Cloud Service

Ultimo aggiornamento: 25 ottobre 2026

Questo articolo fornisce indicazioni per aggiornare la versione standard di aem.js in Adobe Experience Manager as a Cloud Service, evidenziando considerazioni sulla compatibilità, l’impatto sui flussi di lavoro e le best practice consigliate.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (tutte le versioni), aem.js boilerplate v3.0.0-v3.1.8

Problema/Sintomi

  • Si desidera incorporare le modifiche a monte a aem.js in un progetto esistente.
  • Prima di unire le modifiche, è necessario controllare gli effetti su blocchi personalizzati, script, anteprima o pubblicazione.

Causa

Il boilerplate di AEM è un progetto iniziale. Le modifiche apportate alla boilerplate a monte non aggiornano automaticamente un progetto esistente; gli sviluppatori esaminano e integrano le modifiche nel loro archivio di progetto. Il comportamento specifico del progetto appartiene a estensioni esterne a aem.js, non a modifiche locali della libreria.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Rivedi le modifiche introdotte nella boilerplate aem.js tra le versioni 3.0.0 e 3.1.8.

  2. Verificare se l’implementazione utilizza la versione 3.1.0. Questa versione introduce una modifica che rimuove la gestione dei metadati della sezione da decorateSections(). La modifica è stata identificata come regressione ed è stata ripristinata nella versione 3.1.1.

  3. Se l’implementazione utilizza la versione 3.1.0, eseguire l’aggiornamento alla versione 3.1.1 o successiva per ripristinare la gestione dei metadati della sezione.

  4. Esaminare le modifiche introdotte nelle versioni da 3.1.1 a 3.1.8. Queste versioni includono aggiornamenti delle dipendenze e correzioni minori, come la risoluzione di blocchi di intestazione e piè di pagina duplicati e l’aggiornamento della risoluzione del percorso del codice.

  5. Valuta l’impatto sull’implementazione e verifica che nessuna modifica rilevante influisca sui flussi di lavoro di pubblicazione, anteprima o rendering di blocchi. A parte la regressione nella versione 3.1.0, in questi flussi di lavoro non sono state identificate modifiche che causano interruzioni.

  6. Convalidare le modifiche in un ramo di funzionalità prima dell’aggiornamento. Configura il ramo in modo che utilizzi un ambiente di anteprima e rivedi le modifiche dopo il push del codice aggiornato.

  7. Verifica le modifiche localmente prima di pubblicarle. Utilizza AEM CLI per recuperare i contenuti e convalidare gli aggiornamenti. I seguenti comandi possono essere utili per rivedere le modifiche prima di pubblicarle:

    code language-none 
    aem content clone
aem up
aem content diff
aem content push --dry-run

  8. Configurare le regole di protezione dei rami per il ramo principale e richiedere richieste pull, controlli dello stato e rami aggiornati prima di unire le modifiche. Questo consente di garantire che tutte le modifiche vengano riviste e convalidate in un ambiente di anteprima prima di raggiungere la fase di produzione.

  9. Dopo l’upgrade, verifica accuratamente i blocchi personalizzati e le dipendenze degli script sia negli ambienti locali che in quelli di anteprima per verificarne la compatibilità.

  10. Verifica che la pubblicazione, l’anteprima, il rendering dei blocchi, la gestione dei metadati di sezione, i blocchi personalizzati e le dipendenze degli script funzionino come previsto dopo l’aggiornamento.

recommendation-more-help
experience-cloud-kcs-help-kbarticles