ドキュメント

WebP サポート用にAEMの「AdaptiveImageServletMappingConfigurationFactory」を上書き

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

Adobe Experience Manager（AEM）の画像コンポーネントは、AdaptiveImageServletMappingConfigurationFactory 設定に WebP 拡張機能が含まれていない限り、WebP アセットをレンダリングしません。 AEMが引き続き標準提供（OOTB）の設定を適用するので、デフォルトの名前と場所を使用してカスタム設定をデプロイすると失敗します。 この問題を解決するには、設定ファイルの名前を変更し、正しいフォルダーに配置して、パッケージを再デプロイします。

説明 description

環境

Adobe Experience Manager（AEM）Managed Services v6.5 - Sites

問題/症状

  • AEM画像コンポーネントは、ページ上で WebP 画像をレンダリングしません。
  • WebP サポートを追加するカスタム設定は、デプロイメント後に無視されます。
  • システムは、カスタム設定ではなく、デフォルトの AdaptiveImageServletMappingConfigurationFactory 設定を引き続き適用します。
  • 更新された設定ファイルをデプロイした後も、WebP 画像アセットは使用できません。

解決策 resolution

この問題に対処するには、次の手順に従います。

  1. ツール に移動します。 > 操作 > Web コンソール > system/console/configMgr AEM 6.5 AMS オーサーインスタンスの場合
  2. AdaptiveImageServletMappingConfigurationFactory を検索し、com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg の設定を開いてコピーします。
  3. コードベース設定ファイルを作成または名前を com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg.cfg.json のように変更します。
  4. このファイルで、ファイル拡張子プロパティに webp を追加します。例："fileExtensions": [ "jpeg", "jpg", "png", "gif", "webp"]。
  5. このファイルをコードベースのオーサー実行モードフォルダーの下に配置します。例：.../apps/<project>/config.author/ （および、公開に必要な場合は同様 config.publish/）。
  6. コードパッケージを再デプロイします。
  7. デプロイ後、/system/console/configMgr that com.adobe.cq.wcm.core.components.internal.servlets.AdaptiveImageServletMappingConfigurationFactory coreimg がアクティブで、そのファイル拡張子のリストに webp が含まれていることを確認します。

関連資料

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