설명서Experience Cloud KCS

AEM Sites: 사용자 지정 열에 PageInfoProvider를 사용할 때 더 이상 사용되지 않는 org.apache.sling.commons.json.JSONObject 경고

마지막 업데이트: 2026년 8월 1일

이 문서에서는 PageInfoProvider을(를) 사용하여 AEM Sites 목록 보기 열을 사용자 지정할 때 org.apache.sling.commons.json.JSONObject과(와) 관련된 더 이상 사용되지 않는 API 경고의 원인 및 현재 영향에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager(AEM) as a Cloud Service(모든 버전)

문제/증상

PageInfoProvider 인터페이스를 사용하여 AEM Sites 콘솔 목록 보기에서 사용자 지정 열을 구현하는 경우 다음 경고가 로그에 표시됩니다.

2023-02-23 18:47:55.095 [ region-deprecated-api]  com.xx.aem:xx-unified-site.core:0.0.2-SNAPSHOT: Usage of deprecated package found : org.apache.sling.commons.json : Usage of this deprecated API is not supported in AEM as a Cloud Service. Deprecated since 2022-12-31 For removal : 2027-12-31 (com.xx.aem:xx-unified-site.all:0.0.2-SNAPSHOT)
  • PageInfoProvider API 계약에 org.apache.sling.commons.json.JSONObject을(를) 반환해야 하므로 경고가 트리거됩니다.
  • org.apache.sling.commons.json 패키지는 더 이상 사용되지 않으며 2027-12-31 이후에 제거될 예정입니다.
  • 이러한 경고는 정보 제공용이므로 사용이 PageInfoProvider 구현으로 제한된 경우 현재 Cloud Manager 파이프라인을 차단하지 않습니다.

원인

현재 PageInfoProvider 인터페이스에서 org.apache.sling.commons.json.JSONObject을(를) 반환해야 하므로 더 이상 사용되지 않는 패키지를 사용해야 합니다. 이는 기술적 부채로 간주되며 향후 AEM Sites API 업데이트에서 해결될 예정입니다.

해결 방법 resolution

아래 단계에 따라 문제를 해결하십시오.

  1. 로그 경고를 검토하여 PageInfoProvider 및 org.apache.sling.commons.json.JSONObject 종속성의 사용과 관련이 있는지 확인하십시오.

  2. 현재 이러한 경고는 정보만이며 배포를 차단하거나 Sites 콘솔에서 사용자 지정 열의 기능에 영향을 주지 않습니다.

  3. 사용 중단 및 org.apache.sling.commons.json 제거와 관련된 업데이트에 대해서는 Adobe Experience Manager 릴리스 노트 및 설명서를 모니터링하십시오.

  4. 향후 사용자 정의 열 구현을 리팩터링할 계획:

    • Adobe 엔지니어링에서 현재 PageInfoProvider 인터페이스를 사용하지 않는 작업을 하고 있습니다.
    • org.apache.sling.commons.json이(가) 필요하지 않은 새 인터페이스는 향후 릴리스에 도입되고 문서화됩니다.

  5. 더 이상 사용되지 않는 API가 PageInfoProvider 컨텍스트 외부에서 사용되지 않거나 향후 릴리스에 새로운 변경 사항이 적용되는 경우 즉각적인 작업은 필요하지 않습니다.

recommendation-more-help
experience-cloud-kcs-help-kbarticles