{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"c39e3b46-72b4-4998-ba3b-34847312b8b9"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"paragraph","content":[{"text":"If you are updating the ","type":"text"},{"text":"io.wcm.maven:io.wcm.maven.aem-global-parent","type":"text","marks":[{"type":"code"}]},{"text":" dependency in the parent POM of your project to a version 1.5.x you have to do some manual steps described in this article. Some are mandatory, some are optional (but recommended anyway).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Mandatory: Define dependencies for OSGi annotations","type":"text"}]},{"type":"paragraph","content":[{"text":"A couple of dependencies defined by OSGi and the Sling project should be available in every Maven Build because they provide annotations like @Component and @SlingServlet helping you define OSGi components and services in a convenient way. Up to 1.4.18 those where defined as dependencies directly in ","type":"text"},{"text":"aem-global-parent","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"But these versions are depending on the AEM version you are using, and the versions of the OSGi bundles deployed to it. Thus the version definition of these dependencies were moved to the ","type":"text"},{"text":"AEM Dependencies","type":"text","marks":[{"type":"link","attrs":{"href":"https://wcm.io/tooling/maven/aem-dependencies.html"}}]},{"text":" POMs, and you have to define them (without version number) in your project’s parent POM.","type":"text"}]},{"type":"paragraph","content":[{"text":"Add to your parent POM:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n org.osgi\n org.osgi.annotation.bundle\n provided\n \n \n org.osgi\n org.osgi.annotation.versioning\n provided\n \n\n \n \n org.osgi\n org.osgi.service.component.annotations\n provided\n \n \n org.osgi\n org.osgi.service.metatype.annotations\n provided\n \n \n org.apache.sling\n org.apache.sling.servlets.annotations\n provided\n \n\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"You also have to make sure to update to at least these version of the AEM dependencies POM depending on your AEM major version and service pack level:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 6.4.0.0002","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 6.4.8.0003","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 6.5.0.0003","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 6.5.6.0001","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 6.5.7.0001","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"io.wcm.maven:io.wcm.maven.aem-cloud-dependencies","type":"text","marks":[{"type":"code"}]},{"text":" 2020.12.4676.20201216T130744Z-201201.0000","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"With version 1.5.0 we have also removed a couple of managed dependencies deprecated a long while ago. If you still use them you have to define them manually (or better: get rid of them):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"org.apache.felix:org.apache.felix.scr.annotations","type":"text","marks":[{"type":"code"}]},{"text":" - Use OSGi annotations instead","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"com.google.code.findbugs:annotations","type":"text","marks":[{"type":"code"}]},{"text":" - Use ","type":"text"},{"text":"com.github.spotbugs:spotbugs-annotations","type":"text","marks":[{"type":"code"}]},{"text":" instead","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"com.google.code.findbugs:jsr305","type":"text","marks":[{"type":"code"}]},{"text":" - Use ","type":"text"},{"text":"org.jetbrains:annotations","type":"text","marks":[{"type":"code"}]},{"text":" instead","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Optional: Switch to individual OSGi artifacts","type":"text"}]},{"type":"paragraph","content":[{"text":"AEM applications usually need some OSGi core and compendium packages at compile time. In the past, it was the usual approach to define a dependency to ","type":"text"},{"text":"osgi.core","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"osgi.cmpn","type":"text","marks":[{"type":"code"}]},{"text":" which included everything that was defined for a major OSGi version. But that does not necessarily match to what is really deployed in the AEM instance, as not all bundles are updated to the latest OSGi spec at the same time, and some are not present at all.","type":"text"}]},{"type":"paragraph","content":[{"text":"Thus it is recommended to ","type":"text"},{"text":"remove","type":"text","marks":[{"type":"strong"}]},{"text":" all these dependency definitions like:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"org.osgi:osgi.core","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"org.osgi:org.osgi.core","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"org.osgi:osgi.cmpn","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"org.osgi:org.osgi.compendium","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"And instead add the individual OSGi artifacts as required (only pick what you need, all versions are defined in the ","type":"text"},{"text":"AEM Dependencies","type":"text","marks":[{"type":"link","attrs":{"href":"https://wcm.io/tooling/maven/aem-dependencies.html"}}]},{"text":" POMs):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n org.osgi\n org.osgi.framework\n compile\n \n \n org.osgi\n org.osgi.resource\n compile\n \n \n org.osgi\n org.osgi.service.component\n compile\n \n \n org.osgi\n org.osgi.service.metatype\n compile\n \n \n org.osgi\n org.osgi.service.cm\n compile\n \n \n org.osgi\n org.osgi.service.event\n compile\n \n \n org.osgi\n org.osgi.service.http\n compile\n \n \n org.osgi\n org.osgi.service.http.whiteboard\n compile\n \n \n org.osgi\n org.osgi.service.log\n compile\n \n \n org.osgi\n org.osgi.util.converter\n compile\n \n \n org.osgi\n org.osgi.util.tracker\n compile\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Most times you need not more than one or two of them. Start with adding none of them and see if everyhing compiles, if not add one-by-one. wcm.io Libraries in the latest versions (released in 2021 or later) already define compile-dependencies to them, so you get some of them automatically. Same applies for unit tests with the latest versions of AEM Mocks (since 4.0.0), Sling Mocks (since 3.0.0) and OSGi Mocks (since 3.0.0).","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend to define these dependencies with compile scope, although this has no effect on the OSGi bundle. But it is helpful in unit tests when multiple bundles are involved to make sure everything that is required to run in the mocked environment is available in the classpath.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Watch out: File Vault Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"In version 1.5.2 of ","type":"text"},{"text":"aem-global-parent","type":"text","marks":[{"type":"code"}]},{"text":" we’ve also updated to the latest version 1.1.6 of ","type":"text"},{"text":"Apache Jackrabbit FileVault Maven Plugin","type":"text","marks":[{"type":"link","attrs":{"href":"http://jackrabbit.apache.org/filevault-package-maven-plugin/"}}]},{"text":" which comes with a lot of new and improved validation rules for content packages build with Maven.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is likely that your existing content packages definitions contain some inconsistencies and your build might fail after updating. We have a separate article helping with this: ","type":"text"},{"type":"inlineCard","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"How to make your content packages comply with Jackrabbit FileVault Validation","versionAtSave":"7"},"url":"https://wcm-io.atlassian.net/wiki/spaces/WCMIO/pages/1353056261"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Related articles","type":"text"}]},{"type":"paragraph","content":[{"type":"placeholder","attrs":{"text":"The content by label feature displays related articles automatically, based on labels you choose. To edit options for this feature, select the placeholder below and tap the pencil icon."}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"max":{"value":"5"},"spaces":{"value":"com.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@4e99be7"},"sort":{"value":"modified"},"showSpace":{"value":"false"},"reverse":{"value":"true"},"type":{"value":"page"},"cql":{"value":"label in ( \"maven\" , \"migration\" ) and type = \"page\" and space = \"WCMIO\""},"labels":{"value":"migration maven"}},"macroMetadata":{"macroId":{"value":"dee970d4-0654-45b2-9f3c-c3113c38888a"},"schemaVersion":{"value":"4"},"title":"Content by Label"}}}},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"218a3516-efdb-4df9-bf00-ce0b35bbb00e"},"schemaVersion":{"value":"1"},"title":"Page Properties"}}},"content":[{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[460.0]},"content":[{"type":"paragraph","content":[{"text":"Related issues","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[299.0]},"content":[{"type":"paragraph"}]}]}]}]}],"version":1}

Browser not supported