Documentation

Problèmes de mise à niveau vers Java version 21 dans AEMaaCS - Assets

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

Assets Lors de la tentative de mise à niveau vers Java version 21 pour AEMaaCS - Un problème se produit et des échecs de build se produisent, vérifiez la configuration du lot, vérifiez la compatibilité des dépendances, mettez à jour la configuration de build, définissez la version du JDK Maven et exécutez des tests de validation.

Description description

Environnement

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

Problème

Lors de la tentative de mise à niveau vers Java version 21 pour Adobe Experience Manager (AEM) as a Cloud Service - Assets, des échecs de build se produisent.

  • Échec de création avec des messages d’erreur indiquant les exigences d’environnement d’exécution OSGi manquantes.
  • Des erreurs spécifiques se produisent comme suit : osgi.ee ; filter:=« (osgi.ee=UNKNOWN) » dans le niveau de départ 20, mais aucun artefact ne fournit de fonctionnalité correspondante dans ce niveau de départ.
  • D’autres erreurs se produisent lors de l’exécution de Maven nécessitant la compatibilité des versions Java.

Résolution resolution

Pour résoudre les problèmes rencontrés lors de la mise à niveau vers Java version 21, procédez comme suit :

  1. Examinez le fichier MANIFEST.MF du lot qui ne parvient pas à démarrer.

    • Vérifiez que l’en-tête Bundle-RequiredExecutionEnvironment spécifie un environnement d’exécution Java valide (par exemple : JavaSE-11). S’il affiche INCONNU, il peut y avoir une mauvaise configuration ou un lot corrompu.

  2. Assurez-vous que toutes les dépendances, y compris les dépendances transitives, sont compatibles avec Java version 21.

    • La mise à niveau de Java peut entraîner des incompatibilités dans les bibliothèques ou structures tierces. Vérifiez que toutes les dépendances sont mises à jour en conséquence.

  3. Vérifiez vos outils de configuration de build (par exemple : Maven, Gradle) pour obtenir les paramètres corrects alignés avec Java version 21.

    • Mettez à jour les scripts de déploiement, si nécessaire, pour refléter les modifications apportées aux paramètres de la version Java ou du conteneur OSGi.

  4. Créez un fichier .cloudmanager/java-version dans la branche de référentiel Git utilisée par le pipeline.

    • Modifiez ce fichier afin qu’il contienne uniquement 21. Cela permet de s’assurer qu’Oracle Java 21 est utilisé pendant le processus de création.

  5. Après avoir configuré la branche et mis à jour les paramètres, exécutez vos tests de validation via le pipeline de développement de Cloud Manager à l’aide de la branche configurée.

En suivant ces étapes, vous devriez être en mesure de mettre à niveau et de configurer votre environnement AEM pour une utilisation avec Java version 21 sans rencontrer d’erreurs de build liées aux environnements OSGi ou aux configurations Maven.

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