Page Comparison

...

• io.wcm:io.wcm.testing.wcm-io-mock.caconfig
• org.apache.sling:org.apache.sling.testing.caconfig-mock-plugin

Make sure you have configured the Context-Aware Configuration bnd plugin in your pom hierarchy - or inherit from io.wcm.maven:io.wcm.maven.global-parent where it is already configured.

Additionally update all other wcm.io Bundles to the latest version - in most cases this involves an update of the major version from 0.x to 1.x. In case of AEM Mocks update to the latest 1.x version for AEM 6.2, and to the latest 2.x version if you are using AEM 6.2 or higher.

...

• The MediaFormatBuilder.create method no longer supports the 2nd (Application ID) parameter - call it only with one parameter, the media format name.
• Mark all download media formats with setDownloaddownload(true)
• The abstract class io.wcm.handler.media.spi.helpers.AbstractMediaFormatProvider was removed - instead directly extend io.wcm.handler.media.spi.MediaFormatProvider

...

• Remove @Model and @Application annotations. Instead, make it an OSGi service published as and extending io.wcm.handler.media.spi.MediaHandlerConfig.
• It is not required to set it as immediate
• Check the new default implementation of super classes - perhaps you can remove some of your customization overrides or even remove the whole class
• The method getDownloadMediaFormats is no longer supported - instead go the list of defined media formats and add the call setDownloadapply download(true) to all download media formats

...

• http://wcm.io/handler/url/changes-report.html
• http://wcm.io/handler/media/changes-report.html
• http://wcm.io/handler/link/changes-report.html

Step 11 - Optional: Update CONGA configuration

If you are using CONGA you may have defined a override rule like this in your AEM system configuration template:

{{#if configOverrides}}
  # Override site configuration
  io.wcm.config.core.override.impl.OsgiConfigOverrideProvider-override
    enabled=B"true"
    description="Site URL Config Overrides"
    overrides=[
      {{~#each configOverrides ~}}
        {{~#each this ~}}
          "[{{../@key}}]{{@key}}\={{this}}",
        {{~/each ~}}
      {{~/each ~}}
    ]
{{/if}}

Change it to:

{{#if configOverrides}}
  # Override site configuration
  org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider-override
    enabled=B"true"
    description="Site URL Config Overrides"
    overrides=[
      {{~#each configOverrides ~}}
        {{~#each this ~}}
          "[{{../@key}}]{{this}}",
        {{~/each ~}}
      {{~/each ~}}
    ]
{{/if}}

and use a syntax like this in the environment definitions to configure overrides:

  # Force-Override site URLs in all site configs on the system
  configOverrides:
    "/content/myapp":
    - io.wcm.handler.url.SiteConfig/siteUrl="http://www.myapp.net"
    - io.wcm.handler.url.SiteConfig/siteUrlSecure="https://www.myapp.net"
    - io.wcm.handler.url.SiteConfig/siteUrlAuthor="https://author.myapp.net"

Related articles

...