Documentazione

Problemi durante l’aggiornamento a Java versione 21 in AEMaaCS - Assets

Last update: Thu Mar 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Quando si verifica un problema e si verificano errori di build durante il tentativo di eseguire l’aggiornamento a Java versione 21 per AEMaaCS - Assets, controlla la configurazione del bundle, verifica la compatibilità delle dipendenze, aggiorna la configurazione della build, imposta la versione JDK di Maven ed esegui i test di convalida.

Descrizione

Ambiente

Adobe Experience Manager as a Cloud Service - Assets (AEMaaCS - Assets)

Problema

Quando si tenta di eseguire l’aggiornamento a Java versione 21 per Adobe Experience Manager (AEM) as a Cloud Service - Assets, si verificano errori di build.

  • Errori di build con messaggi di errore che indicano requisiti dell’ambiente di esecuzione OSGi mancanti.
  • Errori specifici sono simili a: osgi.ee; filter:="(osgi.ee=UNKNOWN)" nel livello 20, ma nessun artefatto fornisce una funzionalità corrispondente in questo livello iniziale.
  • Durante l’esecuzione di Maven si verificano ulteriori errori che richiedono la compatibilità della versione Java.

Risoluzione

Per risolvere i problemi riscontrati durante l’aggiornamento a Java versione 21, effettua le seguenti operazioni:

  1. Esamina il file MANIFEST.MF del bundle che non si avvia correttamente.

    • Verificare che l'intestazione Bundle-RequiredExecutionEnvironment specifichi un ambiente di esecuzione Java valido, ad esempio JavaSE-11. Se viene visualizzato SCONOSCIUTO, potrebbe essersi verificato un errore di configurazione o un bundle danneggiato.
  2. Assicurati che tutte le dipendenze, comprese quelle transitive, siano compatibili con Java versione 21.

    • L’aggiornamento di Java può causare incompatibilità in librerie o framework di terze parti; verifica che tutte le dipendenze siano aggiornate di conseguenza.
  3. Controlla gli strumenti di configurazione della build (ad esempio: Maven, Gradle) per informazioni sulle impostazioni corrette allineate con Java versione 21.

    • Se necessario, aggiorna gli script di distribuzione per riflettere le modifiche nella versione Java o nelle impostazioni del contenitore OSGi.
  4. Crea un file .cloudmanager/java-version nel ramo dell'archivio Git utilizzato dalla pipeline.

    • Modificare il file in modo che contenga solo 21. In questo modo Oracle Java 21 viene utilizzato durante il processo di creazione.
  5. Dopo aver configurato il ramo e aver aggiornato le impostazioni, esegui i test di convalida tramite la pipeline DEV di Cloud Manager utilizzando il ramo configurato.

Seguendo questi passaggi, dovresti essere in grado di aggiornare e configurare correttamente l’ambiente AEM per l’utilizzo con Java versione 21 senza riscontrare errori di build relativi agli ambienti OSGi o alle configurazioni Maven.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f