Söka efter och ta bort inaktuella API:er i AEM as a Cloud Service

Lär dig hur du söker efter och tar bort inaktuella API:er i AEM as a Cloud Service.

Ökning

AEM as a Cloud Service Actions Center meddelar dig om inaktuella API:er i ditt projekt. Ta bort inaktuella API:er från ditt projekt för att vara säker och effektiv och för att du ska kunna fortsätta att distribuera kod med Cloud Manager-pipelines.

I den här självstudiekursen får du lära dig att hitta och ta bort inaktuella API:er i din AEM as a Cloud Service-miljö med AEM Analyser Maven Plugin.

Söka efter föråldrade API:er

Följ de här stegen för att hitta inaktuella API:er i ditt AEM as a Cloud Service-projekt.

  1. Använd den senaste AEM Analyser Maven Plugin

    Använd den senaste versionen av AEM Analyser Maven Plugin i ditt AEM-projekt.

    • I huvudversionen pom.xml deklareras vanligtvis plugin-versionen. Jämför din version med den senaste versionen.

      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>
      ...
      
    • Plugin-programmet kontrollerar mot den senaste tillgängliga AEM SDK. Använd den senaste AEM SDK-versionen i projektfilen pom.xml. Det hjälper till att identifiera de borttagna API:erna som IDE-varningar.

      code language-xml
      ...
      <aem.sdk.api>2026.2.24288.20260204T121510Z-260100</aem.sdk.api> <!-- Latest available AEM SDK version as of 09-Feb-2026 -->
      ...
      
    • Kontrollera att modulen all kör plugin-programmet i fasen 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. Kör ett bygge och sök efter varningar

    När du kör mvn clean install rapporterar analyseraren inaktuella API:er som [VARNING] -meddelanden i utdata. Till exempel:

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

    Det är enkelt att bortse från de här meddelandena när man fokuserar på framgångar eller misslyckanden i byggprocessen.

  3. Få en lista över inaktuella API:er

    Ovanstående steg innehåller även samma information. Kör dock verify-fasen på all-modulen för att se alla [VARNING]-meddelanden på ett ställe. Till exempel:

    code language-shell
    $ mvn clean verify -pl all
    

    [VARNING]-meddelandena i utdatalistan för bygge visar de inaktuella API:erna i ditt projekt.

Ta bort inaktuella API:er

AEM Analyser rapporterar vad är föråldrat och ger rekommendationen om hur det kan åtgärdas. Använd dock tabellen nedan för att välja rätt åtgärd och följ den länkade dokumentationen när du behöver mer information.

API-reparationsstrategi är inaktuell

Varningstyp för analysator
Vad det indikerar
Rekommenderad åtgärd
Referens
Inaktuellt AEM API
API ska tas bort från AEM as a Cloud Service
Ersätt användning med det offentliga API som stöds
API-vägledning för borttagning
Inaktuellt AEM-paket eller -klass
Paket eller klass stöds inte längre
Kod för att använda det rekommenderade alternativet
Föråldrade API:er
Inaktuellt tredjepartsbibliotek
Biblioteket stöds inte i framtida SDK:er
Uppgradera beroendeförhållandet och användningen av omfakturor
Allmänna riktlinjer
Inaktuella Sling-/OSGi-mönster
Äldre anteckningar eller API:er har identifierats
Migrera till moderna Sling- och OSGi-API:er
Borttagning av Sling-/OSGi-mönster
Planerad borttagning (framtida datum)
API fungerar fortfarande, men borttagning framtvingas senare
Schemalägg rensning före implementering av pipeline
Versionsinformation

Praktisk vägledning

  • Behandla analysvarningar som framtida pipeline-fel, inte valfria meddelanden.
  • Åtgärda inaktuella API:er lokalt med den senaste AEM SDK.
  • Behåll analysresultatet rent för att undvika problem vid framtida uppgraderingar av AEM.

Genom att åtgärda inaktuella API:er tidigt kan du hålla ditt projekt uppgraderingssäkert och körklart.

Ytterligare resurser

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