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 プラグインの最新バージョンを使用し す。
-
メイン
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フェーズを実行すると、すべての [警告] メッセージが 1 か所で表示されます。 例：code language-shell $ mvn clean verify -pl allビルド出力の [警告] メッセージには、プロジェクト内の非推奨（廃止予定）の API が一覧表示されます。
非推奨 API を削除する方法
AEM Analyzer は、非推奨となった 対象 をレポートし、その修正方法に関する 推奨事項 を提供します。 ただし、以下の表を使用して適切なアクションを選択し、詳細が必要な場合はリンク先のドキュメントに従ってください。
非推奨（廃止予定）の API 修復戦略
実践指導
- アナライザーの警告を、オプションのメッセージではなく、今後のパイプラインの失敗 として扱う。
- 最新のAEM SDK を使用して、非推奨（廃止予定）の API をローカルで修正しました。
- 今後のAEMのアップグレード中に発生する問題を回避するために、アナライザーの出力をクリーンに保ちます。
非推奨 API を早期に修正することで、プロジェクトを アップグレードしても安全で、デプロイメントに対応 できます。