Escludi AEM "AdaptiveImageServletMappingConfigurationFactory" per il supporto WebP

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

Il componente Immagine di Adobe Experience Manager (AEM) non esegue il rendering delle risorse WebP a meno che la configurazione AdaptiveImageServletMappingConfigurationFactory non includa l'estensione WebP. La distribuzione di una configurazione personalizzata utilizzando la denominazione e la posizione predefinite non riesce perché AEM continua ad applicare le impostazioni predefinite. Per risolvere il problema, rinomina il file di configurazione, inseriscilo nella cartella corretta e ridistribuisci il pacchetto.

Descrizione description

Ambiente

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

Problema/Sintomi

Il componente Immagine di AEM non esegue il rendering delle immagini WebP sulle pagine.
Una configurazione personalizzata con lo scopo di aggiungere il supporto WebP viene ignorata dopo la distribuzione.
Il sistema continua ad applicare le impostazioni AdaptiveImageServletMappingConfigurationFactory predefinite invece della configurazione personalizzata.
Le risorse immagine WebP rimangono non disponibili anche dopo la distribuzione del file di configurazione aggiornato.

Risoluzione resolution

Per risolvere il problema, effettua le seguenti operazioni:

Passa a Strumenti > Operazioni > Console Web > system/console/configMgr nell'istanza di authoring AMS di AEM 6.5.
Cerca AdaptiveImageServletMappingConfigurationFactory, quindi apri e copia la configurazione per com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.
Creare o rinominare il file di configurazione basato su codice come com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json.
In questo file, includere webp nella proprietà delle estensioni di file, ad esempio: "fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"].
Posiziona questo file nella cartella della modalità di esecuzione dell'autore nel codebase, ad esempio: .../apps/<project>/config.author/ (e allo stesso modo config.publish/ se necessario per la pubblicazione).
Ridistribuisci il pacchetto di codice.
Dopo la distribuzione, verificare che in /system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg sia attivo e che l'elenco delle estensioni di file contenga webp.

Lettura correlata

Adaptive Image Servlet nella guida dei componenti core di AEM
Consegna di immagini ottimizzate per il web nella Guida dei componenti core di AEM

recommendation-more-help

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