Probleme beim Upgrade auf Java Version 21 in AEMaaCS - Assets
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:
-
Untersuchen Sie die
MANIFEST.MF
Datei 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.
- Überprüfen Sie, ob der
-
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.
-
Ü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.
-
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.
-
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.