可持续升级

自定义框架

体系结构（功能/基础架构/内容/应用程序）

Customization Framework功能旨在帮助减少代码（如API）或内容（如叠加图）的非可扩展区域中对升级不友好的违规。

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

API表面

在AEM的早期版本中，许多API通过Uber Jar公开。其中一些API不是为了供客户使用，而是为了支持捆绑包中的AEM功能。今后，Java API将标记为“公用”或“专用”，以向客户指示在升级环境中可以安全使用哪些API。其他具体包括：

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

注意

的概念 Private 和 Public 在这种情况下，不应混淆于Java的公共类和私有类的概念。

image2018-2-12_23-52-48

内容分类

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

为了让客户更安全、更轻松地了解 /libs 可以安全地使用和叠加中的内容 /libs 已分类为以下mixin：

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