已過時和已移除的功能和 API deprecated-and-removed-features-apis

Adobe 會定期檢閱包括 API 和設定在內的功能,確保其符合 AEM as a Cloud Service 在效能、安全性和整體價值方面不斷演進的標準。根據這些評估,某些功能可能會標記為棄用。在可行的情況下,Adobe 會提供合適的替代方案。

當宣布棄用時,該功能便僅能再使用一定的期間,客戶必須在任何指定的移除日期之前移除所有使用。Adobe 會提供合理的通知和指引,支援您平穩地進行轉變。

在棄用的時間範圍內,Adobe 會透過電子郵件通知、行動中心警示,或 Cloud Manager 中的提醒功能,提醒客戶轉變為停止使用某項功能時所需採取的動作。

WARNING
在某些情況下,部署新的 Cloud Manager 版本或升級至最新版本的 AEM as a Cloud Service 之前,可能有必要移除某項功能。

棄用的功能 deprecated-features

以下表格中的功能已宣佈為棄用,但尚未被移除。必須在目標移除日期之前停止使用這些功能,否則您會面臨與效能、可用性和安全性相關之問題的風險。

功能
汰除功能
替代方案
Sites
Assets HTTP API 中的內容片段支援
透過 OpenAPI 傳遞 AEM 內容片段
以及
內容片段與內容片段模型管理 OpenAPI
Sites
PWA 功能
Sites
SPA 編輯器
AEM 中用於管理 Headless 內容的首選編輯器為:
- 通用編輯器,用於視覺化編輯。
- 內容片段編輯器,用於表單型編輯。
Sites
JavaScript Use API
Java Use API
Sites
社交媒體狀態 ​的體驗片段屬性。
此功能規劃於近日移除。
Sites
Experience Cloud 設定自動化
Sites
基於範例的簡單內容片段。
現在基於模型的結構化內容片段
Assets
處理所擷取影像的 DAM Asset Update 工作流程。
資產擷取現在使用資產微服務
Assets
直接將資產上傳到 Experience Manager。請參閱已過時的資產上傳 API
使用直接二進位上傳。如需技術詳細資訊,請參閱直接上傳 API
Assets
不支援 工作流程中的某些工作流程步驟DAM Asset Update,包括呼叫命令列工具,例如 ImageMagick.
資產微服務可取代許多工作流程。若要自訂處理程序,請使用後期處理工作流程
Assets
FFmpeg 影片轉碼。
若要產生 FFmpeg 縮圖,請使用資產微服務。若是 FFmpeg 轉碼,請使用 Dynamic Media
Foundation
複寫代理程式之「散發」索引標籤下的樹狀結構複寫使用者介面 (2021 年 9 月 30 日後移除)
管理發佈啟用樹狀工作流程步驟方法。
Foundation
複寫代理程式管理員畫面的「散發」標籤和複寫 API 無法用來複寫超過 10MB 的內容封裝。
管理發佈啟用樹狀工作流程步驟
Foundation
使用自 Adobe Developer Console 專案產生的憑證進行整合,已逐漸不再具備對服務帳戶 (JWT) 認證的支援。自 2024 年 5 月 1 日起,無法在 Adobe Developer Console 中建立新的服務帳戶 (JWT) 認證。現有的服務帳戶 (JWT) 認證在 2025 年 1 月 1 日之前仍可用於已設定的整合,之後將停止運作,且會要求客戶移轉至 OAuth 伺服器對伺服器認證。了解更多
移轉至 OAuth Server-to-Server 憑證。
Foundation
用於複寫內容階層的發佈內容樹狀工作流程和相關的發佈內容樹狀工作流程步驟。
使用啟用樹狀工作流程步驟,其效能更佳。
Foundation
使用 YUI 壓縮/縮小 JavaScript 用戶端資料庫。Adobe 不打算進一步更新 YUI 資料庫。
Adobe 建議客戶切換至 Google Closure Compiler (GCC) 來進行實施。

移除的功能 removed-features

本區段列出已移除的功能。

區域
功能
替代方案
目標移除日期
使用者介面
傳統 UI 已從產品使用者介面中移除。一些傳統 UI 對話框可用於一些選定的功能,例如連結檢查器、版本清除和一些 Cloud Service 設定。即將推出的產品更新可能會進一步移除傳統 UI 可用性。
標準 UI
已移除
Dynamic Media
先前與 Dynamic Media ClassicDynamic Media 混合模式整合無法在 Experience Manager as a Cloud Service中使用。
請使用 Dynamic Media (隨 Experience Manager as a Cloud Service 提供)。
已移除
Sites
Portal Director 和 Portlet 元件
這些功能在 Experience Manager 6.4 中已過時,並已從 Experience Manager 中移除。
已移除
Sites
Design Importer
此功能已移除,因為無法在執行階段存取 Experience Manager 存放庫的不可修改區段。
已移除
Assets
Assets 無法與 Assets 核心服務和 Creative Cloud 服務共用。
若要與 Adobe Creative Cloud 整合,請使用 Adobe Asset Link
已移除
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
Adobe IMS 整合
2023 年 3 月
Foundation
支援 org.apache.sling.serviceusermapping 功能以取得服務使用者 ID
不適用
2024 年 8 月 30 日
Foundation
Java 11 執行階段已棄用,且 Adobe 已將其替換為 Java 21 執行階段。請注意,仍然可以使用 Java 11 建置程式碼 (Java 17 和 21 是其他選項)
Java 21 執行階段已套用。為了確保相容性,請務必按照執行階段需求中所述更新資料庫版本。
3 月 2025 年 5 月 29 日

棄用的 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 年 2025/8/31
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
不再支援 Eclipse Jetty 和 Felix Http Jetty 套件。請參閱下面的移除說明。 2021/5/27 2025/8/31
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。請參閱下面的移除說明。 2021/5/27 2025/8/31
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 年以來已為淘汰專案。請參閱下面的移除說明。 2021/7/29 2025/8/31
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 年以來已為淘汰專案。請參閱下面的移除說明。 2019/4/8 2025/8/31
org.apache.felix.http.whiteboard 不再支援 Apache Felix Http Whiteboard。將您的程式碼移轉到 OSGi Http Whiteboard。請參閱下面的移除說明。 2022/1/27 2025/8/31
org.apache.cocoon.xml.dom
org.apache.cocoon.xml.sax
此 API 已過時。請將您的程式碼移轉至 JDK 提供的 XML API。 2022/1/27 2025/8/31
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。請參閱下面的移除說明。 2022/1/27 2025/8/31
org.slf4j.spi AEM as a Cloud Service 不支援此內部 log4j API。請參閱下面的移除說明。 2022/1/27 2025/8/31
org.apache.log4j
org.apache.log4j.helpers
org.apache.log4j.spi
org.apache.log4j.xml
Apache Log4j 1 已於 2015 年結束其生命週期,不再支援。請參閱下面的移除說明。 2022/1/27 2025/8/31
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
Cloud Service 中的 Google Guava Core Libraries 已過時。請參閱下面的移除說明。 2023/5/15 2025/8/31
org.slf4j.event AEM as a Cloud Service 不支援此內部 slf4j API。請參閱下面的移除說明。 2022/4/11 2025/8/31
com.drew.* 若要從影像和影片中擷取中繼資料,應透過 Cloud Service 中的 Asset Compute 或透過 Apache POI 或 Apache Tika 完成。 2024 年 9 月 17 日 2025/8/31
org.apache.jackrabbit.oak.plugins.blob。* 此 API 僅供內部使用。 2024/9/23 2025/8/31
org.apache.jackrabbit.oak.plugins.memory 此 API 僅供內部使用。 2024/9/23 2025/8/31
org.apache.felix.webconsole
org.apache.felix.webconsole.bundleinfo
org.apache.felix.webconsole.i18n
org.apache.felix.webconsole.spi
雲端環境不支援 Felix 網頁控制台。請參閱下面的移除說明。 2021/4/30 2025/8/31
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。 2022/10/31 2025/8/31
org.apache.sling.runmode 2015 待定
org.json 建議並應該使用 Apache Johnzon 的 javax.json 實作。 2021/4/30 待定
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。請參閱下面的移除說明。 2021/4/30 待定
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 處於維護模式。應該改用 Collections 4。請參閱下面的移除說明。 2021/4/30 待定
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。 2023/5/15 待定
com.day.cq.xss
com.day.cq.xss.taglib
com.day.cq.xss.impl
請改用 org.apache.sling.xss。 2023 年 12 月 12 日 待定
com.adobe.granite.xss
com.adobe.granite.xss.impl
請改用 org.apache.sling.xss。 2023 年 12 月 12 日 待定

移除的 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
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
不再支援 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 中繼類型和宣告式服務 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 類別已在後續版本中移除,導致主要版本變更。由於這些公用程式是供檔案保存庫內部使用,該 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 由於一項安全性弱點,Handlebars 必須從 4.0.5 升級到 4.3.0。此封裝不會再出現於升級後的 Handlebars 中。
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.authorg.apache.sling.commons.auth.spi,或兩者皆使用,可以分別透過將程式碼移轉至 org.apache.sling.auth 來取代。org.apache.sling.auth.spi。如果您使用的是舊版本的 ACS AEM Commons,請務必更新至最新版本。

動作清單:

  • 將 ACS AEM Commons 更新至最新版本 (至少應為 6.11.0)
  • org.apache.sling.commons.auth 和/或 org.apache.sling.commons.auth.spi 分別移轉至 org.apache.sling.authorg.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.v20240208
    • org.eclipse.jetty:jetty-http:9.4.54.v20240208
    • org.eclipse.jetty:jetty-io:9.4.54.v20240208
    • org.eclipse.jetty:jetty-security:9.4.54.v20240208
    • org.eclipse.jetty:jetty-servlet:9.4.54.v20240208
    • org.eclipse.jetty:jetty-server:9.4.54.v20240208
    • org.eclipse.jetty:jetty-util:9.4.54.v20240208
    • org.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 Core Library。如果您使用的是舊版本的 ACS AEM Commons,請務必更新至最新版本。

動作清單:

  • 將 ACS AEM Commons 更新至最新版本 (至少應為 6.11.0)
  • 使用 JDK 集合或 Apache Commons Collections4 取代 Google Guava Core Library 的使用
  • 如果仍然需要,請將此套件新增至您的專案 (以最新版本取代):
    • com.google.guava:guava:33.4.8-jre

移除 Apache Commons Lang 2 and Apache Commons Collections 3 apache.commons

移除未維護的 Apache Commons 資料庫使用,並以支援版本取代。在大多數情況下,只需要調整封裝匯入,唯有在某些情況下類別或方法才需要重新命名。如果您使用的是舊版本的 ACS AEM Commons,請務必更新至最新版本。

動作清單:

  • 將 ACS AEM Commons 更新至最新版本 (至少應為 6.11.0)
  • org.apache.commons.lang3 取代匯入 org.apache.commons.lang*
  • org.apache.commons.collecitons4 取代匯入 org.apache.commons.collections*

使用 org.apache.abdera*org.apache.sling.atom.taglib org.apache.abdera_or_org.apache.sling.atom.taglib

將使用來自 org.apache.abderaorg.apache.sling.atom.taglib 的任何封裝,取代為提供類似功能的第三方程式庫或您自己的程式碼。

動作清單:

  • 將使用來自 org.apache.abderaorg.apache.sling.atom.taglib 的封裝取代為其他第三方程式庫/自己的程式碼。

使用 org.apache.felix.http.whiteboard org.apache.felix.http.whiteboard

將使用 org.apache.felix.http.whiteboard 更換為 OSGi Http Whiteboard。官方 OSGi API 具備類似的功能,且更換通常只需要變更服務註冊屬性。

動作清單:

使用 ch.qos.logback* ch.qos.logback

Cloud Service 不支援 Logback,請移除其所有使用。如果您使用的是舊版本的 ACS AEM Commons,請務必更新至最新版本。

動作清單:

  • 將 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,請務必更新至最新版本。

動作清單:

  • 將 ACS AEM Commons 更新至最新版本 (至少應為 6.11.0)
  • 使用 org.slf4j.eventorg.slf4j.spi 移除程式碼

使用 org.apache.log4j org.apache.log4j

若您正在使用 org.apache.log4j 切換至 SLF4J (org.slf4j) 或 Log4J 2.x (org.apache.logging.log4j)。

動作清單:

  • 使用 org.slf4j (建議) 或 org.apache.logging.log4j 取代 org.apache.log4j 的使用

OSGI 設定 osgi-configuration

以下區段呈現 AEM as a Cloud Service OSGi 設定介面,說明客戶可以設定的內容。

  1. 客戶程式碼不得設定所列出的 OSGi 設定。
  2. 可以設定其屬性的 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
全部
2025/4/24
2025/8/31 (於 6 月忽略設定)
org.apache.sling.commons.log.LogManager.factory.config
org.apache.sling.commons.log.file、org.apache.sling.commons.log.pattern
2025/4/24
2025/8/31 (於 6 月忽略設定)
org.apache.sling.jcr.davex.impl.servlets.SlingDavExServlet
全部
2024
2025/8/31
com.adobe.granite.toggle.impl.dev.DynamicToggleProviderImpl
全部
2025/6/3
2025/8/31
org.apache.http.proxyconfigurator
全部
2025/6/3
2025/8/31

不可修改的 OSGi 設定 unmodifiable-osgi-properties

下列 OSGi 元件 PID 的屬性無法修改,因此無法設定。

OSGI 元件 ID
不可修改的屬性
com.day.cq.auth.impl.cug.CugSupportImpl
com.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

Adobe 未來將強制執行下列 OSGi 屬性限制。針對提及的 PID,僅允許設定已列出的屬性。

OSGi 元件 PID
必要
類型
限制 (如適用)
com.day.cq.mailer.DefaultMailService
smtp.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.config
org.apache.sling.commons.log.level
字串
「INFO」、「DEBUG」或「TRACE」
org.apache.sling.commons.log.names
字串陣列
org.apache.sling.commons.log.additiv
布林值
com.day.cq.commons.impl.ExternalizerImpl
externalizer.domains
字串[]
externalizer.encodedpath
布林值
externalizer.host
字串
externalizer.contextpath
字串

OSGi 屬性限制 restrictions-osgi-properties

這些 OSGi 屬性的值會受到下方所述之規則的限制。

OSGi 元件 PID
必要
類型
限制 (如適用)
org.apache.felix.eventadmin.impl.EventAdmin
org.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.http
org.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.cache
org.apache.sling.scripting.cache.size
整數
>= 2048
org.apache.sling.scripting.cache.additional_extensions
字串陣列
必須包含「js」
org.apache.sling.engine.impl.log.RequestLogger
request.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.SlingServletResolver
servletresolver.servletRoot
字串
servletresolver.cacheSize
整數
servletresolver.paths
字串[]
servletresolver.defaultExtensions
字串
servletresolver.mountProviders
布林值
servletresolver.scriptUser
字串
已棄用,請勿使用

Java Runtime 更新至 21 版 java-runtime-update-21

Adobe Experience Manager as a Cloud Service 已轉變為 Java 21 執行階段。為確保相容性,請務必按照執行階段需求中所述更新資料庫版本。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab