mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-07-31 17:39:05 +00:00
51 lines
2.7 KiB
Plaintext
51 lines
2.7 KiB
Plaintext
== Alfresco Records Management - Development Environment Setup ==
|
|
|
|
Prerequisites
|
|
|
|
- Maven 3.0.4 (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")
|
|
- If you are not working on a Windows machine you need to change the value of a property called "mvn.exec".
|
|
To do this create a file called "build.local.properties" under the code directory and change the value in that new file.
|
|
- Run the "prepareEnv" target for rm-server which will prepare the development environment. This target must be run just once.
|
|
- Now "fullBuild" 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
|
|
|
|
- fullBuild : Creates the amp file and applies it to the war file
|
|
- incrementalBuild : Creates the jar file and copies the jar file with other files like css, js, ftl, etc. files
|
|
|
|
|
|
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
|
|
- assembleIconPackage : Assembles an icons package for the module
|
|
- configureSolr : Configures Solr4 for Alfresco
|
|
- copyDBDriver : Copies the DB driver
|
|
- copyDevContextFile : Copies the dev-context.xml file
|
|
- copyWarFileToTomcat : Copies the war file (amp applied) to the webapp folder
|
|
- copyWebDirectory : Copies the source/web folder
|
|
- deleteExplodedWar : Deletes the exploded war file
|
|
- deleteWarFile : Deletes the war file
|
|
- fetchSolr : Gets the the Solr artifact
|
|
- fetchWarFile : Gets the "original" war file
|
|
- install : Executes the "mvn install" command
|
|
- package : Executes the "mvn package" command
|
|
- prepareEnv : Prepares the development environment (must be run just once)
|
|
- unitTest : Runs the unit tests |