AEM as a Cloud Service에서 더 이상 사용되지 않는 API 찾기 및 제거
AEM as a Cloud Service에서 더 이상 사용되지 않는 API를 찾고 제거하는 방법에 대해 알아봅니다.
개요
애플리케이션이 안전하고 성능이 보장되며 Cloud Manager 파이프라인을 사용하여 코드를 계속 배포할 수 있도록 프로젝트에서 더 이상 사용되지 않는 API를 제거하십시오.
이 자습서에서는 AEM Analyzer Maven 플러그인을 사용하여 AEM as a Cloud Service 환경에서 더 이상 사용되지 않는 API를 찾고 제거하는 방법을 알아봅니다.
더 이상 사용되지 않는 API에 대한 알림
더 이상 사용되지 않는 API 사용 및 문제 해결에 대한 주의가 정기적으로 보고됩니다. 몇 가지 예를 살펴보겠습니다.
-
AEM as a Cloud Service 작업 센터에서 프로젝트의 _더 이상 사용되지 않는 API_에 대해 알려 줍니다.
-
Cloud Manager 파이프라인의 코드 스캔 단계는 프로젝트에서 더 이상 사용되지 않는 API를 보고합니다. 다운로드 세부 정보 보고서를 검토하여 더 이상 사용되지 않는 API의 전체 목록을 확인하십시오.
-
Cloud Manager 파이프라인의 아티팩트 준비 단계는 프로젝트에서 더 이상 사용되지 않는 API를 보고합니다. 로그 다운로드 및 로그 파일에서 분석기 경고를 찾으십시오.
code language-none 2026-02-20 15:40:48.376 Analyser warnings have been found 2026-02-20 15:40:48.376 The analyser found the following warnings for author and publish : 2026-02-20 15:40:48.376 [region-deprecated-api] com.adobe.aem.guides:aem-guides-wknd.core:4.0.5-SNAPSHOT: Usage of deprecated package found : org.apache.commons.lang : Commons Lang 2 is in maintenance mode. Commons Lang 3 should be used instead. Deprecated since 2021-04-30 For removal : 2021-12-31 (com.adobe.aem.guides:aem-guides-wknd.all:4.0.5-SNAPSHOT) 2026-02-20 15:40:56.458 Convert Merge Analyse finished.
더 이상 사용되지 않는 API를 찾는 방법
AEM as a Cloud Service 프로젝트에서 더 이상 사용되지 않는 API를 찾으려면 다음 단계를 따르십시오.
-
최신 AEM Analyzer Maven 플러그인 사용
AEM 프로젝트에서 AEM Analyzer Maven Plugin의 최신 버전을 사용합니다.
-
기본
pom.xml에서 플러그 인 버전은 일반적으로 선언됩니다. 버전을 최신 릴리스 버전과(와) 비교합니다.code language-xml ... <aemanalyser.version>1.6.16</aemanalyser.version> <!-- Latest released version as of 20-Feb-2026 --> ... <!-- AEM Analyser Plugin --> <plugin> <groupId>com.adobe.aem</groupId> <artifactId>aemanalyser-maven-plugin</artifactId> <version>${aemanalyser.version}</version> <extensions>true</extensions> </plugin> ... -
플러그인은 사용 가능한 최신 AEM SDK에 대해 확인합니다. 프로젝트의
pom.xml파일에서 최신 AEM SDK 버전을 사용합니다. 더 이상 사용되지 않는 API를 IDE 경고로 표시하는 데 도움이 됩니다.code language-xml ... <aem.sdk.api>2026.2.24464.20260214T050318Z-260100</aem.sdk.api> <!-- Latest available AEM SDK version as of 20-Feb-2026 --> ... -
all모듈이verify단계에서 플러그인을 실행하는지 확인하십시오.code language-xml ... <build> <plugins> ... <plugin> <groupId>com.adobe.aem</groupId> <artifactId>aemanalyser-maven-plugin</artifactId> <extensions>true</extensions> <executions> <execution> <id>analyse-project</id> <phase>verify</phase> <goals> <goal>project-analyse</goal> </goals> </execution> </executions> </plugin> ... </plugins> </build> ...
-
-
빌드 실행 및 경고 확인
mvn clean install을(를) 실행하면 분석기가 사용 중단된 API를 출력에서 [경고] 메시지로 보고합니다. 예:code language-shell ... [WARNING] The analyser found the following warnings for author and publish : [WARNING] [region-deprecated-api] com.adobe.aem.guides:aem-guides-wknd.core:4.0.5-SNAPSHOT: Usage of deprecated package found : org.apache.commons.lang : Commons Lang 2 is in maintenance mode. Commons Lang 3 should be used instead. Deprecated since 2021-04-30 For removal : 2021-12-31 (com.adobe.aem.guides:aem-guides-wknd.all:4.0.5-SNAPSHOT) ...빌드 성공 또는 실패에 초점을 맞출 때 이러한 메시지를 간과하기 쉽습니다.
-
더 이상 사용되지 않는 API의 명확한 목록 가져오기
위의 단계 또한 동일한 정보를 제공합니다. 그러나
verify모듈에서all단계를 실행하여 모든 [WARNING] 메시지를 한 곳에서 봅니다. 예:code language-shell $ mvn clean verify -pl all빌드 출력의 [WARNING] 메시지는 프로젝트에서 더 이상 사용되지 않는 API를 나열합니다.
더 이상 사용되지 않는 API를 제거하는 방법
AEM 분석기는 what이(가) 더 이상 사용되지 않음을 보고하고 이를 수정하는 방법에 대해 권장 사항을 제공합니다. 그러나 아래 표를 사용하여 올바른 작업을 선택하고 자세한 내용이 필요한 경우 연결된 설명서를 따르십시오.
사용되지 않는 API 업데이트 관리 전략
실용적인 지침
- 분석기 경고를 선택적 메시지가 아닌 향후 파이프라인 실패(으)로 처리합니다.
- 최신 AEM SDK를 사용하여 로컬에서 더 이상 사용되지 않는 API를 수정합니다.
- 향후 AEM 업그레이드 시 문제가 발생하지 않도록 분석기 출력을 깔끔하게 유지합니다.
더 이상 사용되지 않는 API를 조기에 수정하면 프로젝트 업그레이드에 안전하고 배포 준비가 된 상태로이(가) 유지됩니다.