DokumentationAEMAEM-TutorialsTutorials zu AEM as a Cloud Service

Suchen und Entfernen veralteter APIs in AEM as a Cloud Service

Last update: Fri Feb 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Einsteiger
  • Entwickler

Erfahren Sie, wie Sie veraltete APIs in AEM as a Cloud Service finden und entfernen.

Übersicht

Um sicherzustellen, dass Ihre Anwendung sicher und leistungsfähig ist und Sie Code mithilfe von Cloud Manager-Pipelines weiter bereitstellen können, entfernen Sie veraltete APIs aus Ihrem Projekt.

In diesem Tutorial erfahren Sie, wie Sie veraltete APIs in Ihrer AEM as a Cloud Service-Umgebung mithilfe des AEM Analyzer Maven-Plug-ins} suchen und ​.

Benachrichtigungen zu veralteten APIs

Die veraltete API-Nutzung und die Aufmerksamkeit, die darauf verwendet wird, sie zu beheben, werden regelmäßig gemeldet. Sehen wir uns einige Beispiele an.

  • AEM as a Cloud Service Aktionszentrum benachrichtigt Sie über veraltete APIs in Ihrem Projekt.
    Veraltete APIs im Aktionscenter

  • Im Schritt Codescan in der Cloud Manager-Pipeline werden veraltete APIs in Ihrem Projekt gemeldet. Überprüfen Sie den Bericht Details herunterladen, um die vollständige Liste der veralteten APIs anzuzeigen.
    Veraltete APIs beim Code-Scanning

  • Im Schritt Artefaktvorbereitung in der Cloud Manager-Pipeline werden veraltete APIs in Ihrem Projekt Protokoll herunterladen und in der Protokolldatei nach Analyzer Warnungen gesucht.

    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.

So finden Sie veraltete APIs

Führen Sie diese Schritte aus, um veraltete APIs in Ihrem AEM as a Cloud Service-Projekt zu finden.

  1. Verwenden Sie das neueste AEM Analyzer Maven-Plug-in

    Verwenden Sie in Ihrem AEM-Projekt die neueste Version des AEM Analyzer Maven-Plug-ins.

    • Im pom.xml wird die Plug-in-Version normalerweise deklariert. Vergleichen Sie Ihre Version mit der neuesten veröffentlichten Version.

      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>
...

    • Das Plug-in vergleicht mit der neuesten verfügbaren AEM SDK. Verwenden Sie die neueste AEM SDK-Version in der pom.xml Ihres Projekts. Dies hilft, veraltete APIs als IDE-Warnungen darzustellen.

      code language-xml 
      ...
<aem.sdk.api>2026.2.24464.20260214T050318Z-260100</aem.sdk.api> <!-- Latest available AEM SDK version as of 20-Feb-2026 -->
...

    • Stellen Sie sicher, dass das all-Modul das Plug-in in der verify Phase ausführt.

      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>
...

  2. Führen Sie einen Build aus und überprüfen Sie auf Warnungen

    Wenn Sie mvn clean install ausführen, meldet der Analyzer veraltete APIs als [WARNUNG]-Meldungen in der Ausgabe. Zum Beispiel:

    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)
...

    Es ist einfach, diese Meldungen zu übersehen, wenn man sich auf den Erfolg oder Misserfolg eines Builds konzentriert.

  3. Erhalten Sie eine klare Liste veralteter APIs

    Der obige Schritt enthält auch dieselben Informationen. Führen Sie jedoch die verify Phase auf dem all aus, um alle [WARNUNG]-Meldungen an einem Ort anzuzeigen. Zum Beispiel:

    code language-shell 
    $ mvn clean verify -pl all

    Die [WARNUNG]-Meldungen in der Build-Ausgabe führen die veralteten APIs in Ihrem Projekt auf.

Entfernen veralteter APIs

Der AEM Analyzer meldet Was als veraltet und bietet die Empfehlung zur Fehlerbehebung. Verwenden Sie jedoch die nachstehende Tabelle, um die richtige Aktion auszuwählen, und folgen Sie der verknüpften Dokumentation, wenn Sie weitere Details benötigen.

Veraltete API-Korrekturstrategie

Warnungstyp des Analyzers
Was es anzeigt
Empfohlene Aktion
Verweis
Veraltete AEM-API
API muss aus AEM as a Cloud Service entfernt werden
Ersetzen der Verwendung durch die unterstützte öffentliche API
API-Entfernungsanleitung
Veraltetes AEM-Paket oder veraltete Klasse
Paket oder Klasse wird nicht mehr unterstützt
Code zur Verwendung der empfohlenen Alternative umgestalten
Veraltete APIs
Veraltete Drittanbieterbibliothek
Bibliothek wird in zukünftigen SDKs nicht unterstützt
Aktualisieren der Abhängigkeit und Refaktorierung der Nutzung
Allgemeine Richtlinien
Veraltete Sling-/OSGi-Muster
Alte Anmerkungen oder APIs erkannt
Migrieren zu modernen Sling- und OSGi-APIs
Entfernen von Sling-/OSGi-Mustern
Geplante Entfernung (Datum in der Zukunft)
Die API funktioniert weiterhin, aber die Entfernung wird später erzwungen
Planen der Bereinigung vor der Pipeline-Durchsetzung
Versionshinweise

Praktische Leitlinien

  • Analyzer-Warnungen als zukünftige Pipeline-Fehler behandeln, nicht als optionale Nachrichten.
  • Korrigieren Sie veraltete APIs lokal mit neuesten AEM SDK.
  • Halten Sie die Analyzer-Ausgabe sauber, um Probleme bei zukünftigen AEM-Upgrades zu vermeiden.

Durch die frühzeitige Behebung veralteter APIs bleibt Ihr Projekt sicher und bereitstellungsbereit.

Zusätzliche Ressourcen

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69