由于客户端库资源中存在HTL编译错误,AEM Cloud Manager部署失败

✨ 此内容是AI生成的,可能不准确。 生成AI术语

本文介绍了当客户端库Cloud Manager资源中的JavaScript模板文本被AEM解析器错误解释时,如何解决因HTL编译错误导致的HTML部署失败。

描述 description

环境

  • Adobe Experience Manager (AEM) Cloud Manager(所有版本)

症状

在所有环境(开发、暂存和生产)的“部署”步骤中,Cloud Manager构建会失败。 管道日志显示客户端库资源文件中的HTL编译错误。 解析器报告错误,例如:

  • mismatched input '(' expecting {'}', '@'}

受影响的资源包括客户端库中的HTML文件,这些客户端库在.html文件中包含JavaScript模板文字表达式(例如,${getAccessToken()})。 这些表达式将解释为HTL表达式,从而导致在部署期间出现解析器错误。

原因

部署失败,因为.html客户端库资源中的JavaScript template-literal表达式(${...})被AEM解析器解释为HTL表达式,从而在HTL编译步骤期间导致语法错误。

解决方法 resolution

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

  1. 查看代码库中受影响的客户端库资源文件(例如,/apps/.../clientlibs/.../resources/中的HTML文件)。
  2. 在这.html个文件中使用${...}语法检查JavaScript模板文字表达式。
  3. 如果这些表达式用作JavaScript,请确保AEM解析器不会将它们解释为HTL表达式。
  4. 将包含模板文字的JavaScript代码移动到.js文件,而不是直接嵌入到.html资源中。 或者,转义或重构${...}语法以避免HTL解析冲突。
  5. 重新运行Cloud Manager管道,以验证HTL编译错误是否已解决。
recommendation-more-help
experience-cloud-kcs-help-kbarticles