Dokumentation

Überschreiben von „AdaptiveImageServletMappingConfigurationFactory“ für AEM für WebP-Unterstützung

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

Die Bildkomponente von Adobe Experience Manager (AEM) rendert keine WebP-Assets, es sei denn, die AdaptiveImageServletMappingConfigurationFactory enthält die WebP-Erweiterung. Das Bereitstellen einer benutzerdefinierten Konfiguration mit der Standardbenennung und dem Standardspeicherort schlägt fehl, da AEM weiterhin die vordefinierten Einstellungen (OOTB) anwendet. Um das Problem zu beheben, benennen Sie die Konfigurationsdatei um, platzieren Sie sie im richtigen Ordner und stellen Sie Ihr Paket erneut bereit.

Beschreibung description

Umgebung

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

Problem/Symptome

  • Die AEM-Bildkomponente rendert keine WebP-Bilder auf Seiten.
  • Eine benutzerdefinierte Konfiguration, die WebP-Unterstützung hinzufügen soll, wird nach der Bereitstellung ignoriert.
  • Das System wendet weiterhin die standardmäßigen AdaptiveImageServletMappingConfigurationFactory anstelle der benutzerdefinierten Konfiguration an.
  • Die WebP-Bild-Assets bleiben auch nach Bereitstellung der aktualisierten Konfigurationsdatei nicht verfügbar.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Navigieren Sie zu Tools > Vorgänge > Web-Konsole > system/console/configMgr auf der AEM 6.5 AMS-Autoreninstanz…
  2. Suchen Sie nach AdaptiveImageServletMappingConfigurationFactory, öffnen Sie dann und kopieren Sie die Konfiguration für com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.
  3. Erstellen Sie die Code-basierte Konfigurationsdatei oder benennen Sie sie in com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json um.
  4. Schließen Sie in dieser Datei WebP in die Dateierweiterungseigenschaft ein, z. B.: "fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"].
  5. Platzieren Sie diese Datei im Ordner „author-Ausführungsmodus“ in Ihrer Codebasis, z. B.: .../apps/<project>/config.author/ (und ähnlich config.publish/ bei Bedarf für die Veröffentlichung).
  6. Stellen Sie das Code-Paket erneut bereit.
  7. Überprüfen Sie nach der Bereitstellung, ob in /system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg aktiv ist und die Dateierweiterungsliste WebP enthält.

Verwandtes Lesen

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f