Verouderde en verwijderde functies en API's deprecated-and-removed-features-apis

Adobe controleert regelmatig functies, waaronder API's en configuraties, om ervoor te zorgen dat deze voldoen aan de veranderende standaarden voor prestaties, beveiliging en algemene waarde voor AEM as a Cloud Service. Op basis van deze evaluaties kunnen bepaalde mogelijkheden worden gemarkeerd voor afschrijving. Indien mogelijk zal Adobe een geschikte vervanging bieden.

Wanneer een afschrijving wordt aangekondigd, blijft de functie slechts voor een beperkte periode beschikbaar en moeten klanten alle gebruik voor een opgegeven verwijderingsdatum verwijderen. Adobe zal een redelijke kennisgeving en richtsnoeren verstrekken om een soepele overgang te ondersteunen.

Tijdens het venster met de verouderingstijd herinnert Adobe klanten aan de acties die ze moeten uitvoeren om een functie niet meer te gebruiken via e-mailmeldingen, waarschuwingen van het Actions Center of herinneringen in Cloud Manager.

Verouderde functionaliteit deprecated-features

De functionaliteit in de onderstaande tabel is aangekondigd als afgekeurd, maar is nog niet verwijderd. Het gebruik van de functionaliteit moet worden beëindigd vóór de verwijderingsdatum van het doel of u riskeert problemen met betrekking tot prestaties, beschikbaarheid en beveiliging.

Verwijderde functionaliteit removed-features

Deze sectie bevat een lijst met functies die zijn verwijderd.

Verouderde API's aem-apis

De API's in de onderstaande tabel (klik om deze uit te vouwen) zijn aangekondigd als afgekeurd, maar zijn nog niet verwijderd. Het gebruik van deze API's moet worden beëindigd vóór de verwijderingsdatum van het doel, anders loopt u risico's met betrekking tot prestaties, beschikbaarheid en beveiliging. Sommige API's verwijzen hieronder naar de sectie API Removal Guidance.

Verwijderde API's removed-apis

Deze sectie bevat een lijst met API's die zijn vervangen en verwijderd. Sommige API's verwijzen hieronder naar de sectie API Removal Guidance.

API Removal Guidance api-removal-guidance

In deze sectie worden API-verwijderingshulplijnen voor verschillende API's in de bovenstaande tabellen besproken.

Om te identificeren welke afgekeurde Java APIs uw code gebruikt, integreer ​ AEM as a Cloud Service SDK bouwt Analyzer Maven Insteekmodule ​ in uw Gemaakt project en stel het plaatselijk in werking. Het rapport bevat een lijst met alle gedetecteerde afgekeurde API-toepassingen en geeft aan naar welke OSGi-bundel wordt verwezen voor elke API. Verwijzing ​ dit leerprogramma ​ leren hoe te om de Geweven Insteekmodule te gebruiken.

Hoewel u alle verouderde API's in de loop der tijd moet verhelpen, geeft u prioriteit aan API's die in de Vervangen API-tabel worden vermeld met de datum van 26 februari 2026 (of eerder) als doel voor verwijdering. In het AEM Analyser-rapport worden deze API's mogelijk weergegeven met een effectieve verwijderingsdatum van 31-8-2025.

Nadat u de code hebt bijgewerkt, controleert u of er in Cloud Manager geen verouderd API-gebruik meer is door de resultaten van de stap Codekwaliteit te controleren.

Als de updates niet op 4 mei zijn uitgevoerd, ontvangt u geen updates van de AEM-versie meer. Als u de release-updates van Adobe opnieuw wilt ontvangen, moet de upload met de volledige stack zijn voltooid. de bijwerking wordt dan binnen enkele dagen toegepast .

Algemene richtsnoeren

Als u een bibliotheek van derden gebruikt waarvoor momenteel een verouderde API is vereist, probeert u een update uit te voeren naar een nieuwere versie van die bibliotheek van derden.

Als u besluit om uw eigen versie van de Vervangen API te implementeren, bijvoorbeeld uw eigen versie van Guava, moet u ervoor zorgen dat al uw bundels die deze API gebruiken, zijn aangesloten op uw versie. Als u besluit om dezelfde hoofdversie te implementeren als die momenteel in Cloud Service is opgenomen, hoeft u verder niets te doen. Nochtans, als u de aanbevelingen volgt en de recentste versie opstelt dan moet u uw Maven project aanpassen, die bibliotheek als nieuwe gebiedsdeel vóór aem-sdk-api omvatten. Op deze manier wordt uw code naar de nieuwe versie getelegrafeerd. Zodra u de veranderingen hebt aangebracht, verifieer met ​ AEM as a Cloud Service SDK bouwt Analysator Gemaakte Insteekmodule ​ dat het gebruik van Vervangen API niet meer wordt gemarkeerd.

Als u ACS AEM Commons gebruikt, gebruik minstens versie 6.11.0 (de recentste versie wordt geadviseerd) en zorg ervoor dat u ​ de versie voor Cloud Service ​ door het classificatieapparaat cloud voor het inhoudspakket te specificeren omvat.

Als het importeren van een Vervangen API is gemarkeerd als optional , moet u toch proberen deze te verwijderen. Een dergelijk optioneel gebruik blokkeert echter geen implementaties. Maar de implementatie kan worden beïnvloed als de optionele import niet meer tevreden is.

Verwijderen van org.apache.sling.commons.auth* org.apache.sling.commons.auth

Als u org.apache.sling.commons.auth of org.apache.sling.commons.auth.spi of beide gebruikt, kunt u het gebruik vervangen door de code naar resp. org.apache.sling.auth te migreren. org.apache.sling.auth.spi. Als u een oude versie van ​ ACS AEM Commons ​ gebruikt, zorg ervoor om aan de recentste versie bij te werken.

Handelingenlijst:

Verwijderen van org.apache.felix.webconsole* org.apache.felix.webconsole

Als u pakketten uit org.apache.felix.webconsole* gebruikt, verwijdert u deze code uit uw project. De webconsole is niet toegankelijk in Cloud Service.

Handelingenlijst:

Verwijderen van org.eclipse.jetty* org.eclipse.jetty

Als u iets uit het pakket org.eclipse.jetty of een van de subpakketten gebruikt, kunt u migreren naar bibliotheken van derden met een vergelijkbare functionaliteit. Als migratie niet haalbaar is, voeg de vereiste bundels van de hieronder lijst aan uw project toe.

Handelingenlijst:

Verwijderen van com.mongodb com.mongodb

Voeg de Mongo-client-API toe aan uw project.

Handelingenlijst:

Afhankelijk van uw vereisten kunt u een andere versie kiezen.

Verwijderen van com.google.common* com.google.common

Verwijder het gebruik van Google Guava Core Libraries of neem een aangewezen versie in uw project op. In veel gevallen kan het gebruik van deze bibliotheek worden vervangen door verzamelingsklassen uit de JDK- of Apache Commons Collections4. Als u geen vervanging vindt, neemt u de nieuwste versie van de Google Guave Core Library in uw project op. Als u een oude versie van ​ ACS AEM Commons ​ gebruikt, zorg ervoor om aan de recentste versie bij te werken.

Handelingenlijst:

Verwijderen van Apache Commons Lang 2 and Apache Commons Collections 3 apache.commons

Verwijder het gebruik van de niet-onderhouden Apache Commons-bibliotheken en vervang deze door het gebruik van de supportversies. In de meeste gevallen hoeft u alleen de pakketimport aan te passen, maar in sommige gevallen is de naam van klassen of methoden gewijzigd. Als u een oude versie van ​ ACS AEM Commons ​ gebruikt, zorg ervoor om aan de recentste versie bij te werken.

Handelingenlijst:

Gebruik van org.apache.abdera* en org.apache.sling.atom.taglib org.apache.abdera_or_org.apache.sling.atom.taglib

Vervang het gebruik van pakketten uit org.apache.abdera en org.apache.sling.atom.taglib door een externe bibliotheek met vergelijkbare functionaliteit of uw eigen code.

Handelingenlijst:

Gebruik van org.apache.felix.http.whiteboard org.apache.felix.http.whiteboard

Vervang het gebruik van org.apache.felix.http.whiteboard met ​ OSGi Whiteboard Http ​. De officiële OSGi API heeft gelijkaardige mogelijkheden en het vervangen vereist vaak slechts om de eigenschappen van de de dienstregistratie te veranderen.

Handelingenlijst:

Gebruik van ch.qos.logback* ch.qos.logback

Logback wordt niet ondersteund in Cloud Service. Verwijder alle gebruiksmogelijkheden. Als u een oude versie van ​ ACS AEM Commons ​ gebruikt, zorg ervoor om aan de recentste versie bij te werken.

Handelingenlijst:

Gebruik van org.slf4j.event and org.slf4j.spi org.slf4j

Als u org.slf4j.event of org.slf4j.spi gebruikt, verwijdert u het volledige gebruik ervan. Als u een oude versie van ​ ACS AEM Commons ​ gebruikt, zorg ervoor om aan de recentste versie bij te werken.

Handelingenlijst:

Gebruik van org.apache.log4j org.apache.log4j

Als u org.apache.log4j schakelaar aan of SLF4J (org.slf4j) of Log4J 2.x (org.apache.logging.log4j) gebruikt.

Handelingenlijst:

OSGI-configuratie osgi-configuration

De secties hieronder wijzen op de AEM as a Cloud Service OSGi configuratieoppervlakte, die welke klanten kunnen vormen.

De code van de klant kan om het even welke configuratie vormen OSGi niet vermeld.

Deze regels worden gevalideerd tijdens het Cloud Manager-ontwikkelproces. Er kunnen in de loop der tijd aanvullende regels worden toegevoegd en de verwachte datum van tenuitvoerlegging wordt in de tabel vermeld. Van klanten wordt verwacht dat zij zich aan deze regels zullen houden tegen de beoogde handhavingsdatum. Als u zich na de verwijderingsdatum niet aan de regels houdt, treden fouten op in het Cloud Manager-constructieproces. Gemaakte projecten zouden ​ AEM as a Cloud Service SDK moeten omvatten bouwt Analysator Gemaakte Insteekmodule ​ om configuratiefouten te markeren OSGI tijdens de lokale ontwikkeling van SDK.

De extra informatie over configuratie OSGI kan bij ​ worden gevonden deze plaats ​.

Vervangen OSGi-eigenschappen (binnenkort niet te wijzigen) deprecated-unmodifiable-osgi-properties

Eigenschappen voor de volgende PIDs van de component OSGi zijn afgekeurd en het gebruik zou tegen de handhavingsdatum moeten ophouden.

Onaanpasbare OSGi-configuraties unmodifiable-osgi-properties

Eigenschappen voor de volgende PIDs van de component OSGi kunnen niet worden gewijzigd, daarom moeten deze niet worden gevormd.

Toekomstige afgedwongen OSGi-eigendomsrechten future-restrictions-osgi-properties

In de toekomst zal Adobe de volgende OSGi-eigenschappen-beperkingen afdwingen. Voor genoemde PIDs, slechts worden de vermelde eigenschappen toegestaan om worden gevormd.

Beperkingen van OSGi-eigenschappen restrictions-osgi-properties

De waarden van deze OSGi-eigenschappen zijn beperkt tot de hieronder beschreven regels.

Java-runtime-update naar versie 21 java-runtime-update-21

Adobe Experience Manager as a Cloud Service heeft een overgang gemaakt naar de Java 21-runtime. Om verenigbaarheid te verzekeren, is het bijwerken van bibliotheekversies zoals die in ​ runtime vereisten ​ worden geschetst essentieel.