在Adobe Experience Manager as a Cloud Service中升级aem.js样板

本文为在Adobe Experience Manager as a Cloud Service中升级aem.js样板提供了指南,其中重点说明了兼容性注意事项、工作流影响以及推荐的最佳实践。

描述 description

环境

Adobe Experience Manager as a Cloud Service(所有版本),aem.js样板v3.0.0-v3.1.8

问题/症状

  • 您要将上游更改合并到现有项目中的aem.js。
  • 在合并更改之前,您需要检查对自定义块、脚本、预览或发布的影响。

原因

AEM样板是一个入门项目。 对上游样板的更改不会自动更新现有项目;开发人员审核这些更改并将其集成到他们的项目存储库中。 项目特定行为属于aem.js以外的扩展,而不属于对库的本地修改。

解决方法 resolution

请按照以下步骤解决问题:

  1. 查看在版本3.0.0和3.1.8之间的aem.js样板中引入的更改。

  2. 验证您的实施是否使用版本3.1.0。 此发行版本引入了一项重大更改,从decorateSections()中删除了节元数据处理。 更改被识别为回归,并在版本3.1.1中恢复。

  3. 如果您的实施使用版本3.1.0,请升级到版本3.1.1或更高版本,以还原分区元数据处理。

  4. 审阅版本3.1.1中通过3.1.8引入的更改。 这些版本包括依赖项更新和次要修复,例如解决重复页眉和页脚块问题以及更新代码路径解析。

  5. 评估对实施的影响,并确认任何重大更改都不会影响发布、预览或块渲染工作流。 除了版本3.1.0中的回归之外,在这些工作流中未发现任何重大更改。

  6. 在升级之前验证功能分支中的更改。 配置分支以使用预览环境,并在推送更新后的代码后查看更改。

  7. 在发布更改之前,在本地测试这些更改。 使用AEM CLI检索内容并验证更新。 以下命令可帮助您在发布之前查看更改:

    code language-none
    aem content clone
    aem up
    aem content diff
    aem content push --dry-run
    
  8. 为主分支配置分支保护规则,并在合并更改之前需要拉取请求、状态检查和最新分支。 这有助于确保在到达生产环境之前,在预览环境中审核并验证所有更改。

  9. 升级后,在本地和预览环境中彻底测试自定义块和脚本依赖关系,以验证兼容性。

  10. 验证在升级后,发布、预览、块渲染、节元数据处理、自定义块和脚本依赖项是否按预期运行。

recommendation-more-help
experience-cloud-kcs-help-kbarticles