설명서

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에서 다음과 유사한 특정 오류가 발생하지만 이 시작 수준에서 일치하는 기능을 제공하는 아티팩트가 없습니다.**
  • Java 버전 호환성이 필요한 Maven 실행 중에 추가 오류가 발생합니다.

해결 방법 resolution

Java 버전 21로 업그레이드할 때 발생하는 문제를 해결하려면 다음 단계를 따르십시오.

  1. 시작하지 못한 번들의 MANIFEST.MF파일을 검사합니다.

    • Bundle-RequiredExecutionEnvironment 헤더에서 올바른 Java 실행 환경을 지정하는지 확인하십시오(예: JavaSE-11). UNKNOWN ​이 표시되면 구성이 잘못되었거나 번들이 손상되었을 수 있습니다.

  2. 전이적 종속성을 포함한 모든 종속성이 Java 버전 21과 호환되는지 확인하십시오.

    • Java를 업그레이드하면 타사 라이브러리 또는 프레임워크에서 비호환성이 발생할 수 있습니다. 모든 종속성이 그에 따라 업데이트되었는지 확인하십시오.

  3. 빌드 구성 도구(예: Maven, Gradle)에서 Java 버전 21에 맞게 올바른 설정을 확인합니다.

    • 필요한 경우 배포 스크립트를 업데이트하여 Java 버전 또는 OSGi 컨테이너 설정의 변경 사항을 반영합니다.

  4. 파이프라인에서 사용하는 Git 저장소 분기에 .cloudmanager/java-version 파일을 만듭니다.

    • 21 ​만 포함되도록 이 파일을 편집하세요. 이렇게 하면 빌드 프로세스 중에 Oracle Java 21이 사용됩니다.

  5. 분기를 구성하고 설정을 업데이트한 후 구성된 분기를 사용하여 Cloud Manager의 DEV 파이프라인을 통해 유효성 검사 테스트를 실행합니다.

다음 단계를 수행하면 OSGi 환경 또는 Maven 구성과 관련된 빌드 오류가 발생하지 않고 Java 버전 21에서 사용할 수 있도록 AEM 환경을 성공적으로 업그레이드하고 구성할 수 있습니다.

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