开发核心组件 developing-core-components
何时使用核心组件? when-to-use-the-core-components
由于核心组件是全新的,并且具备多种优势,因此建议新的 AEM 项目使用这些组件。对于现有项目,可以考虑在进行更大型项目工作期间进行迁移,例如在重新品牌化或整体重构工作期间。
因此,Adobe 提供了以下建议:
如何使用核心组件获得成功 how-to-succeed
核心组件的功能强大、灵活且易于使用和自定义。遵循几个关键准则将确保成功实施带核心组件的项目。
迁移到核心组件
任何新项目应该使用核心组件实施。但是,现有组件通常具有广泛的基础组件实施。
从基础组件迁移 from-foundation
对现有项目进行较大的变动(例如,品牌再造或者整体重构)通常会提供迁移到核心组件的机会。为了协助此迁移,Adobe 提供了多种迁移工具,以鼓励采用核心组件和最新的 AEM 技术。
AEM 现代化工具可以轻松地实现下列转换:
- 静态模板到可编辑模板
- 设计配置到策略
- 基础组件到核心组件
- 经典 UI 到触控式 UI
有关这些工具用法的更多信息,请参阅相应文档。
通过移动到 AEM as a Cloud Service 进行迁移 via-aemaacs
由于 AEM as a Cloud Service 自动随最新版本的核心组件提供,在您从内部部署 AEM 安装迁移时,您需要在项目 pom.xml
文件中删除与核心组件的任何依赖关系。
您的代理组件仍然像以前一样工作,因为代理指向必需的超类型,而超类型路径中有版本。通过这种方法,只需要删除依赖关系,就可以使核心组件像内部部署一样在 AEMaaCS 中工作。
与任何其他 AEMaaCS 项目一样,您还需要将依赖关系添加到 AEM SDK jar。这并非特定于核心组件,但是必需的。
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
有关 AEMaaCS 项目的更多信息,请参阅文档 AEM 项目结构。
核心组件支持 core-component-support
核心组件是 AEM 的一个组成部分,依原样提供支持,并作为“快速入门”的一部分提供,须遵循相同的条款和条件。
与其他 AEM 产品功能一样,一般规则是:首先宣布组件将弃用,并且最早从以下 AEM 发行版本中删除。这为客户提供了至少一个发行周期的时间,在停止支持之前移到组件的新版本。
每个组件的版本都清楚地声明了其支持的 AEM 版本。当某个 AEM 版本不再受到支持时,该版本 AEM 的核心组件也不再受到支持。
有关组件自定义项支持的详细信息,请参阅自定义核心组件页面。
技术功能 technical-capabilities
下表概述了核心组件与基础组件的不同之处。
有关创作功能的详细信息以及可以预配置它们的选项,请参阅有关它们的创作页面。
组件列表 component-list
下表列出了可用的核心组件、其 API 的链接,并说明了它们取代的基础组件。
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
核心组件升级 upgrade-of-core-components
版本化组件的一个优点是,它允许将迁移到新 AEM 版本与迁移到新组件版本分隔开。此外,如果有新组件版本可用,它允许单独地将各个组件迁移到新版本。
迁移到新 AEM 版本不会影响核心组件的工作方式,前提是其版本也支持正在迁移到的新 AEM 版本。提供给核心组件使用的自定义项,只要不使用已经弃用或删除的 API,也不应受影响。
迁移到核心组件的新版本也不会影响组件的工作方式,但是可能会向页面作者引入新功能,在默认行为不符合需要时,可能需要模板编辑者进行一些配置。但是可能需要适应自定义项,有关详细信息,请参阅自定义核心组件页面。