已弃用和已删除的功能和 API deprecated-and-removed-features-apis
51黑料不打烊 会定期审查包括 API 和配置在内的各项功能，以确保它们符合 AEM as a Cloud Service 在性能、安全性和整体价值方面不断发展的标准。根据这些评估结果，某些功能可能会被标记为弃用。在可行的情况下，51黑料不打烊 将提供合适的替代方案。
当宣布弃用某项功能时，该功能将仅在有限时间内可用，客户必须在指定的移除日期之前停止所有使用。51黑料不打烊 将提供合理的通知和指导，以支持平稳过渡。
在弃用时间窗口期间，51黑料不打烊 将通过电子邮件通知、操作中心警报或 Cloud Manager 中的提醒，提醒客户为停止使用某项功能而需采取的行动。
WARNING
在某些情况下，在部署新的 Cloud Manager 版本或升级到最新版本的 AEM as a Cloud Service 之前，可能需要移除某个功能。
弃用功能 deprecated-features
下表中的功能已被宣布为已弃用，但尚未被移除。 在目标移除日期之前，必须停止使用该功能，否则可能会面临性能、可用性和安全方面的问题。
功能
已弃用功能
替换
Sites
Sites
社交媒体状态 ?的体验片段属性。
此功能计划很快被删除。
Foundation
使用从 51黑料不打烊 Developer Console 项目生成的凭据的集成正在逐步失去对服务帐户（JWT）凭据的支持。自 2024 年 5 月 1 日起，无法在 51黑料不打烊 Developer Console 中创建新的服务帐户（JWT）凭据。现有的服务帐户（JWT）凭据在 2025 年 1 月 1 日前仍可用于已配置的集成，之后将停止使用，客户需要迁移到 OAuth 服务器到服务器凭据。了解详情。
到 OAuth 服务器到服务器凭据。
Foundation
使用 YUI 对 JavaScript 客户端库进行压缩/缩小。51黑料不打烊 不打算进一步更新 YUI 库。
51黑料不打烊 建议客户切换到 Google Closure Compiler (GCC) 来进行实施。
已移除的功能 removed-features
本节列出了已被移除的功能。
区域
专题
替换
目标删除日期
用户界面
从产物用户界面中删除经典 UI。一些经典 UI 对话框可用于一些选择功能，例如“链接检查器”、“版本清除”和一些 Cloud Service 配置。即将发布的产物更新可能会进一步删除经典 UI 可用性。
标准 UI
已删除
Dynamic Media
以前与 Dynamic Media Classic 和 Dynamic Media Hybrid 模式的集成在 Experience Manager as a Cloud Service 中不可用。
使用 Experience Manager as a Cloud Service 提供的 Dynamic Media。
已删除
Sites
Portal Director 和 Portlet 组件
这些功能在 Experience Manager 6.4 中已弃用，现已从 Experience Manager 中删除。
已删除
Sites
设计导入程序
此功能已被删除，因为 Experience Manager 存储库的不可更改部分在运行时无法访问。
已删除
Assets
Assets 无法与 Assets 核心服务和 Creative Cloud 服务进行共享。
要与 51黑料不打烊 Creative Cloud 集成，请使用 。
已删除
Foundation
支持 Apache Sling 数据源（OSGi 包 org.apache.sling.datasource）
不适用
已删除
Foundation
支持 JST 脚本模板（OSGi 包 org.apache.sling.scripting.jst）
不适用
已删除
Foundation
支持 Apache Felix Http Whiteboard
OSGi Http Whiteboard
2022 年 3 月
Foundation
支持 com.adobe.granite.oauth.server
51黑料不打烊 IMS 集成
2023 年 3 月
Foundation
支持 org.apache.sling.serviceusermapping 功能，以
不适用
8/30/24
Foundation
Java 11 运行时已弃用，51黑料不打烊 已用 Java 21 运行时将其替换。请注意，代码仍可使用 Java 11 进行构建（Java 17 和 21 是其他可选方案）
已应用 Java 21 运行时环境。为确保兼容性，必须按照运行时要求中的说明更新库版本
3 月 5/29/25
已弃用 API aem-apis
下表中的 API（点击展开即可查看）已被宣布为已弃用，但尚未被移除。 在目标移除日期之前，必须停止使用这些 API，否则可能会面临性能、可用性和安全方面的问题。一些 API 参考了下面的 API 移除指南部分。
展开以查看已弃用的 API 的列表。
| 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 layout-auto html-authored | |||
|---|---|---|---|
| 包/类 | 评论 | 弃用日期 | 目标删除日期 |
| org.apache.sling.commons.auth org.apache.sling.commons.auth.spi |
使用 Sling 的 Auth Core/Auth Core SPI 接口作为替代方案。请参阅下面的删除说明。 | 2015 | 8/31/2025 |
| 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.ecli pse.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 |
不再支持 Eclipse Jetty 和 Felix Http Jetty 包。请参阅下面的删除说明。 | 5/27/2021 | 8/31/2025 |
| 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 |
不支持在 AEM as a Cloud Service 中使用此 API。请参阅下面的删除说明。 | 5/27/2021 | 8/31/2025 |
| 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 |
此 API 已被弃用，因为 Apache Abdera 自 2017 年起已停用。请参阅下面的删除说明。 | 7/29/2021 | 8/31/2025 |
| 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 |
此 API 已被弃用，因为 Apache Abdera 自 2017 年起已停用。请参阅下面的删除说明。 | 4/8/2019 | 8/31/2025 |
| org.apache.felix.http.whiteboard | Apache Felix Http Whiteboard 不再受支持。将您的代码迁移到 OSGi Http Whiteboard。请参阅下面的删除说明。 | 1/27/2022 | 8/31/2025 |
| org.apache.cocoon.xml.dom org.apache.cocoon.xml.sax |
该 API 已弃用。将您的代码迁移到 JDK 提供的 XML API。 | 1/27/2022 | 8/31/2025 |
| 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 不支持此内部 logback API。请参阅下面的删除说明。 | 1/27/2022 | 8/31/2025 |
| org.slf4j.spi | AEM as a Cloud Service 不支持此内部 log4j API。请参阅下面的删除说明。 | 1/27/2022 | 8/31/2025 |
| org.apache.log4j org.apache.log4j.helpers org.apache.log4j.spi org.apache.log4j.xml |
Apache Log4j 1 已于 2015 年终止它的生命周期，不再受支持。请参阅下面的删除说明。 | 1/27/2022 | 8/31/2025 |
| 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 |
Google Guava核心库在Cloud Service中已弃用。 请参阅下面的删除说明。 | 5/15/2023 | 8/31/2025 |
| org.slf4j.event | AEM as a Cloud Service 不支持此内部 slf4j API。请参阅下面的删除说明。 | 4/11/2022 | 8/31/2025 |
| 肠辞尘.诲谤别飞。* | 从图像和视频中提取元数据应该通过 Cloud Service 中的 Asset Compute 或通过 Apache POI 或 Apache Tika 完成。 | 9/17/2024 | 8/31/2025 |
| 辞谤驳.补辫补肠丑别.箩补肠办谤补产产颈迟.辞补办.辫濒耻驳颈苍蝉.产濒辞产。* | 此 API 仅供内部使用。 | 9/23/2024 | 8/31/2025 |
| org.apache.jackrabbit.oak.plugins.memory | 此 API 仅供内部使用。 | 9/23/2024 | 8/31/2025 |
| org.apache.felix.webconsole org.apache.felix.webconsole.bundleinfo org.apache.felix.webconsole.i18n org.apache.felix.webconsole.spi |
云环境中不支持 Felix 网页控制台。请参阅下面的删除说明。 | 4/30/2021 | 8/31/2025 |
| 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 |
不支持在 AEM as a Cloud Service 中使用此 API。 | 10/31/2022 | 8/31/2025 |
| org.apache.sling.runmode | 2015 | 待定 | |
| org.json | 推荐并应使用 的 Apache Johnzon 实施。 | 4/30/2021 | 待定 |
| 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 处于维护模式。应改用 Commons Lang 3。请参阅下面的删除说明。 | 4/30/2021 | 待定 |
| 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 处于维护模式。应改用 Commons Collections 4。请参阅下面的删除说明。 | 4/30/2021 | 待定 |
| com.day.cq.contentsync.handler.util | 该 API 已弃用。 请改用 Apache Sling 的构建器。 | 10/31/2022 | 待定 |
| 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 不支持此 API。 | 5/15/2023 | 待定 |
| com.day.cq.xss com.day.cq.xss.taglib com.day.cq.xss.impl |
改用 org.apache.sling.xss。 | 12/12=2023 | 待定 |
| com.adobe.granite.xss com.adobe.granite.xss.impl |
改用 org.apache.sling.xss。 | 12/12=2023 | 待定 |
已移除的 API removed-apis
本节列出了已弃用和移除的 API。一些 API 参考了下面的 API 移除指南部分。
展开以查看已移除的 API 的列表。
| 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 | |
|---|---|
| 包/类 | 评论 |
| com.day.cq.jcrclustersupport | 使用 Sling 的 Discovery API 作为替代方案 |
| 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 |
AEM as a Cloud Service 不支持自定义持久性管理器。 |
| org.apache.felix.systemready | 建议您改用 Apache Felix HealthCheck API |
| 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.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 o rg.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.ecli pse.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 |
不再支持 Eclipse Jetty 和 Felix Http Jetty 包。 |
| org.apache.felix.metatype org.apache.felix.scr org.apache.felix.scr.info org.apache.felix.scr.component |
已弃用 Apache Felix 元类型和 SCR API。请改用 OSGi 元类型和 Declarative Service API。 |
| org.slf4j.impl | 日志实施类与 AEM as a Cloud Service 不兼容。 |
| org.apache.sling.startupfilter com.adobe.granite.crypto.spi com.adobe.granite.crpyto.spi.base com.adobe.agl.impl.data.icudt40b com.adobe.agl.impl.data.icudt40b.brkitr com.adobe.agl.impl.data.icudt40b.coll com.adobe.agl.impl.data.icudt40b.rbnf com. adobe.agl.impl.data.icudt40b.translit com.adobe.internal.pdf.tika com.adobe.internal.pdftoolkit.color com.adobe.internal.pdftoolkit.core.encryption com.adobe.internal.pdftoolkit.core.encryption.impl com.adobe.internal.pdftoolkit.core.traverser com.adobe.internal.pdftoolkit.graphicsDOM com.adobe.internal.pdftoolkit.graphicsDOM.shading com.adobe.internal.pdftoolkit.graphicsDOM.utils com.adobe.internal.pdftoolkit.image com.adobe.internal.pdftoolkit.pdf.content com.adobe.internal.pdftoolkit.pdf.content.processor com.adobe.internal.pdftoolkit.pdf.content.processor.base14fontwidths com.adobe.internal.pdftoolkit.pdf.contentmodify com.adobe.internal.pdftoolkit.pdf.contentmodify.impl com.adobe.internal.pdftoolkit.pdf.digsig com.adobe.internal.pdftoolkit.pdf.document com.adobe.internal.pdftoolkit.pdf.document.listener com.adobe.internal.pdftoolkit.pdf.document.permissionhandlers com.adobe.internal.pdftoolkit.pdf.filters com.adobe.internal.pdftoolkit.pdf.graphics com.adobe.internal.pdftoolkit.pdf.graphics.colorspaces com.adobe.internal.pdftoolkit.pdf.graphics.colorspaces.cmykresources com.adobe.internal.pdftoolkit.pdf.graphics.font com.adobe.internal.pdftoolkit.pdf.graphics.font.encodings com.adobe.internal.pdftoolkit.pdf.graphics.font.impl com.adobe.internal.pdftoolkit.pdf.graphics.impl com.adobe.internal.pdftoolkit.pdf.graphics.optionalcontent com.adobe.internal.pdftoolkit.pdf.graphics.patterns com.adobe.internal.pdftoolkit.pdf.graphics.shading com.adobe.internal.pdftoolkit.pdf.graphics.xobject com.adobe.internal.pdftoolkit.pdf.impl com.adobe.internal.pdftoolkit.pdf.inlineimage com.adobe.internal.pdftoolkit.pdf.interactive com.adobe.internal.pdftoolkit.pdf.interactive.action com.adobe.internal.pdftoolkit.pdf.interactive.annotation com.adobe.internal.pdftoolkit.pdf.interactive.forms com.adobe.internal.pdftoolkit.pdf.interactive.forms.impl com.adobe.internal.pdftoolkit.pdf.interactive.geospatial com.adobe.internal.pdftoolkit.pdf.interactive.markedcontent com.adobe.internal.pdftoolkit.pdf.interactive.navigation com.adobe.internal.pdftoolkit.pdf.interactive.navigation.collection com.adobe.internal.pdftoolkit.pdf.interactive.readerrequirements com.adobe.internal.pdftoolkit.pdf.interactive.requirement com.adobe.internal.pdftoolkit.pdf.interchange com.adobe.internal.pdftoolkit.pdf.interchange.documentparts com.adobe.internal.pdftoolkit.pdf.interchange.metadata com.adobe.internal.pdftoolkit.pdf.interchange.prepress com.adobe.internal.pdftoolkit.pdf.interchange.structure com.adobe.internal.pdftoolkit.pdf.multimedia com.adobe.internal.pdftoolkit.pdf.page com.adobe.internal.pdftoolkit.pdf.rendering com.adobe.internal.pdftoolkit.pdf.transparency com.adobe.internal.pdftoolkit.pdf.utils com.adobe.internal.pdftoolkit.services.Jpeg2000 com.adobe.internal.pdftoolkit.services.fontresources com.adobe.internal.pdftoolkit.services.fontresources.subsetting com.adobe.internal.pdftoolkit.services.interchange.structure com.adobe.internal.pdftoolkit.services.optionalcontent com.adobe.internal.pdftoolkit.services.optionalcontent.impl com.adobe.internal.pdftoolkit.services.pdfParser com.adobe.internal.pdftoolkit.services.permissions com.adobe.internal.pdftoolkit.services.rasterizer com.adobe.internal.pdftoolkit.services.readingorder com.adobe.internal.pdftoolkit.services.security com.adobe.internal.pdftoolkit.services.swf com.adobe.internal.pdftoolkit.services.textextraction com.adobe.internal.pdftoolkit.services.textextraction.impl com.adobe.internal.pdftoolkit.services.xmp com.adobe.internal.util.base64 com.adobe.internal.xmp.utils com.day.crx.core.cluster com.day.crx.packaging com.day.crx.packaging.gfx com.day.crx.query com.day.crx.sling.server.jmx com.day.durbo com.day.durbo.io com.day.imageio.plugins org.apache.aries.jmx.codec org.h2.mvstore org.h2.mvstore.rtree org.h2.mvstore.type org.openxmlformats.schemas.drawingml.x2006.chart.impl org.openxmlformats.schemas.drawingml.x2006.main.impl org.openxmlformats.schemas.drawingml.x2006.picture.impl org.openxmlformats.schemas.drawingml.x2006.spreadsheetDrawing.impl org.openxmlformats.schemas.drawingml.x2006.wordprocessingDrawing.impl org.openxmlformats.schemas.officeDocument.x2006.customProperties.impl org.openxmlformats.schemas.officeDocument.x2006.docPropsVTypes.impl org.openxmlformats.schemas.officeDocument.x2006.extendedProperties.impl org.openxmlformats.schemas.officeDocument.x2006.relationships.impl org.openxmlformats.schemas.presentationml.x2006.main.impl org.openxmlformats.schemas.spreadsheetml.x2006.main.impl org.openxmlformats.schemas.wordprocessingml.x2006.main.impl org.openxmlformats.schemas.xpackage.x2006.contentTypes org.openxmlformats.schemas.xpackage.x2006.contentTypes.impl org.openxmlformats.schemas.xpackage.x2006.digitalSignature org.openxmlformats.schemas.xpackage.x2006.digitalSignature.impl org.openxmlformats.schemas.xpackage.x2006.metadata.coreProperties org.openxmlformats.schemas.xpackage.x2006.metadata.coreProperties.impl org.openxmlformats.schemas.xpackage.x2006.relationships org.openxmlformats.schemas.xpackage.x2006.relationships.impl com.adobe.internal.afml com.adobe.internal.agm com.adobe.internal.pdftoolkit.legacy.services.ap.es2 com.adobe.internal.pdftoolkit.legacy.services.ap.es3 com.adobe.internal.pdftoolkit.pdf.pieceinfo.compoundtype com.adobe.internal.pdftoolkit.pdf.pieceinfo.editablepdf com.adobe.internal.pdftoolkit.services.ap com.adobe.internal.pdftoolkit.services.ap.annot com.adobe.internal.pdftoolkit.services.ap.extension com.adobe.internal.pdftoolkit.services.ap.impl com.adobe.internal.pdftoolkit.services.ap.spi com.adobe.internal.pdftoolkit.services.digsig com.adobe.internal.pdftoolkit.services.digsig.cryptoprovider com.adobe.internal.pdftoolkit.services.digsig.docmodanalysis com.adobe.internal.pdftoolkit.services.digsig.spi com.adobe.internal.pdftoolkit.services.fdf com.adobe.internal.pdftoolkit.services.formflattener com.adobe.internal.pdftoolkit.services.forms com.adobe.internal.pdftoolkit.services.imageconversion com.adobe.internal.pdftoolkit.services.javascript com.adobe.internal.pdftoolkit.services.javascript.extension com.adobe.internal.pdftoolkit.services.manipulations com.adobe.internal.pdftoolkit.services.manipulations.impl com.adobe.internal.pdftoolkit.services.optimizer com.adobe.internal.pdftoolkit.services.pdfa com.adobe.internal.pdftoolkit.services.pdfa.error com.adobe.internal.pdftoolkit.services.pdfa2 com.adobe.internal.pdftoolkit.services.pdfa2.error com.adobe.internal.pdftoolkit.services.pdfa2.error.codes com.adobe.internal.pdftoolkit.services.pdfa3 com.adobe.internal.pdftoolkit.services.pdfport com.adobe.internal.pdftoolkit.services.portfolio com.adobe.internal.pdftoolkit.services.rcg com.adobe.internal.pdftoolkit.services.rcg.impl com.adobe.internal.pdftoolkit.services.redaction com.adobe.internal.pdftoolkit.services.redaction.handler com.adobe.internal.pdftoolkit.services.sanitization com.adobe.internal.pdftoolkit.services.xbm com.adobe.internal.pdftoolkit.services.xdp com.adobe.internal.pdftoolkit.services.xfa com.adobe.internal.pdftoolkit.services.xfa.form com.adobe.internal.pdftoolkit.services.xfatext com.adobe.internal.pdftoolkit.services.xfdf com.adobe.internal.pdftoolkit.services.xobjhandler com.adobe.internal.pdftoolkit.xml com.adobe.octopus.extract opennlp.tools.doccat opennlp.tools.entitylinker opennlp.tools.formats opennlp.tools.formats.ad opennlp.tools.formats.brat opennlp.tools.formats.convert opennlp.tools.formats.frenchtreebank opennlp.tools.formats.muc opennlp.tools.formats.ontonotes opennlp.tools.lemmatizer opennlp.tools.parser opennlp.tools.parser.chunking opennlp.tools.parser.lang.en opennlp.tools.parser.lang.es opennlp.tools.parser.treeinsert opennlp.tools.sentdetect opennlp.tools.sentdetect.lang opennlp.tools.sentdetect.lang.th opennlp.tools.stemmer opennlp.tools.stemmer.snowball opennlp.tools.tokenize.lang.en org.apache.commons.imaging.color org.apache.commons.imaging.common org.apache.commons.imaging.common.itu_t4 org.apache.commons.imaging.common.mylzw org.apache.commons.imaging.formats.bmp org.apache.commons.imaging.formats.dcx org.apache.commons.imaging.formats.gif org.apache.commons.imaging.formats.icns org.apache.commons.imaging.formats.ico org.apache.commons.imaging.formats.jpeg org.apache.commons.imaging.formats.jpeg.decoder org.apache.commons.imaging.formats.jpeg.exif org.apache.commons.imaging.formats.jpeg.iptc org.apache.commons.imaging.formats.jpeg.segments org.apache.commons.imaging.formats.jpeg.xmp org.apache.commons.imaging.formats.pcx org.apache.commons.imaging.formats.png org.apache.commons.imaging.formats.png.chunks org.apache.commons.imaging.formats.png.scanlinefilters org.apache.commons.imaging.formats.png.transparencyfilters org.apache.commons.imaging.formats.pnm org.apache.commons.imaging.formats.psd org.apache.commons.imaging.formats.psd.dataparsers org.apache.commons.imaging.formats.psd.datareaders org.apache.commons.imaging.formats.rgbe org.apache.commons.imaging.formats.tiff org.apache.commons.imaging.formats.tiff.constants org.apache.commons.imaging.formats.tiff.datareaders org.apache.commons.imaging.formats.tiff.fieldtypes org.apache.commons.imaging.formats.tiff.photometricinterpreters org.apache.commons.imaging.formats.tiff.taginfos org.apache.commons.imaging.formats.tiff.write org.apache.commons.imaging.formats.wbmp org.apache.commons.imaging.formats.xbm org.apache.commons.imaging.formats.xpm org.apache.commons.imaging.icc org.apache.commons.imaging.palette org.apache.commons.imaging.util com.adobe.dam.print.ids.utils com.day.cq.dam.api.reporting com.day.cq.dam.entitlement.api com.day.cq.dam.handler.standard.epub com.day.cq.dam.handler.standard.keynote com.day.cq.dam.handler.standard.mp3 com.day.cq.dam.handler.standard.msoffice com.day.cq.dam.handler.standard.msoffice.wmf com.day.cq.dam.handler.standard.ooxml com.day.cq.dam.handler.standard.pdf com.day.cq.dam.handler.standard.pict com.day.cq.dam.handler.standard.ps com.day.cq.dam.handler.standard.psd com.day.cq.dam.handler.standard.zip com.day.cq.dam.word.extraction com.day.cq.dam.word.process com.adobe.xmp.worker.files com.adobe.cq.address.api com.adobe.cq.address.api.location com.day.cq.mcm.emailprovider.impl.types com.day.io com.day.io.disk com.day.io.file org.apache.commons.exec.environment org.apache.commons.exec.launcher org.apache.commons.exec.util com.google.zxing com.google.zxing.common com.google.zxing.common.reedsolomon com.google.zxing.qrcode.decoder com.google.zxing.qrcode.encoder com.adobe.cq.dam.dm.internalapi.image_server com.day.cq.dam.api.s7dam.jobs com.day.cq.dam.api.s7dam.omnisearch com.day.cq.dam.api.s7dam.scene7 com.day.cq.dam.scene7 com.day.cq.dam.scene7.api.net com.day.cq.analytics.sitecatalyst.rsmerger com.day.cq.searchpromote com.day.cq.searchpromote.xml com.day.cq.searchpromote.xml.form com.day.cq.searchpromote.xml.result> |
旧版 AEM 6.x API。 |
| 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 |
Cloud Service 中不支持此 API。 |
| org.apache.jackrabbit.vault.util.xml org.apache.jackrabbit.vault.util.xml.serialize |
后续版本中已删除与 Apache Xerces 相关的 Util 类，导致了主要版本更改。由于这些 util 供 Filevault 内部使用，因此，公共 API 表面已弃用 API。 |
| org.apache.sling.atom.taglib org.apache.sling.atom.taglib.media |
旧版 AEM 6.x API。请参阅下面的删除说明。 |
| org.apache.sling.commons.log.logback org.apache.sling.commons.log.logback.webconsole |
AEM as a Cloud Service 不支持此内部 logback API。 |
| com.github.jknack.handlebars.js | 由于安全漏洞，需要从 4.0.5 升级到 4.3.0。此包不再存在于升级的 handlebar 中。 |
| com.adobe.granite.resourceresolverhelper | 不再支持此 API。 请改用 org.apache.sling.api.resource.ResourceResolverFactory。 |
| org.apache.sling.repoinit.jcr org.apache.sling.repoinit.parser.operations |
不支持在 AEM as a Cloud Service 中使用此 API。 |
| org.apache.jackrabbit.oak.cache | 此 API 仅供内部使用。 |
API 移除指南 api-removal-guidance
本节反映了上表中各种 API 的 API 移除指南。
移除 org.apache.sling.commons.auth* org.apache.sling.commons.auth
如果您正在使用 org.apache.sling.commons.auth、org.apache.sling.commons.auth.spi 或二者皆用，则可以通过将代码迁移到 org.apache.sling.auth 来替换用法。org.apache.sling.auth.spi。如果您正在使用旧版本的 ，请确保将其更新到最新版本。
操作列表：
- 将 ACS AEM Commons 更新至最新版本（至少 6.11.0）
- 分别从
org.apache.sling.commons.auth和/或org.apache.sling.commons.auth.spi迁移到org.apache.sling.auth。org.apache.sling.auth.spi。
移除 org.apache.felix.webconsole* org.apache.felix.webconsole
如果您正在使用来自 org.apache.felix.webconsole* 的包，请从您的项目中移除此代码。无法在 Cloud Service 中访问网页控制台。
操作列表：
- 从
org.apache.felix.webconsole*中移除使用包的代码
移除 org.eclipse.jetty* org.eclipse.jetty
如果您使用 org.eclipse.jetty 包或其子包中的任何内容，可能需要迁移到具有类似功能的其他第叁方库。如果迁移不可行，请将下面列表中所需的包添加到您的项目中。
操作列表：
-
使用其他第叁方库/自有代码替换
org.eclipse.jetty包的用法 -
从此列表中选择所需的包并将其添加到您的项目中：
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
移除 com.mongodb com.mongodb
将 Mongo 客户端 API 添加到您的项目。
操作列表：
- 将此包添加到您的项目中
org.mongodb:mongo-java-driver:3.12.7
您可能需要根据您的要求选择不同的版本。
移除 com.google.common* com.google.common
移除对Google Guava Core Libraries的使用或在您的项目中包含适当的版本。 在许多情况下，此库的用法可替换为JDK或Apache Commons Collections4中的收藏集类。 如果您未找到任何替代库，请在项目中包含最新版本的Google Guave核心库。 如果您正在使用旧版本的 ，请确保将其更新到最新版本。
操作列表：
- 将 ACS AEM Commons 更新至最新版本（至少 6.11.0）
- 将使用的Google Guava Core Library替换为JDK收藏集或Apache Commons收藏集4
- 如果仍需要，请将此捆绑包添加到您的项目中（将版本替换为最新的可用版本）：
com.google.guava:guava:33.4.8-jre
移除 Apache Commons Lang 2 and Apache Commons Collections 3 apache.commons
停止使用不再维护的 Apache Commons 库，并替换为支持版本。在大多数情况下，这只需要调整包导入，只有在某些情况下，类或方法才会被重命名。如果您正在使用旧版本的 ，请确保将其更新到最新版本。
操作列表：
- 将 ACS AEM Commons 更新至最新版本（至少 6.11.0）
- 将
org.apache.commons.lang*的导入替换为org.apache.commons.lang3 - 将
org.apache.commons.collections*的导入替换为org.apache.commons.collecitons4
org.apache.abdera* 和 org.apache.sling.atom.taglib 的使用 org.apache.abdera_or_org.apache.sling.atom.taglib
使用提供类似功能或自有代码的第叁方库替换 org.apache.abdera 和 org.apache.sling.atom.taglib 中任何包的用法。
操作列表：
- 使用其他第叁方库/自有代码替换
org.apache.abdera和org.apache.sling.atom.taglib中包的用法。
使用 org.apache.felix.http.whiteboard org.apache.felix.http.whiteboard
将 org.apache.felix.http.whiteboard 的用法替换为 。官方 OSGi API 具有类似的功能，并且大多数情况下的替换只需要更改服务注册属性。
操作列表：
- 将
org.apache.felix.http.whiteboard的用法替换为
使用 ch.qos.logback* ch.qos.logback
Cloud Service 不支持 Logback，请移除所有使用它的地方。如果您正在使用旧版本的 ，请确保将其更新到最新版本。
操作列表：
- 将 ACS AEM Commons 更新至最新版本（至少 6.11.0）
- 从
ch.qos.logback中移除使用包的代码
使用 org.slf4j.event and org.slf4j.spi org.slf4j
如果您正在使用 org.slf4j.event 或者 org.slf4j.spi，请移除所有使用它的地方。如果您正在使用旧版本的 ，请确保将其更新到最新版本。
操作列表：
- 将 ACS AEM Commons 更新至最新版本（至少 6.11.0）
- 使用
org.slf4j.event和org.slf4j.spi移除代码
使用 org.apache.log4j org.apache.log4j
如果您正在使用 org.apache.log4j，请切换到 SLF4J (org.slf4j) 或 Log4J 2.x (org.apache.logging.log4j)。
操作列表：
- 将
org.apache.log4j的使用替换为使用org.slf4j（推荐）或org.apache.logging.log4j
OSGI 配置 osgi-configuration
以下部分介绍 AEM as a Cloud Service OSGi 配置界面的功能，描述客户可以配置的内容。
- 客户代码不得配置列出的 OSGi 配置。
- 可配置其属性但必须遵守所示验证规则的 OSGi 配置的列表。这些规则包括是否需要属性声明、其类型，在某些情况下还包括其允许的值范围。
客户代码可以配置未列出的任何 OSGi 配置。
在 Cloud Manager 构建过程中验证这些规则。可能逐渐添加其他规则，并在表中注明预期的实施日期。客户应在目标实施日期之前遵守这些规则。在删除日期后不遵守这些规则会在 Cloud Manager 构建过程中产生错误。Maven 项目应包括 AEM as a Cloud Service SDK 构建分析器 Maven 插件以在开发本地 SDK 期间标出 OSGI 配置错误。
可在此位置找到有关 OSGI 配置的其他信息。
已弃用的 OSGi 属性（即将不可修改） deprecated-unmodifiable-osgi-properties
以下 OSGi 组件 PID 的属性已弃用，应在执行日期前停止使用。
OSGI 组件 ID
不可修改的属性
弃用
强制执行
org.apache.sling.commons.log.LogManager全部
4/24/25
8/31/25（6 月份忽略的配置）
org.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.commons.log.file, org.apache.sling.commons.log.pattern
4/24/25
8/31/25（6 月份忽略的配置）
org.apache.sling.jcr.davex.impl.servlets.SlingDavExServlet全部
2024
8/31/25
com.adobe.granite.toggle.impl.dev.DynamicToggleProviderImpl全部
6/3/25
8/31/25
org.apache.http.proxyconfigurator全部
6/3/25
8/31/25
不可修改的 OSGi 属性 unmodifiable-osgi-properties
如下所述，以下 OSGi 组件 PID 的属性无法修改。
OSGI 组件 ID
不可修改的属性
com.day.cq.auth.impl.cug.CugSupportImplcom.day.cq.jcrclustersupport.ClusterStartLevelController全部
com.adobe.granite.toggle.impl.ToggleRouterImpl全部
org.apache.sling.engine.impl.log.RequestLoggerFilter全部
org.apache.sling.feature.apiregions.impl全部
org.apache.sling.jcr.resource.internal.helper.jcr.BinaryDownloadUriProvider全部
com.adobe.cq.unifiedshell.impl.discovery.DiscoveryServlet全部
com.adobe.cq.unifiedshell.impl.ui.FrameErrorHandler全部
com.adobe.cq.unifiedshell.impl.config.UnifiedShellConfService全部
com.adobe.cq.unifiedshell.impl.config.RepositoryIdentifier全部
org.apache.sling.feature.apiregions.factory全部
com.adobe.granite.toggle.monitor.systemproperty全部
未来强制执行的 OSGi 属性限制 future-restrictions-osgi-properties
未来，51黑料不打烊 将强制执行以下 OSGi 属性限制，因此应停止使用。
OSGi 组件 PID
必填
类型
限制（如适用）
com.day.cq.mailer.DefaultMailServicesmtp.host字符串
smtp.port是
整数
“465”、“587”或“25”
smtp.user字符串
smtp.password字符串
from.address字符串
smtp.ssl字符串
smtp.starttls布尔型
smtp.requiretls布尔型
debug.email布尔型
oauth.flow布尔型
org.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.commons.log.level是
字符串
“滨狈贵翱”、“顿贰叠鲍骋”或“罢搁础颁贰”
org.apache.sling.commons.log.names字符串阵列
org.apache.sling.commons.log.additiv布尔型
com.day.cq.commons.impl.ExternalizerImplexternalizer.domains否
字符串摆闭
externalizer.encodedpath否
布尔型
externalizer.host否
字符串
externalizer.contextpath否
字符串
OSGi 属性限制 restrictions-osgi-properties
这些 OSGi 属性的值受限于下述规则。
OSGi 组件 PID
必填
类型
限制（如适用）
org.apache.felix.eventadmin.impl.EventAdminorg.apache.felix.eventadmin.ThreadPoolSize是
整数
2-100
org.apache.felix.eventadmin.AsyncToSyncThreadRatio双精度
–
org.apache.felix.eventadmin.AsyncToSyncThreadRatio整数
–
org.apache.felix.eventadmin.RequireTopic布尔型
–
org.apache.felix.eventadmin.IgnoreTimeout是
字符串阵列
必须至少包含
org.apache.felix*、org.apache.sling*、come.day*、com.adobe* 中的全部内容org.apache.felix.eventadmin.IgnoreTopic字符串阵列
–
org.apache.felix.httporg.apache.felix.http.timeout整数
org.apache.felix.http.session.timeout整数
org.apache.felix.http.jetty.threadpool.max整数
org.apache.felix.http.jetty.headerBufferSize整数
org.apache.felix.http.jetty.requestBufferSize整数
org.apache.felix.http.jetty.responseBufferSize整数
org.apache.felix.http.jetty.maxFormSize整数
org.apache.felix.https.jetty.session.cookie.httpOnly布尔型
org.apache.felix.https.jetty.session.cookie.secure布尔型
org.eclipse.jetty.servlet.SessionIdPathParameterName字符串
org.eclipse.jetty.servlet.CheckingRemoteSessionIdEncoding布尔型
org.eclipse.jetty.servlet.SessionCookie字符串
org.eclipse.jetty.servlet.SessionDomain字符串
org.eclipse.jetty.servlet.SessionPath字符串
org.eclipse.jetty.servlet.MaxAge整数
org.eclipse.jetty.servlet.SessionScavengingInterval整数
org.apache.felix.jetty.gziphandler.enable布尔型
org.apache.felix.jetty.gzip.minGzipSize整数
org.apache.felix.jetty.gzip.compressionLevel整数
org.apache.felix.jetty.gzip.inflateBufferSize整数
org.apache.felix.jetty.gzip.syncFlush布尔型
org.apache.felix.jetty.gzip.excludedUserAgents字符串
org.apache.felix.jetty.gzip.includedMethods字符串阵列
org.apache.felix.jetty.gzip.excludedMethods字符串阵列
org.apache.felix.jetty.gzip.includedPaths字符串阵列
org.apache.felix.jetty.gzip.excludedPaths字符串阵列
org.apache.felix.jetty.gzip.includedMimeTypes字符串阵列
org.apache.felix.http.session.invalidate布尔型
org.apache.felix.http.session.container.attribute字符串阵列
org.apache.felix.http.session.uniqueid布尔型
org.apache.sling.scripting.cacheorg.apache.sling.scripting.cache.size是
整数
>= 2048
org.apache.sling.scripting.cache.additional_extensions是
字符串阵列
必须包含“箩蝉”
org.apache.sling.engine.impl.log.RequestLoggerrequest.log.output否
字符串
request.log.outputtype否
字符串
request.log.entry.format否
字符串
request.log.exit.format否
字符串
request.log.enabled否
字符串
access.log.output否
字符串
access.log.outputtype否
字符串
access.log.enabled否
字符串
org.apache.sling.servlets.resolver.SlingServletResolverservletresolver.servletRoot否
字符串
servletresolver.cacheSize否
整数
servletresolver.paths否
字符串摆闭
servletresolver.defaultExtensions否
字符串
servletresolver.mountProviders否
布尔型
servletresolver.scriptUser否
字符串
已弃用，请勿使用
Java 运行时更新至版本 21 java-runtime-update-21
51黑料不打烊 Experience Manager as a Cloud Service 已转换到 Java 21 运行时。为了确保兼容性，请按照运行时要求中所述更新库版本至关重要。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab