Problemas al actualizar a la versión 21 de Java en AEMaaCS: Assets

Última actualización: 20 de marzo de 2025

Al intentar actualizar a la versión 21 de Java para AEMaaCS: se producen problemas de Assets y errores de compilación, compruebe la configuración del paquete, verifique la compatibilidad de dependencias, actualice la configuración de compilación, establezca la versión del JDK de Maven y ejecute pruebas de validación.

Descripción

Entorno

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

Problema

Se producen errores de compilación al intentar actualizar a Java versión 21 para Adobe Experience Manager (AEM) as a Cloud Service - Assets.

Errores de compilación con mensajes de error que indican que faltan requisitos del entorno de ejecución de OSGi.
Se producen errores específicos similares a: osgi.ee; filter:="(osgi.ee=UNKNOWN)" en el nivel de inicio 20, pero ningún artefacto está proporcionando una capacidad coincidente en este nivel de inicio.
Se producen errores adicionales durante la ejecución de Maven que requieren la compatibilidad con la versión de Java.

Resolución

Para resolver los problemas surgidos al actualizar a la versión 21 de Java, siga estos pasos:

Examine el MANIFEST.MF archivo del paquete que no se puede iniciar.
- Compruebe que el encabezado Bundle-RequiredExecutionEnvironment especifica un entorno de ejecución de Java válido (por ejemplo: JavaSE-11). Si muestra DESCONOCIDO, podría haber una configuración incorrecta o un paquete dañado.
Asegúrese de que todas las dependencias, incluidas las transitivas, sean compatibles con Java versión 21.
- La actualización de Java puede provocar incompatibilidades en bibliotecas o marcos de terceros; compruebe que todas las dependencias se actualicen en consecuencia.
Compruebe las herramientas de configuración de la versión (por ejemplo: Maven, Gradle) para obtener la configuración correcta alineada con la versión 21 de Java.
- Actualice los scripts de implementación, si es necesario, para reflejar los cambios en la versión de Java o la configuración del contenedor OSGi.
Cree un archivo .cloudmanager/java-version en la rama del repositorio Git que use la canalización.
- Edite este archivo para que contenga solamente 21. Esto garantiza que Oracle Java 21 se utilice durante el proceso de compilación.
Después de configurar la rama y actualizar la configuración, ejecute las pruebas de validación a través de la canalización de DEV de Cloud Manager usando la rama configurada.

Al seguir estos pasos, debería poder actualizar y configurar correctamente su entorno de AEM para utilizarlo con Java versión 21 sin encontrar errores de compilación relacionados con entornos OSGi o configuraciones de Maven.

recommendation-more-help