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がレポートされます。ログをダウンロードし、ログファイルで Analyzerの警告 を探します。
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ビルド出力の[WARNING] メッセージは、プロジェクト内の非推奨APIの一覧です。
非推奨のAPIを削除する方法
AEM Analyzerは、whatが非推奨であると報告し、その修正方法について 推奨事項 を提供します。 ただし、以下の表を使用して適切なアクションを選択し、詳細が必要な場合はリンクされたドキュメントに従います。
非推奨のAPI修復戦略
実践的ガイダンス
- アナライザーの警告は、オプションのメッセージではなく、将来のパイプラインのエラーとして扱います。
- 非推奨のAPIをローカルで修正するには、最新のAEM SDKを使用します。
- 今後のAEMのアップグレード中に発生する問題を回避するために、アナライザー出力をクリーンに保ちます。
非推奨APIを早期に修正すると、プロジェクト アップグレードの安全性とデプロイメントの準備が維持されます。