Substituir AEM "AdaptiveImageServletMappingConfigurationFactory" para suporte a WebP

Last update: Tue Dec 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

O componente de Imagem da Adobe Experience Manager (AEM) não renderiza ativos WebP, a menos que a configuração AdaptiveImageServletMappingConfigurationFactory inclua a extensão WebP. A implantação de uma configuração personalizada usando nome e local padrão falha, pois o AEM continua aplicando suas configurações prontas para uso (OOTB). Para resolver o problema, renomeie o arquivo de configuração, coloque-o na pasta correta e reimplante o pacote.

Descrição description

Ambiente

Adobe Experience Manager (AEM) Managed Services, v6.5 - Sites

Problema/Sintomas

O componente de Imagem do AEM não renderiza imagens WebP em páginas.
Uma configuração personalizada destinada a adicionar suporte a WebP é ignorada após a implantação.
O sistema continua aplicando as configurações padrão de AdaptiveImageServletMappingConfigurationFactory em vez da configuração personalizada.
Os ativos de imagem WebP permanecem indisponíveis mesmo após a implantação do arquivo de configuração atualizado.

Resolução resolution

Siga estas etapas para resolver o problema:

Navegue até Ferramentas > Operações > Console da Web > system/console/configMgr na instância de autor do AMS para AEM 6.5.
Pesquise por AdaptiveImageServletMappingConfigurationFactory, abra e copie a configuração de com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.
Crie ou renomeie o arquivo de configuração baseada em código como com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json.
Neste arquivo, inclua webp na propriedade de extensões de arquivo, por exemplo: "fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"].
Coloque este arquivo na pasta de modo de execução do autor em sua base de código, por exemplo: .../apps/<project>/config.author/ (e de forma semelhante config.publish/, se necessário para publicação).
Reimplante o pacote de código.
Após a implantação, verifique se em /system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg está ativo e se sua lista de extensões de arquivo contém webp.

Leitura relacionada

Servlet de imagem adaptável no Guia dos Componentes principais do AEM
Entrega de imagens otimizadas para a Web no Guia dos Componentes principais do AEM

recommendation-more-help

3d58f420-19b5-47a0-a122-5c9dab55ec7f