DocumentationAEMTutoriels AEMTutoriels d’AEM as a Cloud Service

Recherche et suppression des API obsolètes dans AEM as a Cloud Service

Last update: Thu Feb 12 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Débutant
  • Développeur

Découvrez comment rechercher et supprimer des API obsolètes dans AEM as a Cloud Service.

Vue d’ensemble

AEM as a Cloud Service Centre d’actions vous informe de l’existence d’API obsolètes dans votre projet. Pour vous assurer que votre application est sécurisée et performante et que vous pouvez continuer à déployer du code à l’aide des pipelines de Cloud Manager, supprimez les API obsolètes de votre projet.

Dans ce tutoriel, vous apprendrez à rechercher et à supprimer des API obsolètes dans votre environnement AEM as a Cloud Service à l’aide du plug-in Maven AEM Analyzer.

Comment trouver des API obsolètes

Pour rechercher des API obsolètes dans votre projet AEM as a Cloud Service, procédez comme suit.

  1. Utiliser le dernier plug-in Maven d’AEM Analyzer

    Dans votre projet AEM, utilisez la dernière version du plug-in Maven AEM Analyzer.

    • Dans la pom.xml principale, la version du plug-in est généralement déclarée. Comparez votre version à la dernière version publiée.

      code language-xml 
      ...
<aemanalyser.version>1.6.14</aemanalyser.version> <!-- Latest released version as of 09-Feb-2026 -->
...
<!-- AEM Analyser Plugin -->
<plugin>
    <groupId>com.adobe.aem</groupId>
    <artifactId>aemanalyser-maven-plugin</artifactId>
    <version>${aemanalyser.version}</version>
    <extensions>true</extensions>
</plugin>
...

    • Le plug-in vérifie la dernière SDK AEM disponible. Utilisez la dernière version d’AEM SDK dans le fichier pom.xml de votre projet. Cela permet de faire apparaître les API obsolètes en tant qu’avertissements IDE.

      code language-xml 
      ...
<aem.sdk.api>2026.2.24288.20260204T121510Z-260100</aem.sdk.api> <!-- Latest available AEM SDK version as of 09-Feb-2026 -->
...

    • Assurez-vous que le module all exécute le module externe dans la phase 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>
...

  2. Exécutez une version et recherchez des avertissements

    Lorsque vous exécutez mvn clean install, l’analyseur signale les API obsolètes en tant que messages [AVERTISSEMENT] dans la sortie. Par exemple :

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

    Il est facile d’ignorer ces messages lorsque vous vous concentrez sur la réussite ou l’échec de la création.

  3. Obtenez une liste claire des API obsolètes

    L’étape ci-dessus fournit également les mêmes informations. Toutefois, exécutez la phase verify sur le module all pour afficher tous les messages [AVERTISSEMENT] au même endroit. Par exemple :

    code language-shell 
    $ mvn clean verify -pl all

    Les messages [AVERTISSEMENT] de la sortie de build répertorient les API obsolètes de votre projet.

Comment supprimer des API obsolètes

L’analyseur d’AEM signale quoi est obsolète et fournit la recommandation sur la manière de corriger le problème. Toutefois, utilisez le tableau ci-dessous pour choisir l’action appropriée et suivez la documentation associée si vous avez besoin de plus de détails.

Stratégie de remédiation d’API obsolète

Type d’avertissement de l’analyseur
Ce qu’il indique
Action recommandée
Référence
API AEM obsolète
API à supprimer d’AEM as a Cloud Service
Remplacer l’utilisation par l’API publique prise en charge
Guide de suppression des API
Package ou classe AEM obsolète
Le package ou la classe n’est plus pris en charge
Refactoriser le code pour utiliser l’alternative recommandée
​ API obsolètes ​
Bibliothèque tierce obsolète
La bibliothèque ne sera pas prise en charge dans les futurs SDK
Mise à niveau de la dépendance et utilisation de la refactorisation
Directives générales
Modèles Sling/OSGi obsolètes
Annotations ou API héritées détectées
Migration vers les API Sling et OSGi modernes
Suppression des modèles Sling/OSGi
Suppression prévue (date ultérieure)
L’API fonctionne toujours, mais la suppression est appliquée ultérieurement
Planifier le nettoyage avant l’application du pipeline
Notes de mise à jour

Conseils pratiques

  • Traiter les avertissements de l’analyseur comme futurs échecs de pipeline, et non comme des messages facultatifs.
  • Corrigez localement les API obsolètes à l’aide de la dernière version d’AEM SDK.
  • Gardez la sortie de l’analyseur propre pour éviter des problèmes lors des futures mises à niveau d’AEM.

Une correction précoce des API obsolètes permet de conserver votre projet sûr pour la mise à niveau et prêt pour le déploiement.

Ressources supplémentaires

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