topic Developing an Alfresco AMP against a specific Aikau version in Alfresco Archive

topic Developing an Alfresco AMP against a specific Aikau version in Alfresco Archive https://connect.hyland.com/t5/alfresco-archive/developing-an-alfresco-amp-against-a-specific-aikau-version/m-p/156799#M111026 <HTML><HEAD></HEAD><BODY>If you're developing an Alfresco extension that works against Share, you'll probably find that using Aikau streamlines the process. That's exactly what we're doing in the <A class="jive-link-external-small" href="http://www.alfresco.com/products/records-management" rel="nofollow noopener noreferrer">Records Management</A> (or RM) team.RM is the largest Alfresco extension developed by in-house Alfresco engineers, so it proves a good testing ground for extension methods. We've found Aikau helps a lot with Share extensions: the latest release makes use of it in <A class="jive-link-external-small" href="https://github.com/Alfresco/records-management/tree/master/rm-share/source/web/js/alfresco/rm" rel="nofollow noopener noreferrer">some areas</A> and we're looking to extend its use for the next release.Now that Aikau is a <A class="jive-link-external-small" href="https://github.com/Alfresco/Aikau" rel="nofollow noopener noreferrer">separate project</A> with an aggressive (weekly) <A class="jive-link-external-small" href="https://github.com/Alfresco/Aikau/blob/master/aikau/src/main/ReleaseNotes.md" rel="nofollow noopener noreferrer">release cycle</A> it would be quite easy to miss out on the latest features and bug fixes if an Alfresco add on was dependent upon the version of Aikau that was bundled with Alfresco, luckily it's very easy to specify a newer version for your AMP to use.The Aikau team have committed to ensuring that their releases are backwards compatible from this point (Alfresco 5.0.1) onwards (and have <A class="jive-link-external-small" href="https://github.com/Alfresco/Aikau/wiki/Unit-Testing" rel="nofollow noopener noreferrer">tests</A> to verify it), so we don't need to worry about breaking Share by upgrading the Aikau lib.As of 5.0.1, Aikau is defined as an external dependency within the <A class="jive-link-external-small" href="https://github.com/Alfresco/community-edition/blob/master/projects/slingshot/pom.xml#L209" rel="nofollow noopener noreferrer">Share pom.xml</A>. It then ends up as a JAR in the WEB-INF/libs directory of the share.war, so that's where our AMP needs to place the newer version. Step one of the process for including a newer version of Aikau is to update the dependency within our <A class="jive-link-external-small" href="https://github.com/Alfresco/records-management/commit/f950a35a04747d826773755288baa1a3bb2bb9a5" rel="nofollow noopener noreferrer">project's pom.xml</A>:<BLOCKQUOTE class="jive_macro_quote jive-quote jive_text_macro">      <dependency>          <groupId>org.alfresco</groupId>          <artifactId>aikau</artifactId>          <version>1.0.5</version>                    <exclusions>             <exclusion>                <groupId>*</groupId>                <artifactId>*</artifactId>             </exclusion>          </exclusions>       </dependency></BLOCKQUOTE>Note: you need to make sure that the <A class="jive-link-external-small" href="https://artifacts.alfresco.com/nexus/content/groups/public/alfresco-lifecycle-aggregator/latest/plugins/alfresco-maven-plugin/plugin-info.html" rel="nofollow noopener noreferrer">alfresco-maven-plugin</A> you use to generate the AMP is configured to <A class="jive-link-external-small" href="https://artifacts.alfresco.com/nexus/content/groups/public/alfresco-lifecycle-aggregator/latest/plugins/alfresco-maven-plugin/amp-mojo.html#includeDependencies" rel="nofollow noopener noreferrer">includeDependencies</A>, as we want to ensure that the Aikau JAR ends up in the libs directory of the AMP and therefore in the WEB-INF/libs directory of the Share war when installed. That's it, there is no step two. All the configuration is cleverly handled by an <A class="jive-link-external-small" href="https://github.com/Alfresco/Aikau/blob/master/aikau/src/main/resources/extension-module/aikau-extension.xml" rel="nofollow noopener noreferrer">extension module</A> that Aikau supplies (which assumes that you've got <A class="jive-link-external-small" href="http://docs.alfresco.com/5.0/concepts/dev-extensions-share-module-autodeploy.html" rel="nofollow noopener noreferrer">auto-deploy</A> turned on - if not you'll need to <A class="jive-link-external-small" href="http://docs.alfresco.com/5.0/concepts/dev-extensions-share-module-deployment.html" rel="nofollow noopener noreferrer">manually enable</A> this extension module). If you've got multiple AMPs that require different versions of Aikau, then the one with the highest version number wins out (due to the auto-deploy-index in the extension module). To check which Aikau version is present inside a running Share instance, either:<UL><UL><LI>Load up a page and check the window.<A class="jive-link-external-small" href="http://dojotoolkit.org/documentation/tutorials/1.9/dojo_config/" rel="nofollow noopener noreferrer">dojoConfig</A> JS object, the packages object contains a list of all defined AMD package roots - the location for the alfresco/ package contains the path to the JAR (located within the WEB-INF/lib/) <A _jive_internal="true" href="https://community.alfresco.com/api/core/v3/attachments/12243/data" rel="nofollow noopener noreferrer"><IMG alt="window.dojoConfig" class="image-1 jive-image j-img-original" src="https://connect.hyland.com/legacyfs/online/alfresco/9593_dojoConfig.png" style="height: auto;" /></A></LI></UL></UL><UL><UL><LI>Check the module deployment page to verify that the Aikau extension for your overridden Aikau version has been applied <IMG alt="module deployment page" class="image-2 jive-image j-img-original" src="https://connect.hyland.com/legacyfs/online/alfresco/9594_deployed-modules.png" style="height: auto;" /></LI></UL></UL></BODY></HTML> Wed, 18 Feb 2015 15:00:23 GMT davidcognite 2015-02-18T15:00:23Z Developing an Alfresco AMP against a specific Aikau version https://connect.hyland.com/t5/alfresco-archive/developing-an-alfresco-amp-against-a-specific-aikau-version/m-p/156799#M111026 If you're developing an Alfresco extension that works against Share, you'll probably find that using Aikau streamlines the process. That's exactly what we're doing in the Records Management (or RM) team.RM is the largest Alfresco extension developed by in-house Alfresco engineers, so it proves a goo Wed, 18 Feb 2015 15:00:23 GMT https://connect.hyland.com/t5/alfresco-archive/developing-an-alfresco-amp-against-a-specific-aikau-version/m-p/156799#M111026 davidcognite 2015-02-18T15:00:23Z