文件

在AEMaaCS升級到Java版本21時出現問題 — Assets

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

嘗試升級至AEMaaCS適用的Java版本21時 — 發生Assets問題和組建失敗，請檢查套件組合設定、驗證相依性相容性、更新組建設定、設定Maven JDK版本以及執行驗證測試。

說明 description

環境

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

問題

嘗試升級至Adobe Experience Manager (AEM) as a Cloud Service - Assets適用的Java版本21時，會發生組建失敗。

  • 組建失敗，錯誤訊息指出遺失OSGi執行環境需求。
  • 發生類似下列的特定錯誤：開始層級20中的​ osgi.ee； filter：="(osgi.ee=UNKNOWN)"，但沒有任何成品在此開始層級中提供相符的功能。
  • Maven執行期間發生其他錯誤，需要Java版本相容性。

解決方法 resolution

若要解決升級至Java版本21時遇到的問題，請執行下列步驟：

  1. 檢查無法啟動的套件組合的MANIFEST.MF檔案。

    • 驗證Bundle-RequiredExecutionEnvironment標頭指定了有效的Java執行環境（例如： JavaSE-11）。 如果它顯示​ 未知，則可能是設定錯誤或組合損毀。

  2. 確保所有相依性（包括可傳遞的相依性）都與Java版本21相容。

    • 升級Java可能會導致協力廠商程式庫或架構不相容；請確認所有相依性均已據此更新。

  3. 檢查您的建置組態工具（例如：Maven、Gradle），以取得與Java版本21一致的正確設定。

    • 如有必要，請更新部署指令碼，以反映Java版本或OSGi容器設定中的變更。

  4. 在管道使用的Git存放庫分支中建立.cloudmanager/java-version檔案。

    • 編輯此檔案，使其僅包含​ 21。 這可確保在建置流程中使用Oracle Java 21。

  5. 在設定分支和更新設定後，請使用已設定的分支透過Cloud Manager的DEV管道執行驗證測試。

依照這些步驟，您應該能夠成功升級和設定您的AEM環境以與Java版本21搭配使用，而不會遇到與OSGi環境或Maven設定相關的組建錯誤。

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