This is an abridged guide to upgrading from Asset Share Commons 1.x to Asset Share Commons 2.0.
Details of this can be found through the rest of the Getting Started section.
Project-level updates
The following should be updated at a project level by the development team.
- Ensure you are on AEM as a Cloud Service or AEM 6.5 SP7+.
- Ensure your custom project that includes Asset Share Commons is updated to the latest AEM project structure.
- If you were deploying Asset Share Commons source code directly, you’ll want to re-think that now, and move to a custom, wrapping project.
- Embed Asset Share Commons 2+
all
artifact in your AEM Maven Project’sall
project. - Add a maven dependency on Asset Share Commons 2+
core
artifact in your AEM Maven Project’score
project. - Define Asset Rendition OSGi configurations for the asset renditions you use in your your AEM Maven Project’s
ui.config
project’sconfig
folder. - Update your AEM Maven Project’s
dispatcher
project with the required filters and cache-able HTTP request headers.
Content authoring updates
The following should be updated in AEM as apart of Asset Share Commons configuration, after the above project-level updates have been deployed.
- Update the Search Page’s > Page Properties > Messages and ensure all desired message text is filled out.
- Update the Actions > Download > Download Modal component as desired, selecting the Asset Renditions defined by the development team (via OSGi configurations).
- Create and author the Actions > Downloads > Downloads Modal component as desired.
- Only applies to AEM as a Cloud Service
- Update the Asset Details pages’ Renditions, Image, and Video components to use Asset Renditions.
- Don’t forget to Publish all your changes!