可持续升级 sustainable-upgrades

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Upgrading

创建对象：

Developer

CAUTION

AEM 6.4已结束扩展支持，本文档将不再更新。有关更多详细信息，请参阅技术支助期. 查找支持的版本此处.

自定义框架 customization-framework

架构（功能/基础架构/内容/应用程序） architecture-functional-infrastructure-content-application

自定义框架功能旨在帮助减少不友好升级的代码（如API）或内容（如叠加图）的不可扩展区域中的违规。

自定义框架有两个组件：the API Surface 和 内容分类.

API Surface api-surface

在以前的AEM版本中，许多API都通过Uber Jar公开。其中一些API并不打算由客户使用，但已公布到各种包中支持AEM功能。今后，Java API将标记为公共或专用，以向客户指示哪些API在升级环境中是安全的。其他具体细节包括：

标记为 Public 可供自定义实施包使用和引用。
公共API将向后兼容安装的兼容包。
兼容包将包含一个兼容性Uber JAR，以确保向后兼容
标记为 Private 仅供AEM内部包使用，不应供自定义包使用。

NOTE

的概念 Private 和 Public 在这方面，不应与Java关于公共和私人阶级的概念混淆。

image2018-2-12_23-52-48

内容分类 content-classifications

AEM长期以来一直使用叠加和Sling资源合并器的原理，以允许客户扩展和自定义AEM功能。支持AEM控制台和UI的预定义功能存储在 /libs. 客户永远不能修改下面的任何内容 /libs 但可以在 /apps 以叠加和扩展 /libs （有关更多信息，请参阅使用叠加进行开发）。在将AEM升级为 /libs 可能会发生更改，从而导致叠加功能以意外的方式中断。客户还可以通过继承来扩展AEM组件 sling:resourceSuperType，或只是在中引用组件 /libs 直接通过sling:resourceType。使用引用和覆盖用例可能会出现类似的升级问题。

为了让客户更安全、更轻松地了解 /libs 可以安全地在中使用和叠加内容 /libs 已通过以下混合进行了分类：

公共(granite:PublicArea) — 将节点定义为公共节点，以便它可以覆盖、继承( sling:resourceSuperType)或直接使用( sling:resourceType)。添加兼容包后，/libs下标记为“Public”的节点将安全升级。通常，客户应仅利用标记为“Public”的节点。
摘要(granite:AbstractArea) — 将节点定义为抽象。节点可以叠加或继承( sling:resourceSupertype)，但不得直接使用( sling:resourceType)。
最终(granite:FinalArea) — 将节点定义为最终节点。分类为最终节点的节点不能叠加或继承。最终节点可直接通过 sling:resourceType. 默认情况下，最终节点下的子节点被视为内部节点
内部(granite:InternalArea) — 将节点定义为内部节点。分类为内部的节点不能直接覆盖、继承或使用。这些节点仅用于AEM的内部功能
无注释 — 节点根据树层次结构继承分类。默认情况下，/ root为Public。 父项被分类为“内部”或“最终”的节点也将被视为“内部”。