Commit adf8bd63 authored by mindthegab's avatar mindthegab
Browse files

Experimental / trunk switch - Part 2 - Removal of current trunk (already...

Experimental / trunk switch - Part 2 - Removal of current trunk (already backed up in branches/maven-alfresco-lifecycle-3x

git-svn-id: http://maven-alfresco-archetypes.googlecode.com/svn/trunk@623 04253f4f-3451-0410-a141-5562f1e59037
parent b299709c
Loading
Loading
Loading
Loading
+0 −43
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<!--
	Licensed to the Apache Software Foundation (ASF) under one or more
	contributor license agreements.  See the NOTICE file distributed with
	this work for additional information regarding copyright ownership.
	The ASF licenses this file to You under the Apache License, Version 2.0
	(the "License"); you may not use this file except in compliance with
	the License.  You may obtain a copy of the License at
	
	http://www.apache.org/licenses/LICENSE-2.0
	
	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	
-->
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<artifactId>maven-alfresco-amp-archetype</artifactId>
	<packaging>maven-archetype</packaging>
	<name>Maven Alfresco Amp Archetype</name>
	<description>
		This archetype aims to provide a standardized approach to development, release and deployment of Alfresco AMPs (as opposed to Alfresco
		extensions, released as a different artifact )
	</description>
	<parent>
		<groupId>org.alfresco</groupId>
		<artifactId>maven-alfresco-archetypes</artifactId>
		<version>4.0.0-SNAPSHOT</version>
		<relativePath>../pom.xml</relativePath>
	</parent>
	<build>
		<extensions>
			<extension>
				<groupId>org.apache.maven.archetype</groupId>
				<artifactId>archetype-packaging</artifactId>
				<version>2.0</version>
			</extension>
		</extensions>
	</build>
</project>
+0 −54
Original line number Diff line number Diff line
<document>
	<properties>
		<title>Maven Alfresco AMP archetype</title>
		<author email="gabriele.columbro@alfresco.com">Gabriele Columbro</author>
	</properties>
	<body>
        <release version="3.9.1" date="2012-04-06" description="Consolidated (removed all reported defects) and tested against Alfresco 4.0b">
                 <action dev="columbro" type="add" issue="5">Support for file-mappings.properties</action>
                 <action dev="columbro" type="fix" issue="7">FTL content was destroyed</action>
                 <action dev="columbro" type="fix" issue="19">META-INF not properly included</action>
                 <action dev="maurizio@session.it" type="fix" issue="23">mAmpResources was ignored</action>
                 <action dev="maurizio@session.it" type="fix" issue="46">Broken dependency</action>
                 <action dev="maurizio@session.it" type="fix" issue="54">Cannot find amp-plugin anywhere</action>
                 <action dev="maurizio@session.it" type="add" issue="55">h2 support</action>
                 <action dev="maurizio@session.it" type="add" issue="63">Eclipse Support</action>
                 <action dev="maurizio@session.it" type="add" issue="64">Add alfresco-core.jar provided</action>
                 <action dev="maurizio@session.it" type="fix" issue="67">Documentation update</action>
                 <action dev="maurizio@session.it" type="add" issue="72">Add h2 params to avoid DB locking at startup</action>
                 <action dev="maurizio@session.it" type="add" issue="73">Update archetypes to use Alfresco 4.0b</action>
                 <action dev="columbro" type="fix" issue="74">Align groupId to org.alfresco</action>
        </release>
        <release version="1.9.1" date="2009-12-07"
			description="Moved to maven.alfresco.com">
			<action dev="columbro" type="add">
				Moved to http://maven.alfresco.com
      </action>
			<action dev="columbro" type="fix">
				Fixed version of maven-buildnumber-plugin (for compatibility issues with maven 2.2.1)
      </action>
      <action dev="columbro" type="update">
        Documented versioning scheme and maven-nosnapshot-plugin
      </action>
		</release>
		<release version="1.0.0" date="2008-07-06" description="Public release">
			<action dev="g.columbro" type="add">
				Added full AMP lifecycle management
      </action>
		</release>
		<release version="1.9.0" date="2009-11-07"
			description="Public release alfresco 3.2r based">
			<action dev="g.columbro" type="add">
				Updated to Alfresco 3.2r artifacts
      </action>
			<action dev="g.columbro" type="add">
				Updated to new Sourcesense repository
      </action>
		</release>
		<release version="1.0.0" date="2008-07-06" description="Public release">
			<action dev="g.columbro" type="add">
				Added full AMP lifecycle management
      </action>
		</release>
	</body>
</document>
+0 −62
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<archetype-descriptor name="amp">
  <fileSets>
    <fileSet filtered="false" packaged="false" encoding="UTF-8">
      <directory>src/main/java</directory>
      <includes>
        <include>**/*.java</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory>src/main/webapp</directory>
      <includes>
        <include>**/*.txt</include>
        <include>**/*.jsp</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory>src/main/config</directory>
      <includes>
        <include>**/*.xml</include>
        <include>**/*.properties</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory>src/main/resources</directory>
      <includes>
        <include>**/*.xml</include>
        <include>**/*.properties</include>
      </includes>
    </fileSet>
    <fileSet encoding="UTF-8">
      <directory>src/main/webapp</directory>
      <includes>
        <include>**/*.js</include>
        <include>**/*.gif</include>
        <include>**/*.css</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory>src/test/properties</directory>
      <includes>
        <include>**/*.properties</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory>src/test/resources</directory>
      <includes>
        <include>**/*.xml</include>
        <include>**/*.properties</include>
      </includes>
    </fileSet>
    <fileSet filtered="false" encoding="UTF-8">
      <directory></directory>
      <includes>
        <include>module.properties</include>
        <include>README.txt</include>
        <include>TODO.txt</include>
        <include>jetty/*.xml</include>
      </includes>
    </fileSet>
  </fileSets>
</archetype-descriptor>
+0 −94
Original line number Diff line number Diff line
======================================================================
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
======================================================================


---------------------------------------
Archetype Release: Archetype - maven-amp-archetype
Author: gabriele.columbro@alfresco.com
http://forge.alfresco.com/m2alfresco

Contacts: 
- maven-alfresco@googlegroups.com (developer)

See Also:
http://wiki.alfresco.com/wiki/Module_Management_Tool
-----------------------------------------------------



M2 Instructions for Alfresco AMP:
--------------------------------

The project can be built using Maven2.


Alfresco maven2 AMP build
-------------------------


One command quickstart:
$ MAVEN_OPTS="-Xms256m -Xmx512m -XX:PermSize=128m" mvn  clean integration-test -P webapp 

Runs the jetty embedded with overlayed the currently developed AMP


FEATURES:
---------

- AMP customized build : 										 mvn clean package
- AMP dependencies management: 									'mvn clean package' can take care of overlay deps
- Alfresco webapp integration via war creation					 mvn clean package -P webapp
- jetty embedded build for fast testing,						 mvn clean integration-test -P webapp
- install/deployment of Alfresco compatible AMPs on a m2 repo    mvn install / deploy  [ params ]

- using the maven-amp-plugin (http://forge.alfresco.com/maven4alfresco) WAR can depend on AMP artifacts and have them overlayed within the maven
lifecycle, avoiding the boring MMT run.

Specific dependencies and different Alfresco versions can be specified in 'webapp' profile dependecies. Alfresco test webapp is overlayed (apart with 
all AMP and WAR dependencies specified) also with a sensible default 'alfresco/extension' folder to have a clean safe reproduceable and portable 
default alfresco run. Find these test configuaration files in 'src/test/resources' and environment dependent properties in src/test/properties/<env>/application.properties


PROJECT LAYOUT
--------------

src --------------------------------------------------------> (source folder)
		|
		|__ main ___ __ resources --------------------------> mapped in the classpath. Add here classpath resources
		|			|
		|			|__ config-----   alfresco module config goes here.
		|			|			  |	  Get's copied (by best practice) by build into package alfresco/module/artifactId.
		|			|			  |   This convention is used by the archetype and by the AMP unpacker.
		|			|			  |__ ex: alfresco/module/mymodule ---> Example Alfresco module config 
		|			|
		|			|
		|			|__ java ------------------------------->  customization java classes
		|			|
		|			|__ webapp -----------------------------> AMP overlay folder - this folder is overlayed (so may overwrite other dependent AMPs)

		|			
		|__ test __ __ resources 
						  |
		|			|	  |__ alfresco/extension ---> alfresco overriding Spring contexts
		|			|__ properties ------------------------->  environment aware application properties files  
		|			|			  |
		|			|			  |__ local  ------------->  default application.properties
		|			|
		|
		target - Project build dir

+0 −34
Original line number Diff line number Diff line
======================================================================
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
======================================================================

Known Issues:
-------------



MAJOR:


MINOR:
- cannot use maven SNAPSHOT versioning as it's copied over in the module.properties
file and not accepted by alfresco as valid module version number


TRIVIAL:

IMPROVEMENTS:
- maven-sql-plugin to autocreate jetty db
Loading