Dokumentation

Probleme beim Upgrade auf Java Version 21 in AEMaaCS - Assets

Letzte Aktualisierung: 20. März 2025

Wenn Sie versuchen, auf Java Version 21 für AEMaaCS zu aktualisieren - Assets-Problem und Build-Fehler auftreten, überprüfen Sie die Bundle-Konfiguration, überprüfen Sie die Kompatibilität der Abhängigkeiten, aktualisieren Sie die Build-Konfiguration, legen Sie die Maven-JDK-Version fest und führen Sie Validierungstests durch.

Beschreibung

Umgebung

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

Problem

Beim Versuch, auf Java Version 21 für Adobe Experience Manager (AEM) as a Cloud Service - Assets zu aktualisieren, treten Build-Fehler auf.

  • Build-Fehler mit Fehlermeldungen, die auf fehlende Anforderungen an die OSGi-Ausführungsumgebung hinweisen.
  • Spezifische Fehler treten ähnlich wie: osgi.ee; filter:=„(osgi.ee=UNKNOWN)“ in Startebene 20 auf, aber kein Artefakt bietet eine entsprechende Funktion in dieser Startebene.
  • Bei der Ausführung von Maven treten zusätzliche Fehler auf, die die Kompatibilität der Java-Versionen erfordern.

Auflösung

Gehen Sie wie folgt vor, um die beim Upgrade auf Java Version 21 aufgetretenen Probleme zu beheben:

  1. Untersuchen Sie die MANIFEST.MFDatei des Bundles, das nicht gestartet werden kann.

    • Überprüfen Sie, ob der Bundle-RequiredExecutionEnvironment-Header eine gültige Java-Ausführungsumgebung angibt (z. B.: JavaSE-11). Wenn die Meldung UNBEKANNT angezeigt wird, kann es zu einer Fehlkonfiguration oder einem beschädigten Bundle kommen.
  2. Stellen Sie sicher, dass alle Abhängigkeiten, einschließlich transitiver Abhängigkeiten, mit Java Version 21 kompatibel sind.

    • Ein Upgrade von Java kann zu Inkompatibilitäten in Bibliotheken oder Frameworks von Drittanbietern führen. Überprüfen Sie, ob alle Abhängigkeiten entsprechend aktualisiert werden.
  3. Überprüfen Sie Ihre Build-Konfigurations-Tools (z. B.: Maven, Gradle) auf korrekte Einstellungen, die mit Java Version 21 abgestimmt sind.

    • Aktualisieren Sie bei Bedarf Bereitstellungsskripte, um Änderungen an den Einstellungen für die Java-Version oder den OSGi-Container widerzuspiegeln.
  4. Erstellen Sie eine .cloudmanager/java-version Datei in der von der Pipeline verwendeten Git-Repository-Verzweigung.

    • Bearbeiten Sie diese Datei so, dass sie nur 21 enthält. Dadurch wird sichergestellt, dass Oracle Java 21 während des Build-Prozesses verwendet wird.
  5. Nachdem Sie die Verzweigung konfiguriert und die Einstellungen aktualisiert haben, führen Sie Ihre Validierungstests über die DEV-Pipeline von Cloud Manager mithilfe der konfigurierten Verzweigung durch.

Wenn Sie diese Schritte befolgen, sollten Sie in der Lage sein, Ihre AEM-Umgebung erfolgreich für die Verwendung mit Java Version 21 zu aktualisieren und zu konfigurieren, ohne Build-Fehler im Zusammenhang mit OSGi-Umgebungen oder Maven-Konfigurationen zu bemerken.

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