AEM Forms向后兼容性和SDK更新对Adaptive Forms代理组件的影响
在Adobe Experience Manager (AEM) Forms中，组织通常使用项目拥有的代理组件来自定义自适应Forms。 可能会出现有关SDK更新如何影响这些自定义项以及Adobe的向后兼容性策略如何应用于自适应Forms组件版本的问题。 要解决此问题，请遵循支持的自定义实践并验证所有代理组件，然后再将更新提升至生产环境。
描述 description
环境
Adobe Experience Manager (AEM) as a Cloud Service（所有版本）
问题/症状
- 有关影响自定义代理组件或客户端库的次要SDK更新的问题。
- SDK更新后发现自定义代码受到影响的问题。
- 需要明确Adobe对自适应Forms组件版本的兼容性保证。
原因
如果对自适应Forms组件版本所做的次要或向后兼容更改依赖于内部或未记录的实施详细信息，则这些自定义可能会影响自定义代理组件。 Adobe的兼容性保证仅适用于有文档记录的扩展点和受支持的开箱即用行为，而不适用于内部结构或覆盖的资源。
解决方法 resolution
请按照以下步骤解决问题：
- 配置项目拥有的代理组件：使用项目拥有的代理组件和
sling:resourceSuperType引用所需的Adobe Adaptive Forms组件版本。 - 限制自定义组件更改：将自定义HTL和对话框更改最小化。 仅使用已记录的API、事件、选择器和扩展点。
- 创建项目拥有的客户端库：创建具有唯一类别名称的单独项目拥有的客户端库。
- 保护Adobe拥有的客户端库：避免覆盖或修改Adobe拥有的共享运行时库或依赖的客户端库。
- 验证自定义项：在将更新提升到生产环境之前，请验证较低环境中的所有自定义项。 在每个SDK或Forms组件更新后，对用于渲染、创作、验证、规则、预填充、提交、可访问性、客户端库加载和自定义JavaScript行为的所有代理组件和自定义进行回归测试。
- 验证和提升SDK更新：如果项目将Adaptive Forms核心组件版本作为依赖项进行管理，请先更新并将其部署到较低环境。 确认所有自定义代理组件和客户端库均按预期运行，然后通过标准部署过程将更新提升到更高的环境。
注释
- 向后兼容性适用于自适应Forms组件支持的开箱即用行为、记录的API和记录的扩展点。
- 错误修复和向后兼容的增强功能可以在现有组件版本中提供，前提是维护支持的合同。
- 新组件版本仅针对对受支持的行为或记录的扩展点进行的向后不兼容更改引入。
- 如果维护支持的合同，则实现详细信息（如HTL渲染、HTML和DOM结构、CSS类、JavaScript行为、客户端API、验证、规则执行、对话框和配置结构以及客户端库）可能会在同一组件版本中更改。
- 对于依赖于内部实施详细信息的自定义设置，如复制的HTL、私有DOM结构、无文档记录的选择器或覆盖的Adobe客户端库，我们不能保证这些设置不会受到次要更新的影响。
- Adobe管理的环境不提供单独的仅用于开发的自动升级交换机。
experience-cloud-kcs-help-kbarticles