可持续升级 sustainable-upgrades

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

Customization Framework customization-framework

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

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

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

API表面 api-surface

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

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

NOTE

不应混淆此上下文中Private和Public的概念与公共类和私有类的Java™概念。

image2018-2-12_23-52-48

内容分类 content-classifications

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

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

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