Problem med att uppgradera till Java version 21 i AEMaaCS - Assets

Senast uppdaterad: 20 mars 2025

När du försöker uppgradera till Java version 21 för AEMaaCS - Assets-problem och fel uppstår vid bygge kontrollerar du paketkonfigurationen, kontrollerar beroendekompatibilitet, uppdaterar byggkonfigurationen, ställer in Maven JDK-versionen och kör valideringstester.

Beskrivning

Miljö

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

Problem

När du försöker uppgradera till Java version 21 för Adobe Experience Manager (AEM) as a Cloud Service - Assets inträffar fel vid bygge.

Bygg fel med felmeddelanden som indikerar att systemkrav saknas för körning.
Specifika fel inträffar som: osgi.ee; filter:="(osgi.ee=UNKNOWN)" på startnivå 20, men ingen artefakt har matchande funktioner på den här startnivån.
Ytterligare fel inträffar under körningen av Maven som kräver Java-versionskompatibilitet.

Upplösning

Följ de här stegen för att lösa problem som uppstår när du uppgraderar till Java version 21:

Undersök filen MANIFEST.MF för paketet som inte kan startas.
- Kontrollera att rubriken Bundle-RequiredExecutionEnvironment anger en giltig Java-körningsmiljö (till exempel: JavaSE-11). Om UNKNOWN visas kan det finnas en felaktig konfiguration eller ett skadat paket.
Kontrollera att alla beroenden, inklusive transitiva, är kompatibla med Java version 21.
- Uppgradering av Java kan leda till inkompatibilitet i tredjepartsbibliotek eller ramverk. Kontrollera att alla beroenden har uppdaterats därefter.
Kontrollera verktygen för byggkonfiguration (t.ex. Maven, Gradle) för korrekta inställningar som är anpassade till Java version 21.
- Uppdatera distributionsskript, om det behövs, för att återspegla ändringar i inställningarna för Java-versionen eller OSGi-behållaren.
Skapa en .cloudmanager/java-version-fil i din Git-databasgren som används av pipeline.
- Redigera den här filen så att den bara innehåller 21. Detta garanterar att Oracle Java 21 används under byggprocessen.
När du har konfigurerat grenen och uppdaterat inställningarna kör du dina valideringstester via Cloud Manager DEV-pipeline med den konfigurerade grenen.

Med dessa steg bör du kunna uppgradera och konfigurera din AEM-miljö så att den kan användas med Java version 21 utan att stöta på byggfel relaterade till OSGi-miljöer eller Maven-konfigurationer.

recommendation-more-help