ACS AEM Commons 4.0.0 Release Notes


AEM Version Support

ACS AEM Commons 4.x.x supports AEM 6.3, 6.4 and 6.5. Not that ACS AEM Commons version 4.x.x. DROPS support for AEM 6.2.

Changelog

For a list of ALL the changes in 4.0.0 please review the full changelog.

Breaking functional changes

All Client Libraries are now disabled by default!

If you are using any of the following features/Client Libraries you will have to explicitly enable them in your code base using a “wrapper Client Library”.

Each items is linked to a copy/paste-able Wrapper Client Library definition that can be added to your project to include only the required functionality.

Note that all JS/CSS listed under ClassicUI Widgets (Deprecated) is exposed as a single monolithic Client Library. If only specific ClassicUI Widgets are required, custom Client Libraries can be created that reference the desired JS via absolute JCR path. Please remember ClassicUI widgets are deprecated so they may be removed completely in future versions of ACS AEM Commons.

Wrapper Client Libraries

In ACS AEM Commons 4.0.0, all Client Libraries-based features are assigned a Client Library category. To enable a feature, a “wrapper Client Library” must be deployed as part of your code base.

All wrapper Client Library XML node definitions are provided in the above list for easy copy/paste.

We recommend defining a wrapper Client Library per ACS Commons feature under your projects /apps folder.

Example Wrapper Client Library node definition at /apps/your-app/clientlibs/vendor/acs-commons/<feature-name>

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:cq="http://www.day.com/jcr/cq/1.0" xmlns:jcr="http://www.jcp.org/jcr/1.0"
    jcr:primaryType="cq:ClientLibraryFolder"
          jsProcessor="[default:none,min:gcc]"
          allowProxy="{Boolean}true"
          categories="[<THE AEM CATEGORY TO INJECT THE ACS COMMONS CLIENT LIBRARY INTO>]"
          embed="[<THE ACS COMMONS CLIENT LIBRARY CATEGORY>]"/>

Remember to make empty js.txt and css.txt files in your Wrapper lient Library folder. Without these empty files, the Client Library will be ignored.

Breaking API changes

Major Java Package changes

The following Java packages had major version changes (mostly due to the switch to the GSON JSON library).

If your code base uses any of these APIs, you will need to re-compile your source code against the updated 4.0.0 ACS AEM Commons core library.

JMX Object Name changes

The following JMX Object Names were corrected. Any systems interacting with these MBean must be updated.