Funciones y API obsoletas y eliminadas deprecated-and-removed-features-apis
Adobe revisa regularmente las funciones, incluidas las API y las configuraciones, para asegurarse de que cumplan los estándares de evolución en cuanto a rendimiento, seguridad y valor general de AEM as a Cloud Service. En función de estas evaluaciones, ciertas funciones pueden estar marcadas para su entrada en desuso. Cuando sea posible, Adobe proporcionará un reemplazo adecuado.
Cuando se anuncia un desuso, la función solo permanece disponible durante un período de tiempo limitado y los clientes deberán concluir todo uso antes de la fecha de eliminación especificada. Adobe proporciona un aviso y una guía razonables para facilitar una transición sin problemas.
Durante el plazo de tiempo hasta la entrada en desuso, Adobe recordará a los clientes las acciones que deben realizar para dejar de utilizar una función mediante notificaciones por correo electrónico, alertas del Centro de acciones o recordatorios en Cloud Manager.
- A partir del 26 de enero de 2026: los correos electrónicos de notificación del Centro de acciones se envían como recordatorio para eliminar el uso de estas API si se ha ejecutado recientemente una canalización.
- 26 de febrero de 2026: Las canalizaciones de Cloud Manager que contienen código mediante estas API se pausarán durante el paso Calidad del código. Un administrador de implementación, un administrador de proyectos o un propietario empresarial pueden anular el problema para permitir que continúe la canalización. Esto puede ralentizar la validación y la publicación de cambios en el código.
- 14 de abril de 2026: Las canalizaciones de Cloud Manager que contienen código mediante estas API producirán errores durante el paso Calidad del código. Las implementaciones se bloquearán hasta que se elimine el uso de API obsoleto. Esto puede impedir que publique actualizaciones con plazos específicos y podría afectar a las operaciones de su empresa.
- 11 de junio de 2026: Los entornos que aún utilicen API obsoletas no recibirán actualizaciones críticas de la versión de Adobe y no estarán sujetos a los compromisos estándar de Adobe en cuanto a rendimiento y disponibilidad. Como resultado, no recibirá nuevas funciones ni correcciones de errores, la estabilidad y el tiempo de actividad de la aplicación podrían verse afectados negativamente y la exposición al riesgo de seguridad podría aumentar aún más. Para volver a recibir las actualizaciones de la versión de Adobe, se debe ejecutar correctamente una canalización de pila completa; la actualización se aplicará en unos días.
Funcionalidad en desuso deprecated-features
Se ha anunciado que la funcionalidad de la tabla siguiente ya no se utiliza, pero aún no se ha eliminado. El uso de la funcionalidad debe interrumpirse antes de la fecha de eliminación objetivo o se corre el riesgo de que se produzcan problemas relacionados con el rendimiento, la disponibilidad y la seguridad.
- El Editor universal para la edición visual.
- El editor de fragmentos de contenido para la edición basada en formularios.
DAM Asset Update flujo de trabajo para procesar imágenes grabadas.DAM Asset Update, incluida la llamada a herramientas de línea de comandos como ImageMagick.Funcionalidad eliminada removed-features
Esta sección enumera las funcionalidades que se han eliminado.
API obsoletas aem-apis
Se ha anunciado que las API de la tabla siguiente (haga clic para ampliar y verlas) ya no se utilizan, pero aún no se han eliminado. El uso de estas API debe interrumpirse antes de la fecha de eliminación objetivo o se corre el riesgo de que se produzcan problemas relacionados con el rendimiento, la disponibilidad y la seguridad. Algunas API hacen referencia a la sección Guía de eliminación de API que aparece a continuación.
- A partir del 26 de enero de 2026: los correos electrónicos de notificación del Centro de acciones se envían como recordatorio para eliminar el uso de estas API.
- 26 de febrero de 2026: Las canalizaciones de Cloud Manager que contienen código mediante estas API se pausarán durante el paso Calidad del código. Un administrador de implementación, un administrador de proyectos o un propietario empresarial pueden anular el problema para permitir que continúe la canalización. Esto puede ralentizar la validación y la publicación de cambios en el código.
- 14 de abril de 2026: Las canalizaciones de Cloud Manager que contienen código mediante estas API producirán errores durante el paso Calidad del código. Las implementaciones se bloquearán hasta que se elimine el uso de API obsoleto. Esto puede impedir que publique actualizaciones con plazos específicos y podría afectar a las operaciones de su empresa.
- 11 de junio de 2026: Los entornos que aún utilicen API obsoletas no recibirán actualizaciones críticas de la versión de Adobe y no estarán sujetos a los compromisos estándar de Adobe en cuanto a rendimiento y disponibilidad. Como resultado, no recibirá nuevas funciones ni correcciones de errores, la estabilidad y el tiempo de actividad de la aplicación podrían verse afectados negativamente y la exposición al riesgo de seguridad podría aumentar aún más.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 layout-auto html-authored | |||
|---|---|---|---|
| Paquete/Clase | Comentarios | Fecha de desuso | Fecha de eliminación objetivo |
| org.apache.sling.commons.auth org.apache.sling.commons.auth.spi |
Use las interfaces Auth Core/Auth Core SPI de Sling como alternativa. Consulte las notas de eliminación a continuación. | 2015 | 2/26/2026 |
| org.eclipse.jetty.client org.eclipse.jetty.client.api org.eclipse.jetty.client.http org.eclipse.jetty.client.util org.eclipse.jetty.http org.eclipse.jetty.http.pathmap org.eclipse.jetty.io org.eclipse.jetty.io.ssl org.eclipse.jetty.security org.eclipse.jetty.server org.eclipse.jetty.server.handler org.eclipse.jetty.server.handler.gzip org.eclipse.jetty.server.session org.eclipse.jetty.servlet org.eclipse.jetty.servlet.listener org.eclipse.jetty.util org.eclipse.jetty.util.annotation org.eclipse.jetty.util.component org.eclipse.jetty.util.log org.eclipse.jetty.util.resource org.eclipse.jetty.util.security org.eclipse.jetty.util.ssl org.eclipse.jetty.util.statistic org.eclipse.jetty.util.thread |
Los paquetes Eclipse Jetty y Felix Http Jetty ya no se admiten. Consulte las notas de eliminación a continuación. | 27/5/2021 | 2/26/2026 |
| com.mongodb com.mongodb.annotations com.mongodb.assertions com.mongodb.async com.mongodb.binding com.mongodb.bulk com.mongodb.client com.mongodb.client.gridfs com.mongodb.client.gridfs.codecs com.mongodb.client.gridfs.model com.mongodb.client.jndi com.mongodb.client.model com.mongodb.client.model.changestream com.mongodb.client.model.geojson com.mongodb.client.model.geojson.codecs com.mongodb.client.result com.mongodb.connection com.mongodb.connection.netty com.mongodb.diagnostics.logging com.mongodb.event com.mongodb.gridfs com.mongodb.internal com.mongodb.internal.async com.mongodb.internal.authentication com.mongodb.internal.connection com.mongodb.internal.dns com.mongodb.internal.event com.mongodb.internal.management.jmx com.mongodb.internal.session com.mongodb.internal.thread com.mongodb.internal.validator com.mongodb.management com.mongodb.operation com.mongodb.selector com.mongodb.session com.mongodb.util |
El uso de esta API no se admite en AEM as a Cloud Service. Consulte las notas de eliminación a continuación. | 27/5/2021 | 2/26/2026 |
| org.apache.abdera org.apache.abdera.model org.apache.abdera.factory org.apache.abdera.ext.media org.apache.abdera.util org.apache.abdera.i18n.iri org.apache.abdera.writer org.apache.abdera.i18n.rfc4646 org.apache.abdera.i18n.rfc4646.enums org.apache.abdera.i18n.text org.apache.abdera.filter org.apache.abdera.xpath org.apache.abdera.i18n.text.io org.apache.abdera.i18n.text.data org.apache.abdera.parser |
Esta API está en desuso, ya que Apache Abdera es un proyecto retirado desde 2017. Consulte las notas de eliminación a continuación. | 29/7/2021 | 2/26/2026 |
| org.apache.abdera.ext.opensearch org.apache.abdera.ext.opensearch.model org.apache.abdera.ext.opensearch.server org.apache.abdera.ext.opensearch.server.impl org.apache.abdera.ext.opensearch.server.processors org.apache.abdera.i18n.iri.data org.apache.abdera.i18n.lang org.apache.abdera.i18n.templates org.apache.abdera.i18n.unicode.data org.apache.abdera.parser.stax org.apache.abdera.parser.stax.util org.apache.abdera.protocol org.apache.abdera.protocol.client org.apache.abdera.protocol.client.cache org.apache.abdera.protocol.client.util org.apache.abdera.protocol.error org.apache.abdera.protocol.server org.apache.abdera.protocol.server.context org.apache.abdera.protocol.server.filters org.apache.abdera.protocol.server.impl org.apache.abdera.protocol.server.multipart org.apache.abdera.protocol.server.processors org.apache.abdera.protocol.server.provider.basic org.apache.abdera.protocol.server.provider.managed org.apache.abdera.protocol.server.servlet org.apache.abdera.protocol.util org.apache.abdera.util.filter |
Esta API está en desuso, ya que Apache Abdera es un proyecto retirado desde 2017. Consulte las notas de eliminación a continuación. | 8/4/2019 | 2/26/2026 |
| org.apache.felix.http.whiteboard | La pizarra Apache Felix Http ya no es compatible. Migre su código a la pizarra Http OSGi. Consulte las notas de eliminación a continuación. | 27/1/2022 | 2/26/2026 |
| org.apache.cocoon.xml.dom org.apache.cocoon.xml.sax |
Esta API está obsoleta. Esta API está en desuso. Migre su código a las API de XML proporcionadas por el JDK. | 27/1/2022 | 2/26/2026 |
| ch.qos.logback.classic ch.qos.logback.classic.boolex ch.qos.logback.classic.db.names ch.qos.logback.classic.db.script ch.qos.logback.classic.encoder ch.qos.logback.classic.filter ch.qos.logback.classic.helpers ch.qos.logback.classic.html ch.qos.logback.classic.jmx ch.qos.logback.classic.joran ch.qos.logback.classic.joran.action ch.qos.logback.classic.jul ch.qos.logback.classic.layout ch.qos.logback.classic.log4j ch.qos.logback.classic.net ch.qos.logback.classic.net.server ch.qos.logback.classic.pattern ch.qos.logback.classic.pattern.color ch.qos.logback.classic.selector ch.qos.logback.classic.selector.servlet ch.qos.logback.classic.servlet ch.qos.logback.classic.sift ch.qos.logback.classic.spi ch.qos.logback.classic.turbo ch.qos.logback.classic.util ch.qos.logback.core ch.qos.logback.core.boolex ch.qos.logback.core.encoder ch.qos.logback.core.filter ch.qos.logback.core.helpers ch.qos.logback.core.hook ch.qos.logback.core.html ch.qos.logback.core.joran ch.qos.logback.core.joran.action ch.qos.logback.core.joran.conditional ch.qos.logback.core.joran.event ch.qos.logback.core.joran.event.stax ch.qos.logback.core.joran.node ch.qos.logback.core.joran.spi ch.qos.logback.core.joran.util ch.qos.logback.core.joran.util.beans ch.qos.logback.core.layout ch.qos.logback.core.net ch.qos.logback.core.net.server ch.qos.logback.core.net.ssl ch.qos.logback.core.pattern ch.qos.logback.core.pattern.color ch.qos.logback.core.pattern.parser ch.qos.logback.core.pattern.util ch.qos.logback.core.property ch.qos.logback.core.read ch.qos.logback.core.recovery ch.qos.logback.core.rolling ch.qos.logback.core.rolling.helper ch.qos.logback.core.sift ch.qos.logback.core.spi ch.qos.logback.core.status ch.qos.logback.core.subst ch.qos.logback.core.util |
AEM as a Cloud Service no admite esta API interna de registro. Consulte las notas de eliminación a continuación. | 27/1/2022 | 2/26/2026 |
| org.slf4j.spi | AEM as a Cloud Service no admite esta API interna de log4j. Consulte las notas de eliminación a continuación. | 27/1/2022 | 2/26/2026 |
| org.slf4j.event | AEM as a Cloud Service no admite esta API interna de slf4j. Consulte las notas de eliminación a continuación. | 11/4/2022 | 2/26/2026 |
| org.apache.log4j org.apache.log4j.helpers org.apache.log4j.spi org.apache.log4j.xml |
Apache Log4j 1 ha llegado al fin de su vida útil en 2015 y ya no es compatible. Consulte las notas de eliminación a continuación. | 27/1/2022 | 2/26/2026 |
| com.google.common.annotations com.google.common.base com.google.common.cache com.google.common.collect com.google.common.escape com.google.common.eventbus com.google.common.hash com.google.common.html com.google.common.io com.google.common.math com.google.common.net com.google.common.primitives com.google.common.reflect com.google.common.util.concurrent com.google.common.xml |
Las bibliotecas principales de Google Guava están en desuso en Cloud Service. Consulte las notas de eliminación a continuación. | 15/5/2023 | 2/26/2026 |
| com.draw.* | La extracción de metadatos de imágenes y vídeos debe realizarse mediante Asset Compute en Cloud Service, o mediante Apache POI o Apache Tika. | 17/9/2024 | 2/26/2026 |
| org.apache.jackrabbit.oak.plugins.memory | Esta API es solo para uso interno. | 23/9/2024 | 2/26/2026 |
| org.apache.felix.webconsole org.apache.felix.webconsole.bundleinfo org.apache.felix.webconsole.i18n org.apache.felix.webconsole.spi |
La consola web de Felix no es compatible con entornos de nube. Consulte las notas de eliminación a continuación. | 30/4/2021 | 2/26/2026 |
| org.apache.jackrabbit.oak.plugins.blob org.apache.jackrabbit.oak.plugins.blob.datastore |
Esta API es solo para uso interno. | 23/9/2024 | 9/30/2026 |
| org.bson org.bson.assertions org.bson.codecs org.bson.codecs.configuration org.bson.codecs.pojo org.bson.codecs.pojo.annotations org.bson.conversions org.bson.diagnostics org.bson.internal org.bson.io org.bson.json org.bson.types org.bson.util |
El uso de esta API no se admite en AEM as a Cloud Service. | 31/10/2022 | 9/30/2026 |
| com.day.cq.contentsync.handler.util | Esta API está obsoleta. En su lugar, utilice los generadores de Apache Sling. | 31/10/2022 | 9/30/2026 |
| com.adobe.granite.xss | En su lugar, utilice org.apache.sling.xss. | 12/12/2023 | 9/30/2026 |
| com.github.jknack.handlebars com.github.jknack.handlebars.cache com.github.jknack.handlebars.context com.github.jknack.handlebars.helper com.github.jknack.handlebars.io |
Esta API está obsoleta. | 07/10/2024 | 9/30/2026 |
| com.day.cq.mailer.commons | Esta API está en desuso, ya que depende de commons-lang (obsoleta desde 2021). | 11/30/2025 | 9/30/2026 |
| com.adobe.granite.httpcache.api | Esta API ya no es compatible. | 01/01/2026 | 9/30/2026 |
| org.apache.jackrabbit.webdav.client.methods | El uso de esta API no se admite en AEM as a Cloud Service. | 2/13/2026 | 9/30/2026 |
| com.day.cq.xss com.day.cq.xss.taglib com.day.cq.xss.impl |
En su lugar, utilice org.apache.sling.xss. | 12/12/2023 | 9/30/2026 |
| Esta versión de Apache Tika está obsoleta y, por lo tanto, se eliminará de Cloud Service. Cambie a una versión más reciente de Apache Tika. | 4/30/2026 | 9/30/2026 | |
| org.apache.commons.lang org.apache.commons.lang.enums org.apache.commons.lang.builder org.apache.commons.lang.exception org.apache.commons.lang.math org.apache.commons.lang.mutable org.apache.commons.lang.reflect org.apache.commons.lang.text org.apache.commons.lang.time |
Commons Lang 2 está en modo de mantenimiento. Debe utilizarse Commons Lang 3 en su lugar. Consulte las notas de eliminación a continuación. | 30/4/2021 | 31/3/2027 (Provisional) |
| org.apache.commons.collections org.apache.commons.collections.bag org.apache.commons.collections.bidimap org.apache.commons.collections.buffer org.apache.commons.collections.collection org.apache.commons.collections.comparators org.apache.commons.collections.functors org.apache.commons.collections.iterators org.apache.commons.collections.keyvalue org.apache.commons.collections.list org.apache.commons.collections.map org.apache.commons.collections.set |
Commons Collections 3 está en modo de mantenimiento. Debe utilizarse Commons Collections 4 en su lugar. Consulte las notas de eliminación a continuación. | 30/4/2021 | 31/3/2027 (Provisional) |
| org.json | La implementación de Apache Johnzon de javax.json se recomienda y debe utilizarse. | 4/30/2021 | 31/3/2027 (Provisional) |
| org.apache.sling.runmode | 2015 | 31/12/2027 (Provisional) | |
| org.apache.sling.commons.json org.apache.sling.commons.json.http org.apache.sling.commons.json.io org.apache.sling.commons.json.jcr org.apache.sling.commons.json.sling org.apache.sling.commons.json.util org.apache.sling.commons.json.xml |
AEM as a Cloud Service no admite esta API. | 15/5/2023 | 31/12/2027 (Provisional) |
| org.osgi.service.http | La API HTTP del servicio OSGi está en desuso. Utilice la pizarra electrónica del servlet OSGi en su lugar. | 5/1/2024 | 31/12/2027 (Provisional) |
API eliminadas removed-apis
Esta sección enumera las API que ya no se utilizan y se han eliminado. Algunas API hacen referencia a la sección Guía de eliminación de API que aparece a continuación.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto html-authored | |
|---|---|
| Paquete/Clase | Comentarios |
| com.day.cq.jcrclustersupport | Uso de la API Discovery de Sling como alternativa |
| org.apache.fop.apps | |
| org.apache.jackrabbit.vault.util.xml.xerces.dom org.apache.jackrabbit.vault.util.xml.xerces.util org.apache.jackrabbit.vault.util.xml.xerces.xni org.apache.jackrabbit.vault.util.xml.xerces.xni.parser |
|
| org.apache.felix.cm org.apache.felix.cm.file |
Los administradores de persistencia personalizados no son compatibles con AEM as a Cloud Service. |
| org.apache.felix.systemready | Se recomienda utilizar la API Apache Felix HealthCheck en su lugar |
| org.apache.felix.http.jetty org.eclipse.jetty.client.jmx org.eclipse.jetty.jmx org.eclipse.jetty.server.handler.jmx org.eclipse.jetty.server.nio org.eclipse.jetty.server.jmx org.eclipse.jetty.servlet.jmx org.eclipse.jetty.util.preventers org.eclipse.jetty.util.thread.strategy org.eclipse.jetty.webapp org.eclipse.jetty.websocket.api org.eclipse.jetty.websocket.api.annotations org.eclipse.jetty.websocket.api.extensions org.eclipse.jetty.websocket.api.util org.eclipse.jetty.websocket.client org.eclipse.jetty.websocket.client.io org.eclipse.jetty.websocket.client.masks org.eclipse.jetty.websocket.common org.eclipse.jetty.websocket.common.events org.eclipse.jetty.websocket.common.events.annotated org.eclipse.jetty.websocket.common.extensions org.eclipse.jetty.websocket.common.extensions.compress org.eclipse.jetty.websocket.common.extensions.fragment org.eclipse.jetty.websocket.common.extensions.identity org.eclipse.jetty.websocket.common.frames org.eclipse.jetty.websocket.common.io org.eclipse.jetty.websocket.common.io.http org.eclipse.jetty.websocket.common.io.payload org.eclipse.jetty.websocket.common.message org.eclipse.jetty.websocket.common.scopes org.eclipse.jetty.websocket.common.util org.eclipse.jetty.websocket.server org.eclipse.jetty.websocket.server.pathmap org.eclipse.jetty.websocket.servlet org.eclipse.jetty.xml |
Los paquetes Eclipse Jetty y Felix Http Jetty ya no se admiten. |
| org.apache.felix.metatype org.apache.felix.scr org.apache.felix.scr.info org.apache.felix.scr.component |
Las API Apache Felix metatype y SCR están en desuso. Utilice en su lugar las API OSGi metatype y Declarative Service. |
| org.slf4j.impl | Las clases de implementación de registros no son compatibles con AEM as a Cloud Service. |
| API heredada AEM 6.x. | |
| org.apache.sling.discovery.commons org.apache.sling.discovery.commons.providers org.apache.sling.discovery.commons.providers.base org.apache.sling.discovery.commons.providers.spi org.apache.sling.discovery.commons.providers.spi.base org.apache.sling.discovery.commons.providers.util |
Esta API no se admite en Cloud Service. |
| org.apache.jackrabbit.vault.util.xml org.apache.jackrabbit.vault.util.xml.serialize |
Las clases de utilidad relacionadas con Apache Xerces se eliminan en las versiones posteriores, lo que provoca un cambio de versión importante. Como estas utilidades son de uso interno en Filevault, la API está quedando en desuso en la superficie de la API pública. |
| org.apache.sling.atom.taglib org.apache.sling.atom.taglib.media |
API heredada AEM 6.x. Consulte las notas de eliminación a continuación. |
| org.apache.sling.commons.log.logback org.apache.sling.commons.log.logback.webconsole |
AEM as a Cloud Service no admite esta API interna de registro. |
| com.github.jknack.handlebars.js | Se requiere la actualización de Handlebars de 4.0.5 a 4.3.0 debido a una vulnerabilidad de seguridad. Este paquete ya no está presente en los controladores actualizados. |
| com.adobe.granite.resourceresolverhelper | Esta API ya no es compatible. En su lugar, utilice org.apache.sling.api.resource.ResourceResolverFactory. |
| org.apache.sling.repoinit.jcr org.apache.sling.repoinit.parser.operations |
El uso de esta API no se admite en AEM as a Cloud Service. |
| org.apache.jackrabbit.oak.cache | Esta API es solo para uso interno. |
Guía de eliminación de API api-removal-guidance
Esta sección presenta la guía de eliminación de API para las diversas API incluidas en las tablas anteriores.
Para identificar qué API de Java en desuso usa su código, integre el complemento Maven de AEM as a Cloud Service SDK Build Analyzer en su proyecto Maven y ejecútelo localmente. El informe enumera todos los usos de API obsoletos detectados e indica qué paquete OSGi hace referencia a cada API. Haga referencia a este tutorial para aprender a utilizar el complemento de Maven.
Aunque debe corregir todas las API obsoletas con el tiempo, dé prioridad a cualquier API enumerada en la tabla de API obsoletas con una fecha de eliminación objetivo del 26 de febrero de 2026 (o anterior). En el informe de AEM Analyzer, estas API pueden aparecer con una fecha de eliminación efectiva del 31/8/2025.
Después de actualizar el código, compruebe que no queda ningún uso obsoleto de la API en Cloud Manager comprobando los resultados del paso de calidad del código.
Si las actualizaciones no se han realizado antes del 4 de mayo, dejará de recibir actualizaciones de la versión de AEM. Para volver a recibir las actualizaciones de la versión de Adobe, la canalización de pila completa debe ejecutarse correctamente; la actualización se aplicará en unos días.
Directrices generales
Si utiliza una biblioteca de terceros que actualmente requiere una API obsoleta, intente actualizar a una versión más reciente de esa biblioteca de terceros.
Si decide implementar su propia versión de la API obsoleta, por ejemplo, su propia versión de Guava, asegúrese de que todos los paquetes que utilicen esta API estén conectados a su versión. Si decide implementar la misma versión principal que la que se incluye actualmente en Cloud Service, no es necesario realizar más acciones. Sin embargo, si sigue las recomendaciones e implementa la versión más reciente, tendrá que ajustar el proyecto Maven, incluir esa biblioteca como una nueva dependencia antes de aem-sdk-api. De este modo, el código se conectará a la nueva versión. Una vez que haya realizado los cambios, verifique con el Complemento Maven de AEM as a Cloud Service SDK Build Analyzer que el uso de la API obsoleta ya no esté marcado.
Si usa ACS AEM Commons, use al menos la versión 6.11.0 (se recomienda la versión más reciente) y asegúrese de incluir la versión de Cloud Service especificando el clasificador cloud para el paquete de contenido.
Si la importación de una API obsoleta está marcada como optional, debe intentar eliminarla. Sin embargo, este uso opcional no bloqueará las implementaciones. Sin embargo, su implementación podría verse afectada, una vez que la importación opcional ya no se cumpla.
Eliminación de org.apache.sling.commons.auth* org.apache.sling.commons.auth
Si usa org.apache.sling.commons.auth o org.apache.sling.commons.auth.spi o ambos, el uso se puede reemplazar migrando el código a org.apache.sling.auth resp. org.apache.sling.auth.spi. Si está usando una versión antigua de ACS AEM Commons, asegúrese de actualizarla a la versión más reciente.
Lista de acciones:
- Si usa ACS AEM Commons, actualice a la versión más reciente (al menos 6.11.0) y asegúrese de usar el clasificador
cloud. - Migrar de
org.apache.sling.commons.authy/oorg.apache.sling.commons.auth.spiaorg.apache.sling.authresp.org.apache.sling.auth.spi.
Eliminación de org.apache.felix.webconsole* org.apache.felix.webconsole
Si está usando paquetes de org.apache.felix.webconsole*, quite este código del proyecto. No se puede acceder a la consola web desde Cloud Service.
Lista de acciones:
- Quitar código utilizando paquetes de
org.apache.felix.webconsole*
Eliminación de org.eclipse.jetty* org.eclipse.jetty
Si utiliza cualquier elemento del paquete org.eclipse.jetty o de uno de sus subpaquetes, es posible que desee migrar a otras bibliotecas de terceros cuya funcionalidad sea similar. Si la migración no es factible, añada los paquetes requeridos de la siguiente lista a su proyecto.
Lista de acciones:
-
Reemplazar el uso de paquetes de
org.eclipse.jettycon otras bibliotecas de terceros/código propio o -
Seleccione los paquetes necesarios de esta lista y agréguelos al proyecto. Si agrega uno, asegúrese de comprobar las importaciones de paquetes de ese paquete, ya que es posible que tenga que agregar otros de esta lista para completar esas importaciones. Si desea utilizar la versión 9.x de estos paquetes, asegúrese de implementar exactamente la versión de abajo y no incruste y exporte estos paquetes.
org.eclipse.jetty:jetty-client:9.4.54.v20240208org.eclipse.jetty:jetty-http:9.4.54.v20240208org.eclipse.jetty:jetty-io:9.4.54.v20240208org.eclipse.jetty:jetty-security:9.4.54.v20240208org.eclipse.jetty:jetty-servlet:9.4.54.v20240208org.eclipse.jetty:jetty-server:9.4.54.v20240208org.eclipse.jetty:jetty-util:9.4.54.v20240208org.eclipse.jetty:jetty-util-ajax:9.4.54.v20240208
Eliminación de com.mongodb com.mongodb
Añadir la API del cliente Mongo al proyecto.
Lista de acciones:
- Añadir este paquete al proyecto
org.mongodb:mongo-java-driver:3.12.7
Es posible que desee elegir una versión diferente, según sus necesidades.
Eliminación de com.google.common* com.google.common
Elimine el uso de las bibliotecas principales de Google Guava o incluya una versión adecuada en su proyecto. En muchos casos, el uso de esta biblioteca se puede reemplazar con clases de colección de JDK o Apache Commons Collections4. Si no encuentra ningún reemplazo, incluya la versión más reciente de la biblioteca principal de Google Guave en su proyecto. Si está usando una versión antigua de ACS AEM Commons, asegúrese de actualizarla a la versión más reciente.
Lista de acciones:
- Si usa ACS AEM Commons, actualice a la versión más reciente (al menos 6.11.0) y asegúrese de usar el clasificador
cloud. - Si está usando
io.wcm:io.wcm.caconfig.extensions, actualice esto al menos a la versión 1.9.2 - Reemplace el uso de la biblioteca principal de Google Guava con colecciones JDK o Apache Commons Collections4
- Si sigue siendo necesario, añada este paquete al proyecto (sustituya la versión por la más reciente disponible):
com.google.guava:guava:33.4.8-jre
Eliminación de Apache Commons Lang 2 and Apache Commons Collections 3 apache.commons
Elimine el uso de las bibliotecas de Apache Commons no mantenidas y reemplace su uso por el de versiones compatibles. En la mayoría de los casos, esto simplemente requiere ajustar las importaciones de paquetes, solo en algunos casos se les ha cambiado el nombre a clases o métodos. Si está usando una versión antigua de ACS AEM Commons, asegúrese de actualizarla a la versión más reciente.
Lista de acciones:
- Si usa ACS AEM Commons, actualice a la versión más reciente (al menos 6.11.0) y asegúrese de usar el clasificador
cloud. - Reemplazar importaciones de
org.apache.commons.lang*pororg.apache.commons.lang3 - Reemplazar importaciones de
org.apache.commons.collections*pororg.apache.commons.collecitons4
Uso de org.apache.abdera* y org.apache.sling.atom.taglib org.apache.abdera_or_org.apache.sling.atom.taglib
Reemplazar el uso de cualquier paquete de org.apache.abdera y org.apache.sling.atom.taglib con una biblioteca de terceros que proporcione una funcionalidad similar o con su propio código.
Lista de acciones:
- Reemplazar el uso de paquetes de
org.apache.abderayorg.apache.sling.atom.taglibpor otras bibliotecas de terceros o código propio.
Uso de org.apache.felix.http.whiteboard org.apache.felix.http.whiteboard
Reemplazar el uso de org.apache.felix.http.whiteboard con la pizarra Http OSGi. La API oficial de OSGi tiene capacidades similares y su reemplazo la mayoría de las veces solo requiere cambiar las propiedades de registro del servicio.
Lista de acciones:
- Reemplazar el uso de
org.apache.felix.http.whiteboardcon la pizarra Http OSGi
Uso de ch.qos.logback* ch.qos.logback
Logback no es compatible en Cloud Service; elimine todo uso del mismo. Si está usando una versión antigua de ACS AEM Commons, asegúrese de actualizarla a la versión más reciente.
Lista de acciones:
- Si usa ACS AEM Commons, actualice a la versión más reciente (al menos 6.11.0) y asegúrese de usar el clasificador
cloud. - Quitar el código utilizando paquetes de
ch.qos.logback
Uso de org.slf4j.event and org.slf4j.spi org.slf4j
Si está usando org.slf4j.event o org.slf4j.spi, elimine todo uso del mismo. Si está usando una versión antigua de ACS AEM Commons, asegúrese de actualizarla a la versión más reciente.
Lista de acciones:
- Si usa ACS AEM Commons, actualice a la versión más reciente (al menos 6.11.0) y asegúrese de usar el clasificador
cloud. - Si está usando el cliente Apache Kafka e incluye el paquete de envoltorio OSGi de Apache ServiceMix (
org.apache.servicemix.bundles.kafka-clients), reemplácelo por el Envoltorio para cliente Apache Kafka de AEM. Esta es la misma versión que la de Apache ServiceMix con solo el uso de esos dos paquetes eliminados. - Si está usando
com.adobe.aio.aem:aio-lib-osgi, actualice a la versión más reciente (al menos 2.0.12). - Quitar el código utilizando
org.slf4j.eventyorg.slf4j.spi
Uso de org.apache.log4j org.apache.log4j
Si usa org.apache.log4j, cambie a SLF4J (org.slf4j) o Log4J 2.x (org.apache.logging.log4j).
Lista de acciones:
- Reemplazar el uso de
org.apache.log4jpor el deorg.slf4j(recomendado) oorg.apache.logging.log4j
Configuración OSGi osgi-configuration
Las secciones siguientes reflejan la superficie de configuración de OSGi en AEM as a Cloud Service, e indican lo que los clientes pueden configurar.
- El código de cliente no debe configurar las configuraciones de OSGi indicadas.
- Una lista de configuraciones de OSGi cuyas propiedades pueden configurarse, pero deben cumplir las reglas de validación indicadas. Estas reglas incluyen si la declaración de la propiedad es obligatoria, su tipo y, en algunos casos, su intervalo permitido de valores.
El código de cliente puede configurar cualquier configuración de OSGi que no aparezca en la lista.
Estas reglas se validan durante el proceso de compilación de Cloud Manager. Con el tiempo se pueden añadir reglas adicionales y la fecha de aplicación esperada se indica en la tabla. Se espera que los clientes cumplan estas reglas en la fecha objetivo de aplicación. Si no se respetan las reglas después de la fecha de eliminación, se generarán errores en el proceso de generación de Cloud Manager. Los proyectos de Maven deben incluir el complemento Maven AEM as a Cloud Service SDK Build Analyzer para marcar los errores de configuración de OSGI durante el desarrollo local del SDK.
Puede encontrar información adicional sobre la configuración de OSGI en esta ubicación.
Propiedades OSGi en desuso (pronto no se podrán modificar) deprecated-unmodifiable-osgi-properties
Las propiedades para los siguientes PID de componentes de OSGi están en desuso y su uso debe haberse detenido ya en la fecha de aplicación.
org.apache.sling.commons.log.LogManagerorg.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.jcr.davex.impl.servlets.SlingDavExServletcom.adobe.granite.toggle.impl.dev.DynamicToggleProviderImplorg.apache.http.proxyconfiguratorConfiguraciones de OSGi no modificables unmodifiable-osgi-properties
Las propiedades de los siguientes PID de componentes OSGi no se pueden modificar, por lo que no deben configurarse.
com.day.cq.auth.impl.cug.CugSupportImplcom.day.cq.jcrclustersupport.ClusterStartLevelControllercom.adobe.granite.toggle.impl.ToggleRouterImplorg.apache.sling.engine.impl.log.RequestLoggerFilterorg.apache.sling.feature.apiregions.implorg.apache.sling.jcr.resource.internal.helper.jcr.BinaryDownloadUriProvidercom.adobe.cq.unifiedshell.impl.discovery.DiscoveryServletcom.adobe.cq.unifiedshell.impl.ui.FrameErrorHandlercom.adobe.cq.unifiedshell.impl.config.UnifiedShellConfServicecom.adobe.cq.unifiedshell.impl.config.RepositoryIdentifierorg.apache.sling.feature.apiregions.factorycom.adobe.granite.toggle.monitor.systempropertyFuturas restricciones de propiedad de OSGi aplicadas future-restrictions-osgi-properties
En el futuro, Adobe aplicará las siguientes restricciones a las propiedades de OSGi. Para los PID mencionados, solo se permite configurar las propiedades enumeradas.
com.day.cq.mailer.DefaultMailServicesmtp.hostsmtp.portsmtp.usersmtp.passwordfrom.addresssmtp.sslsmtp.starttlssmtp.requiretlsdebug.emailoauth.floworg.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.commons.log.levelorg.apache.sling.commons.log.namesorg.apache.sling.commons.log.additivcom.day.cq.commons.impl.ExternalizerImplexternalizer.domainsexternalizer.encodedpathexternalizer.hostexternalizer.contextpathRestricciones de propiedad de OSGi restrictions-osgi-properties
Los valores de estas propiedades de OSGi están restringidos a las reglas que se describen a continuación.
org.apache.felix.eventadmin.impl.EventAdminorg.apache.felix.eventadmin.ThreadPoolSizeorg.apache.felix.eventadmin.AsyncToSyncThreadRatioorg.apache.felix.eventadmin.AsyncToSyncThreadRatioorg.apache.felix.eventadmin.RequireTopicorg.apache.felix.eventadmin.IgnoreTimeoutorg.apache.felix*, org.apache.sling*, come.day*, com.adobe*org.apache.felix.eventadmin.IgnoreTopicorg.apache.felix.httporg.apache.felix.http.timeoutorg.apache.felix.http.session.timeoutorg.apache.felix.http.jetty.threadpool.maxorg.apache.felix.http.jetty.headerBufferSizeorg.apache.felix.http.jetty.requestBufferSizeorg.apache.felix.http.jetty.responseBufferSizeorg.apache.felix.http.jetty.maxFormSizeorg.apache.felix.https.jetty.session.cookie.httpOnlyorg.apache.felix.https.jetty.session.cookie.secureorg.eclipse.jetty.servlet.SessionIdPathParameterNameorg.eclipse.jetty.servlet.CheckingRemoteSessionIdEncodingorg.eclipse.jetty.servlet.SessionCookieorg.eclipse.jetty.servlet.SessionDomainorg.eclipse.jetty.servlet.SessionPathorg.eclipse.jetty.servlet.MaxAgeorg.eclipse.jetty.servlet.SessionScavengingIntervalorg.apache.felix.jetty.gziphandler.enableorg.apache.felix.jetty.gzip.minGzipSizeorg.apache.felix.jetty.gzip.compressionLevelorg.apache.felix.jetty.gzip.inflateBufferSizeorg.apache.felix.jetty.gzip.syncFlushorg.apache.felix.jetty.gzip.excludedUserAgentsorg.apache.felix.jetty.gzip.includedMethodsorg.apache.felix.jetty.gzip.excludedMethodsorg.apache.felix.jetty.gzip.includedPathsorg.apache.felix.jetty.gzip.excludedPathsorg.apache.felix.jetty.gzip.includedMimeTypesorg.apache.felix.http.session.invalidateorg.apache.felix.http.session.container.attributeorg.apache.felix.http.session.uniqueidorg.apache.sling.scripting.cacheorg.apache.sling.scripting.cache.sizeorg.apache.sling.scripting.cache.additional_extensionsorg.apache.sling.engine.impl.log.RequestLoggerrequest.log.outputrequest.log.outputtyperequest.log.entry.formatrequest.log.exit.formatrequest.log.enabledaccess.log.outputaccess.log.outputtypeaccess.log.enabledorg.apache.sling.servlets.resolver.SlingServletResolverservletresolver.servletRootservletresolver.cacheSizeservletresolver.pathsservletresolver.defaultExtensionsservletresolver.mountProvidersservletresolver.scriptUserActualización de Java Runtime a la versión 21 java-runtime-update-21
Adobe Experience Manager as a Cloud Service ha realizado la transición al tiempo de ejecución de Java 21. Para garantizar la compatibilidad, es esencial actualizar las versiones de la biblioteca tal como se describe en Requisitos de tiempo de ejecución.