文档AEM 6.5用户指南

叠加 overlays

Last update: Wed Apr 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Developer

Adobe Experience Manager (AEM)（以及之前的CQ）一直使用叠加原理来允许您扩展和自定义 控制台 和其他功能(例如， 页面创作)。

“叠加”是在许多上下文中使用的术语。 在此上下文中(扩展AEM)，叠加意味着采用预定义功能并将您自己的定义强加于此预定义功能之上（以自定义标准功能）。

在标准实例中，预定义功能保存在 /libs 推荐做法是在下定义您的叠加（自定义） /apps 分支。 AEM使用搜索路径来查找资源，首先搜索 /apps 分支，然后 /libs 分支( 可以配置搜索路径)。 此机制意味着您的叠加（以及其中定义的自定义项）具有优先级。

自AEM 6.0起，对叠加的实施和使用方式进行了更改：

  • AEM 6.0及更高版本 — 用于 Granite — 相关的叠加图（即触屏UI）

    • 方法

      • 重建适当的 /libs 结构 /apps.

        这不需要一对一的拷贝， Sling资源合并器 用于交叉引用所需的原始定义。 Sling资源合并器提供访问资源并将其与差异（差异）机制合并的服务。

      • 下 /apps，进行任何更改。

    • 优点

      • 对下的更改更加强健 /libs.
      • 仅重新定义所需的内容。

  • AEM 6.0之前的非Granite叠加和叠加

    • 方法

      • 复制内容来源 /libs 到 /apps

        复制整个子分支，包括资产。

      • 下 /apps，进行任何更改。

    • 缺点

      • 尽管当下面的内容发生更改时，您的更改不会丢失 /libs，您可能必须重新创建在下叠加中发生的某些更改 /apps.
CAUTION
此 Sling资源合并器 并且相关方法只能用于 Granite. 这意味着创建具有框架结构的叠加仅适用于支持触摸的标准用户界面。
其他区域（包括经典UI）的叠加包括复制相应的节点和整个子结构，然后进行所需的更改。

叠加是适用于许多更改的推荐方法，例如 配置控制台 或 在侧面板的资源浏览器中创建选择类别 （在创作页面时使用）。 它们必须是：

  • 不要 在中更改 /libs 分支​ ​您所做的任何更改都可能会丢失，因为每当您：

    • 在实例上升级
    • 应用修补程序
    • 安装功能包

  • 它们将您的更改集中在一个位置；您可以更轻松地跟踪、迁移、备份或调试更改（如有必要）。

配置搜索路径 configuring-the-search-paths

对于叠加图，交付的资源是检索到的资源和属性的汇总，具体取决于可以定义的搜索路径：

  • 资源 解析程序搜索路径 如 OSGi配置 对于 Apache Sling Resource Resolver Factory.

    • 搜索路径的自上而下顺序指示其各自的优先级。
    • 在标准安装中，主要缺省值为 /apps， /libs — 因此，此页面的 /apps 具有比以下项更高的优先级 /libs (也就是说， 叠加 它)。

  • 两个服务用户需要对脚本存储位置具有JCR：READ访问权限。 这些用户是： components-search-service(由com.day.cq.wcm.coreto用于访问/缓存组件)和sling-scripting（由org.apache.sling.servlets.resolver用于查找servlet）。

  • 还必须根据脚本放置位置（本示例中位于/etc、/libs或/apps下）来配置以下配置。

    code language-none 
    PID = org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl
resource.resolver.searchpath=["/etc","/apps","/libs"]
resource.resolver.vanitypath.whitelist=["/etc/","/apps/","/libs/","/content/"]

  • 最后，还必须配置Servlet解析程序（在本例中，还要添加/etc）

    code language-none 
    PID = org.apache.sling.servlets.resolver.SlingServletResolver
servletresolver.paths=["/bin/","/libs/","/apps/","/etc/","/system/","/index.servlet","/login.servlet","/services/"]

使用示例 example-of-usage

在以下情况下介绍了一些示例：

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2