diff --git a/plugins/alfresco-maven-plugin/pom.xml b/plugins/alfresco-maven-plugin/pom.xml index 4874407d..0faf3082 100644 --- a/plugins/alfresco-maven-plugin/pom.xml +++ b/plugins/alfresco-maven-plugin/pom.xml @@ -3,7 +3,7 @@ org.alfresco.maven.plugin alfresco-maven-plugin maven-plugin - Maven Alfresco Plugin + Alfresco Maven Plugin org.alfresco.maven diff --git a/plugins/alfresco-maven-plugin/src/site/apt/index.apt.vm b/plugins/alfresco-maven-plugin/src/site/apt/index.apt.vm index 1a0e441c..ed3f8b06 100644 --- a/plugins/alfresco-maven-plugin/src/site/apt/index.apt.vm +++ b/plugins/alfresco-maven-plugin/src/site/apt/index.apt.vm @@ -1,33 +1,23 @@ ------ Introduction - ------ - Gabriele Columbro - ------ - Nov 2012 - ------ Introduction - The Maven Alfresco Plugin provides development features to manage {{{http://www.alfresco.com}Alfresco ECM}} WAR and {{{https://wiki.alfresco.com/wiki/AMP_Files}AMP}} project lifecycles. + The Alfresco Maven Plugin provides development features to manage {{{http://www.alfresco.com}Alfresco Platform}} WAR, JAR and {{{https://community.alfresco.com/docs/DOC-5146-amp-files}AMP}} project lifecycles. * Goals Overview - The Maven Alfresco plugin has three goals: + The Alfresco Maven Plugin has three goals: - *{{{./amp-mojo.html}alfresco:amp}} Packages an AMP file + *{{{./run-mojo.html}alfresco:run}} Starts up Alfresco Platform, Share and Solr with your and 3rd party customizations *{{{./install-mojo.html}alfresco:install}} Installs one or multiple AMPs into an Alfresco WAR / exploded WAR folder embedding {{{http://wiki.alfresco.com/wiki/Module_Management_Tool} Alfresco MMT}} - *{{{./set-version-mojo.html}alfresco:version}} Parses <<<$\{project.version\}>>> removing literals (for AMP compatibility) and making the <<<$\{noSnapshotVersion\}>>> property available in the POM Full information is available at the {{{./plugin-info.html}goals page}}. * Usage - General instructions on how to use the Maven Alfresco Plugin can be found on the {{{./usage.html}usage page}}. - - The Maven Alfresco Plugin provides support for <<>> packaging in your Maven projects and allows you to - build AMPs as well as used them as standard Maven dependencies. You can also use AMPs as part of the standard - {{{http://maven.apache.org/plugins/maven-war-plugin/overlays.html}maven-war-plugin}} <<< >>> configuration. + General instructions on how to use the Alfresco Maven Plugin can be found on the {{{./usage.html}usage page}}. For more complex usage of the Maven Alfresco Plugin check the {{{./advanced-usage.html}advanced usage page}}. \ No newline at end of file diff --git a/plugins/alfresco-maven-plugin/src/site/apt/usage.apt.vm b/plugins/alfresco-maven-plugin/src/site/apt/usage.apt.vm index b8b8a972..78f1b935 100644 --- a/plugins/alfresco-maven-plugin/src/site/apt/usage.apt.vm +++ b/plugins/alfresco-maven-plugin/src/site/apt/usage.apt.vm @@ -1,62 +1,28 @@ ------ Usage - ------ - Gabriele Columbro - ------ - Nov 2012 - ------ + How to use this plugin? - There are fundamentally 3 methods to use this plugin: + There are fundamentally two methods to use this plugin: [[1]] Using Archetypes provided in the Alfresco SDK - - [[2]] By using the Alfresco SDK Parent POM - - [[3]] Via direct configuration in your POM + + [[2]] Via direct configuration in your POM * Method 1 - Using Alfresco SDK Archetypes Two sample archetypes already use the plugin and provide best practice example on how to use it: - [[1]] The {{{../../archetypes/alfresco-amp-archetype/index.html} Alfresco AMP Archetype}} provides a sample of AMP packaging + [[1]] The {{{../../archetypes/alfresco-platform-jar-archetype/index.html} Alfresco Platform JAR Archetype}} provides a sample of JAR packaging with AMP as an optional assembly for 3rd party dependencies - [[2]] The {{{../../archetypes/alfresco-allinone-archetype/index.html} Alfresco All-in-One Archetype}} provides a sample using AMPs as dependencies and WAR overlay + [[2]] The {{{../../archetypes/alfresco-allinone-archetype/index.html} Alfresco All-in-One Archetype}} provides a sample using JARs for both Alfresco Platform and Share - - This is the <> and less error-prone way of using the plugin. - -* Method 2 - Using Alfresco SDK Parent POM - The {{{../../poms/alfresco-sdk-parent/index.html}Alfresco SDK Parent POM}} provides a single entry point for all SDK features. - - By using it as parent as follows: - -+---+ - - ... - - org.alfresco.maven - alfresco-sdk-parent - 1.0 - - ... - -+---+ - - you will have automatic support for AMP packaging of your project (just add you sources in <<>>). - * Method 3 - Direct configuration in POM If you want more control over the plugin behavior you can use it directly in your POM. - - <>: The following configuration is not required when using the SDK parent, as it's already included there. - - In order to manage AMP artifacts with the Maven Alfresco plugin you need to: - - * Declare the plugin in your POM with <<<>>> enabled, to allow AMP packaging lifecycle: - + +---+ [...] @@ -67,7 +33,25 @@ How to use this plugin? org.alfresco.maven.plugin alfresco-maven-plugin ${project.version} - true + + org.alfresco.maven.plugin + alfresco-maven-plugin + 3.0.0 + + community + true + true + true + false* + + + ${alfresco.groupId} + alfresco-share-services + ${alfresco.share.version} + amp + + + ... @@ -75,25 +59,3 @@ How to use this plugin? [...] +---+ - - * If you want to package an Alfresco Module Package from your <<>> packaging project you also need to make sure - your AMP content gets copied to <<<\${project.build.directory}/\${project.build.finalName}>>> so the plugin can pick them up. - Supposing your AMP sources are in <<>> you should configure the following <<<>>> block: - -+---+ - - [...] - - - ... - - src/main/amp - - ../\${project.build.finalName} - ${app.filtering.enabled} - - - - [...] - -+---+ diff --git a/plugins/alfresco-maven-plugin/src/site/resources/css/site.css b/plugins/alfresco-maven-plugin/src/site/resources/css/site.css new file mode 100644 index 00000000..0678e6bf --- /dev/null +++ b/plugins/alfresco-maven-plugin/src/site/resources/css/site.css @@ -0,0 +1,5 @@ +.pippo {} + +body.topBarEnabled { + padding-top: 100px; +} \ No newline at end of file diff --git a/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent-large.png b/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent-large.png new file mode 100644 index 00000000..de3bb99d Binary files /dev/null and b/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent-large.png differ diff --git a/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent.gif b/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent.gif new file mode 100644 index 00000000..ec36f987 Binary files /dev/null and b/plugins/alfresco-maven-plugin/src/site/resources/img/Alfresco-logo-transparent.gif differ diff --git a/plugins/alfresco-maven-plugin/src/site/resources/img/alfresco-maven-logo.jpg b/plugins/alfresco-maven-plugin/src/site/resources/img/alfresco-maven-logo.jpg new file mode 100644 index 00000000..ff4aac53 Binary files /dev/null and b/plugins/alfresco-maven-plugin/src/site/resources/img/alfresco-maven-logo.jpg differ diff --git a/plugins/alfresco-maven-plugin/src/site/site.xml b/plugins/alfresco-maven-plugin/src/site/site.xml index 61c106d0..9f77311b 100644 --- a/plugins/alfresco-maven-plugin/src/site/site.xml +++ b/plugins/alfresco-maven-plugin/src/site/site.xml @@ -1,28 +1,25 @@ - - + })(); + + ]]> - + - - diff --git a/pom.xml b/pom.xml index 85efd3a4..60430947 100644 --- a/pom.xml +++ b/pom.xml @@ -34,33 +34,7 @@ - - mindthegab - Gabriele Columbro - gabriele.columbro@alfresco.com - http://mindthegab.com - Alfresco Software - http://www.alfresco.com - -5 - - Founder - Architect - Developer - - - - maoo - Maurizio Pillitu - maurizio.pillitu@alfresco.com - http://session.it - Alfresco Software - http://www.alfresco.com - +1 - - Architect - Developer - - + ohej Ole Hejlskov @@ -89,6 +63,22 @@ + + Gabriele Columbro + gabriele.columbro@alfresco.com + http://mindthegab.com + Alfresco Software + http://www.alfresco.com + -5 + + + Maurizio Pillitu + maurizio.pillitu@alfresco.com + http://session.it + Alfresco Software + http://www.alfresco.com + +1 + Carlo Sciolla carlo@backbase.com @@ -282,6 +272,11 @@ sdk-release,enterprise-tests + + org.apache.maven.plugins + maven-project-info-reports-plugin + 2.9 + @@ -308,6 +303,8 @@ true + false + diff --git a/src/site/apt/index.apt.vm b/src/site/apt/index.apt.vm index abf5133a..8652c27e 100644 --- a/src/site/apt/index.apt.vm +++ b/src/site/apt/index.apt.vm @@ -1,15 +1,10 @@ ------ Alfresco SDK\x99 - ------ - Gabriele Columbro - ------ - Aug 2014 - ------ Introduction The Alfresco SDK\x99 - formerly Maven Alfresco SDK\x99, formerly {{{https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/maven-alfresco-lifecycle/latest/index.html} Alfresco Lifecycle 3.9.1}} - - provides a fully fledged Maven support for {{{http://www.alfresco.com}Alfresco ECM}} WAR and {{{https://wiki.alfresco.com/wiki/AMP_Files}AMP}} project development. + provides a fully fledged Maven support for {{{http://www.alfresco.com}Alfresco Content Services}} WAR, JAR and {{{https://community.alfresco.com/docs/DOC-5146-amp-files}AMP}} project development. Being fully integrated with Maven it allows to both leverage the vast number of Maven plugins for your Alfresco project as well as integrated your project easily in Open Source and Enterprise development processes. @@ -18,10 +13,9 @@ Introduction How to Use the SDK - The easiest way to use the SDK is to create a sample project using one of the available <> (Repo AMP, Share AMP, All in One). - - You can also use the Alfresco SDK Parent POM directly in your Maven project to inherit Alfresco behaviors and configurations. - + The easiest way to use the SDK is to create a sample project using one of the available <> (Platform JAR, Share JAR or All in One). + + You can also use the Alfresco Maven Plugin directly on any JAR project. SDK Versions @@ -29,7 +23,8 @@ SDK Versions Maven Alfresco SDK 1.x versions rely on the {{{https://artifacts.alfresco.com/nexus/content/groups/public/}Alfresco Artifacts Repository}}. For documentation on the Maven Alfresco SDK\x99 1.x please refer to {{{https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/alfresco-lifecycle-aggregator/latest/index.html} Maven Alfresco SDK 1.x}} - + + SDK Alfresco Compatibility Please refer to the {{{http://docs.alfresco.com/community/concepts/alfresco-sdk-compatibility.html}official Alfresco docs}} for details of SDK / Alfresco compatibility. @@ -39,35 +34,34 @@ Alfresco SDK\x99 components The Alfresco SDK relies on a number of components: - * {{{./poms/alfresco-sdk-parent/index.html}The SDK parent POM}} providing full Alfresco project lifecycle feature, to be added as a <<<>>> in your projects - * Archetypes providing sample project to kickstart your Alfresco development and boost it with best practices - * the {{{./archetypes/alfresco-amp-archetype/index.html}Repo AMP}}, a single project that customizes Alfresco Repository + * the {{{./archetypes/alfresco-platform-jar-archetype/index.html}Platform JAR}}, a single project that customizes Alfresco Repository - * the {{{./archetypes/share-amp-archetype/index.html}Share AMP}}, a single project that customizes Alfresco Share + * the {{{./archetypes/alfresco-share-jar-archetype/index.html}Share JAR}}, a single project that customizes Alfresco Share * the {{{./archetypes/alfresco-allinone-archetype/index.html}All-in-One}}, a multi-module project to customize and run all components - * The {{{./plugins/alfresco-maven-plugin/index.html} Maven Alfresco Plugin}} to manage AMP packaging and dependencies - - * {{{https://artifacts.alfresco.com/nexus/content/repositories/alfresco-docs/alfresco-platform-distribution/latest}Alfresco Platform Distribution POM}} can (optionally) be used to provide centralized <<<>>> on a particular Alfresco version / edition (Community / Enterprise) + * The {{{./plugins/alfresco-maven-plugin/index.html} Maven Alfresco Plugin}} to setup, build, test and run your customizations - * The {{{https://artifacts.alfresco.com}Alfresco Artifacts Repository}} provides backing for this SDK. Check the {{{http://wiki.alfresco.com/wiki/Alfresco_Artifacts_Repository}Alfresco Wiki}} for Community / Enterprise access information. + * The {{{https://artifacts.alfresco.com}Alfresco Artifacts Repository}} provides backing for this SDK. Pre-requisites * System prerequisites - No manual Alfresco download, application server or database is required. + No manual Alfresco download, application server or database is required. The {{{./plugins/alfresco-maven-plugin/index.html} Maven Alfresco Plugin}} will by default launch an embedded + H2 Database along with an embedded Tomcat server. Advanced use cases can be configured to use external databases such as MySQL, PostgreSQL or various enterprise databases. See the + {{{./plugins/alfresco-maven-plugin/index.html} Maven Alfresco Plugin}} documentation for more information. + See details in the {{{./prerequisites.html} SDK pre-requisites page}}. -* Rapid development with Spring Loaded +* Rapid development with HotSwap Agent or JRebel - The SDK (as of 2.0) support true rapid development and IDE integration. To allow hot reload of Java classes the SDK leverages - {{{https://github.com/spring-projects/spring-loaded}spring-loaded}}, a library which allows seamless reloading of classfiles. + The SDK (as of 3.0) support true rapid development and IDE integration. To allow hot reload of Java classes the SDK leverages + {{{http://hotswapagent.org}HotSwap Agent}}, a library which allows seamless reloading of classfiles. JRebel is also supported out of the box. - Check the {{{./prerequisites.html} SDK pre-requisites page}} to enable spring-loaded rapid development. + Check the {{{./prerequisites.html} SDK pre-requisites page}} to enable rapid development. Project History @@ -86,3 +80,5 @@ Project History * The new Maven Alfresco SDK 1.0 is released and presented on Tuesday 7 November at {{{http://devcon.alfresco.com/}Alfresco DevCon}} in Berlin. * The new Alfresco SDK 2.0 is released and presented on late 2014 November and released on Maven Central + + * In March 2017 Alfresco SDK 3.0 is released \ No newline at end of file diff --git a/src/site/apt/prerequisites.apt.vm b/src/site/apt/prerequisites.apt.vm index d1819829..b6dc0c1d 100644 --- a/src/site/apt/prerequisites.apt.vm +++ b/src/site/apt/prerequisites.apt.vm @@ -1,27 +1,20 @@ ------ Alfresco SDK Prerequisites - ------ - Gabriele Columbro - ------ - August 2014 - ------ Alfresco SDK\x99 Pre-Requisites - The only real prerequisite of the Alfresco SDK\x99 Apache Maven 3.0.4 installed (and properly configured) on your machine; + The only real prerequisite of the Alfresco SDK\x99 Apache Maven 3.3.0 (or later) installed (and properly configured) on your machine; neither <> nor <> are required. Additional tips: - * It is strongly advised to use the Apache Maven official binary distributions downloaded from the {{{http://maven.apache.org}official mirrors}}; avoid OS-specific distributions as much as possible. + * It is strongly advised to use the latest Apache Maven official binary distributions downloaded from the {{{http://maven.apache.org}official mirrors}}; avoid OS-specific distributions as much as possible. - * add <<>> to your environment if your plan to launch tests / run embedded in Tomcat - * Refer to this {{{http://docs.alfresco.com/community/concepts/alfresco-sdk-compatibility.html}matrix}} for Alfresco/SDK version compatibility - * Java 1.7 is <> to run Alfresco 4.2.b+ and the SDK 1.1.x + + * Java 1.8 is <> to run Alfresco 5.1.c+ and the SDK3 * <> of Alfresco distribution is required. Alfresco platform is retrieved automatically from {{{https://artifacts.alfresco.com} the Alfresco Artifacts Repository}} @@ -32,22 +25,10 @@ Alfresco SDK\x99 Pre-Requisites Enable hot class reload with spring-loaded - In order to enable hot class reload you should use the spring-loaded agent and run all your maven builds with it configured in the JVM. + In order to enable hot class reload you should use the {{{http://hotswapagent.org}HotSwap Agent}} and run all your maven builds with it configured in the JVM. To achieve this you can: - * Download the spring-loaded library from {{{http://search.maven.org/remotecontent?filepath=org/springframework/springloaded/1.2.0.RELEASE/springloaded-1.2.0.RELEASE.jar}here}}. + * Follow the {{{http://hotswapagent.org/mydoc_quickstart.html}install instructions for HotSwap Agent}}. + This includes installing the correct {{{https://github.com/dcevm/dcevm/releases}DCEVM Java Patch}} and enabling HotSwap Agent in your MAVEN_OPTS - * Export the following MAVEN_OPTS: <<>>. - - -H2 Embedded Support Pre-Requisites - - This SDK allows H2 embedded run of Alfresco (<>: this is an unsupported configuration for Alfresco Enterprise) leveraging - the open source effort {{{https://github.com/skuro/alfresco-h2-support} Alfresco H2 Support}}. This bridge allows to emulate - Alfresco expected DB behavior and is therefore very specific to every Alfresco version. - - Alfresco SDK\x99 ${project.version} uses version 1.5 of the Alfresco H2 Support. In case you experience - issues with the embedded DB support, please check the {{{https://github.com/skuro/alfresco-h2-support/wiki/H2-Database-support-for-Alfresco} H2 Support Compatibility matrix}}. - - Alternatively, you can easily setup your DB access by defining {{{./poms/alfresco-sdk-parent/sdk-properties.html}POM properties}} - + * Export the following MAVEN_OPTS: <<>>. diff --git a/src/site/resources/css/site.css b/src/site/resources/css/site.css index 5845334f..0678e6bf 100644 --- a/src/site/resources/css/site.css +++ b/src/site/resources/css/site.css @@ -1 +1,5 @@ .pippo {} + +body.topBarEnabled { + padding-top: 100px; +} \ No newline at end of file diff --git a/src/site/site.xml b/src/site/site.xml index 7abf858b..282cc0d8 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -2,14 +2,14 @@ org.apache.maven.skins maven-fluido-skin - 1.3.1 + 1.6 Alfresco Software Alfresco Software - https://wiki.alfresco.com/skins/alfresco/community_theme/alfresco-org-logo.png + https://community.alfresco.com/resources/images/palette-1015/logo.png http://www.alfresco.com true @@ -32,8 +32,8 @@ + - var _gaq = _gaq || []; _gaq.push(['_setAccount', '${gaTrackingId}']); _gaq.push(['_trackPageview']); @@ -43,8 +43,8 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - + ]]>