mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-07-31 17:39:05 +00:00
ebe454f13e
* merges from previous branches are now possible without tree conflicts * added back missing commits when structure was changed (r59445, r59446) .. see RM-765 * updated Maven POM's to use existing code structure * NOTE: r59454 and r59473 may have been missed in this update .. will go back and re-add git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/modules/recordsmanagement/HEAD@59491 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
== Alfresco Records Management - Development Environment Setup ==
Prerequisites
- Maven 3.0.3 (or higher)
- Eclipse Maven Plugin (m2e)
- See Maven setup instructions https://ts.alfresco.com/share/page/site/eng/wiki-page?title=Maven_Setup
Initial Setup
- Create a normal project using "create-project"
- Check out RM code into the "code" directory (eg "checkout https://svn.alfresco.com/repos/alfresco-enterprise/modules/recordsmanagement/HEAD")
- Create the tomcat instances using "use-tomcat7" and "use-app-tomcat7"
Using Eclipse
- Import projects as Maven projects ("Import > Maven > Existing Maven Projects")
- Browse to the code directory of your project and select "rm-server/pom.xml" and "rm-share/pom.xml". DO NOT select the parent "/pom.xml"
- Open the Ant view and add the build files for both modules ("build.xml")
- Run the "prepareEnv" targets for both modules which will prepare the development environment. This target must be run just once.
- Now "buildAndDeploy" target can be run which will create the amp file, apply it to the war file and copy the war file to webapps folder.
Summary of Available Ant Targets
- assembleIconPackage : Assembles an icons package for the module
- assembleLocalisationPackage : Assembles an i18n package for the module
- buildAndDeploy : Creates the amp file and applies it to the war file
- prepareEnv : Prepares the development environment (must be run just once)
- tomcat-start : Starts a tomcat instance
- tomcat-start-debug : Starts a tomcat instance in debug mode
- tomcat-stop : Stops the running tomcat instance
Summary of Available Internal Ant Targets
- alfresco:amp : Creates the amp file using alfresco maven plugin
- alfresco:install : Installs the amp file to the war file
- cleanTarget : Deletes the "target" folder
- copyDBDriver : Copies the DB driver
- copyDevContextFile : Copies the dev-context.xml file
- copyWarFileToTomcat : Copies the war file (amp applied) to the webapp folder
- deleteExplodedWar : Deletes the exploded war file
- deleteWarFile : Deletes the war file
- fetchWarFile : Gets the "original" war file
- install : Executes the "mvn install" command
- updateClassPath : Updates the classpath / Generates the eclipse configuration files