Remplacer AEM « AdaptiveImageServletMappingConfigurationFactory » pour la prise en charge de WebP

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

Le composant Image de Adobe Experience Manager (AEM) ne génère pas de ressources WebP, sauf si la configuration AdaptiveImageServletMappingConfigurationFactory inclut l’extension WebP. Le déploiement d’une configuration personnalisée à l’aide des noms et des emplacements par défaut échoue, car AEM continue d’appliquer ses paramètres prêts à l’emploi. Pour résoudre ce problème, renommez le fichier de configuration, placez-le dans le dossier approprié et redéployez votre package.

Description description

Environnement

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

Problème/Symptômes

Le composant d’image AEM n’effectue pas le rendu des images WebP sur les pages.
Une configuration personnalisée destinée à ajouter la prise en charge de WebP est ignorée après le déploiement.
Le système continue à appliquer les paramètres de AdaptiveImageServletMappingConfigurationFactory par défaut au lieu de la configuration personnalisée.
Les ressources d’image WebP restent indisponibles même après le déploiement du fichier de configuration mis à jour.

Résolution resolution

Pour résoudre ce problème, procédez comme suit :

Accédez à Outils > Opérations > Console Web > system/console/configMgr sur l’instance d’auteur AEM 6.5 AMS…
Recherchez AdaptiveImageServletMappingConfigurationFactory, puis ouvrez et copiez la configuration pour com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.
Créez ou renommez le fichier de configuration basé sur le code en tant que com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json.
Dans ce fichier, incluez webp dans la propriété des extensions de fichier, par exemple : "fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"].
Placez ce fichier sous le dossier du mode d’exécution de création dans votre base de code, par exemple : .../apps/<project>/config.author/ (et config.publish/ similaire si nécessaire pour la publication).
Redéployez le package de code.
Après le déploiement, vérifiez dans /system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg est actif et sa liste d’extensions de fichiers contient webp.

Lecture connexe

Servlet Image adaptative dans le guide des composants principaux d’AEM
Diffusion d’images optimisées pour le web dans le guide des composants principaux d’AEM

recommendation-more-help

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