在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
请按照以下步骤解决问题:
-
查看在版本
3.0.0和3.1.8之间的aem.js样板中引入的更改。 -
验证您的实施是否使用版本
3.1.0。 此发行版本引入了一项重大更改,从decorateSections()中删除了节元数据处理。 更改被识别为回归,并在版本3.1.1中恢复。 -
如果您的实施使用版本
3.1.0,请升级到版本3.1.1或更高版本,以还原分区元数据处理。 -
审阅版本
3.1.1中通过3.1.8引入的更改。 这些版本包括依赖项更新和次要修复,例如解决重复页眉和页脚块问题以及更新代码路径解析。 -
评估对实施的影响,并确认任何重大更改都不会影响发布、预览或块渲染工作流。 除了版本
3.1.0中的回归之外,在这些工作流中未发现任何重大更改。 -
在升级之前验证功能分支中的更改。 配置分支以使用预览环境,并在推送更新后的代码后查看更改。
-
在发布更改之前,在本地测试这些更改。 使用AEM CLI检索内容并验证更新。 以下命令可帮助您在发布之前查看更改:
code language-none aem content clone aem up aem content diff aem content push --dry-run -
为主分支配置分支保护规则,并在合并更改之前需要拉取请求、状态检查和最新分支。 这有助于确保在到达生产环境之前,在预览环境中审核并验证所有更改。
-
升级后,在本地和预览环境中彻底测试自定义块和脚本依赖关系,以验证兼容性。
-
验证在升级后,发布、预览、块渲染、节元数据处理、自定义块和脚本依赖项是否按预期运行。