DocumentazioneExperience Cloud KCS

AEM as a Cloud Service: il componente viene distribuito localmente ma non in Cloud a causa di una mancata corrispondenza delle versioni di SDK

Ultimo aggiornamento: 16 ottobre 2026

✨ Il contenuto è generato tramite IA e potrebbe non essere accurato. Termini di IA generativi

Questo articolo spiega perché un componente AEM personalizzato può essere distribuito correttamente su un SDK locale ma non viene visualizzato negli ambienti cloud, concentrandosi sulle mancate corrispondenze delle versioni di SDK e su come risolverle.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service
  • Versione SDK locale: 2026.3.*
  • Cloud SDK versione: 2026.8.*

Sintomi

  • Un componente personalizzato (ad esempio, conto alla rovescia) viene distribuito correttamente nell’istanza locale di AEM Cloud SDK.
  • Il componente non viene visualizzato dopo la distribuzione negli ambienti cloud.
  • Non vengono segnalati messaggi di errore specifici, ma il componente risulta mancante nell’ambiente cloud dopo l’esecuzione della pipeline.
  • L’implementazione locale funziona come previsto; l’implementazione cloud non include il componente.

Passaggi per riprodurre il problema

  1. Distribuisci il componente conto alla rovescia in un’istanza locale di AEM Cloud SDK (2026.3.*).
  2. Distribuisci lo stesso codebase in un ambiente Cloud utilizzando Cloud SDK (2026.8.*).
  3. Osserva che il componente è presente localmente ma non nell’ambiente cloud.

Causa

Una mancata corrispondenza tra le versioni SDK locale e cloud può causare discrepanze di distribuzione, spesso dovute a modifiche che causano interruzioni o incompatibilità introdotte nelle versioni SDK più recenti.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito.

  1. Assicurati che il componente personalizzato e le relative dipendenze siano compatibili con la versione di Cloud SDK (2026.8.*).
  2. Consulta le note sulla versione di AEM as a Cloud Service SDK per interrompere le modifiche tra 2026.3.e 2026.8..
  3. Conferma che il componente conto alla rovescia sia incluso nella base di codice e non sia escluso da alcun filtro di build o distribuzione (ad esempio in filter.xml).
  4. Verifica che il componente sia presente nel pacchetto generato (.zip o .jar) prima della distribuzione.
  5. Accedi ai registri di esecuzione della pipeline di Cloud Manager per individuare eventuali errori o avvisi relativi alla distribuzione dei componenti e cerca installazioni di pacchetti ignorate o non riuscite.
  6. Configura un’istanza AEM locale utilizzando la versione di Cloud SDK (2026.8.*) e tenta di distribuire il componente.
  7. Se il problema si riproduce localmente in 2026.8.*, esamina i problemi di compatibilità o dipendenza.
  8. Effettua il refactoring del componente o aggiornalo per risolvere eventuali problemi di compatibilità identificati con la nuova versione di SDK.
  9. Rigenera e ridistribuisci il pacchetto.

Dopo aver completato questi passaggi, verifica che il componente sia visualizzato nell’ambiente cloud.

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