DocumentazioneAEMTutorial su AEMTutorial su AEM as a Cloud Service

Trovare e rimuovere le API obsolete in AEM as a Cloud Service

Last update: Fri Feb 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Principiante
  • Sviluppatore

Scopri come trovare e rimuovere le API obsolete in AEM as a Cloud Service.

Panoramica

Per garantire la sicurezza e le prestazioni dell’applicazione e continuare a distribuire il codice utilizzando le pipeline di Cloud Manager, rimuovi le API obsolete dal progetto.

In questo tutorial imparerai a trovare e rimuovere le API obsolete nel tuo ambiente AEM as a Cloud Service utilizzando il plug-in Maven di AEM Analyzer.

Notifiche sulle API obsolete

L’utilizzo delle API obsolete e l’attenzione per correggerle vengono segnalati regolarmente, esaminiamo alcuni esempi.

  • AEM as a Cloud Service Centro azioni ti notifica circa API obsolete nel tuo progetto.
    API obsolete nel Centro azioni

  • Il passaggio Scansione del codice nella pipeline di Cloud Manager riporta le API obsolete nel progetto. Controlla il report Dettagli download per visualizzare l'elenco completo delle API obsolete.
    API obsolete nellanalisi del codice

  • Il passaggio Preparazione artefatto nella pipeline di Cloud Manager riporta le API obsolete nel progetto, Registro download e cerca Avvisi analizzatore nel file di registro.

    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.

Come trovare API obsolete

Per trovare API obsolete nel progetto AEM as a Cloud Service, segui la procedura riportata di seguito.

  1. Usa il plug-in Maven più recente di AEM Analyzer

    Nel progetto AEM, utilizza la versione più recente del plug-in Maven di AEM Analyzer.

    • Nel pom.xml principale, la versione del plug-in è in genere dichiarata. Confronta la tua versione con l'ultima versione rilasciata.

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

    • Il plug-in verifica la disponibilità dell’ultima versione di AEM SDK. Usa la versione più recente di AEM SDK nel file pom.xml del tuo progetto. Questo aiuta a rendere visibili le API obsolete come avvisi 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 -->
...

    • Assicurarsi che il modulo all esegua il plug-in nella fase 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. Esegui una compilazione e verifica la presenza di avvisi

    Quando esegui mvn clean install, l'analizzatore segnala le API obsolete come [messaggi DI AVVISO] nell'output. Ad esempio:

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

    È facile ignorare questi messaggi quando ci si concentra sul successo o sul fallimento della build.

  3. Cancella l'elenco delle API obsolete

    Anche il passaggio precedente fornisce le stesse informazioni. Eseguire tuttavia la fase verify sul modulo all per visualizzare tutti i [MESSAGGI DI AVVISO] in un'unica posizione. Ad esempio:

    code language-shell 
    $ mvn clean verify -pl all

    I messaggi [WARNING] nell'output di compilazione elencano le API obsolete nel progetto.

Come rimuovere le API obsolete

AEM Analyzer segnala cosa è obsoleto e fornisce consigli su come correggerlo. Tuttavia, utilizza la tabella seguente per scegliere l’azione giusta e, quando hai bisogno di ulteriori dettagli, segui la documentazione collegata.

Strategia di correzione API obsoleta

Tipo di avviso analizzatore
Cosa indica
Azione consigliata
Riferimento
API AEM obsoleta
L’API deve essere rimossa da AEM as a Cloud Service
Sostituisci l’utilizzo con l’API pubblica supportata
Guida alla rimozione API
Pacchetto o classe AEM obsoleti
Il pacchetto o la classe non è più supportato
Refactoring del codice per utilizzare l'alternativa consigliata
API obsolete
Libreria di terze parti obsoleta
La libreria non sarà supportata negli SDK futuri
Aggiornare la dipendenza e l’utilizzo del refactoring
Linee guida generali
Pattern Sling/OSGi obsoleti
Annotazioni o API legacy rilevate
Migrare alle API Sling e OSGi moderne
Rimozione dei pattern Sling / OSGi
Rimozione pianificata (data futura)
L’API funziona ancora, ma la rimozione viene imposta in un secondo momento
Pianifica la pulizia prima dell’applicazione della pipeline
Note sulla versione

Indicazioni pratiche

  • Considera gli avvisi dell'analizzatore come errori futuri della pipeline, non come messaggi facoltativi.
  • Correggi le API obsolete localmente utilizzando la versione più recente di AEM SDK.
  • Mantenere pulito l’output dell’analizzatore per evitare problemi durante i futuri aggiornamenti di AEM.

La correzione anticipata delle API obsolete mantiene il progetto sicuro per l'aggiornamento e pronto per la distribuzione.

Risorse aggiuntive

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