Building a distribution from the source
JDK 56+ : Make sure that you do not use code constructs that require JDK 6 7 or higher.
Building the distribution
- Check out the latest version from trunk: 'svn co Github (more details see http://svngithub.codehaus.orgcom/activiti/activiti/trunk/'Activiti/Activiti)
- Go into the distro subfolder and run the following ant command: 'ant clean distro'
- The distribution can now be found in the target folder.
activiti.home=/Users/tombaeyens/Documents/workspace/activiti/distro/target/activiti-5.0.alpha1-SNAPSHOT14 downloads.dir=/Users/tombaeyens/Downloads tomcat.enable.debug=true
<?xml version="1.0" encoding="utf-8"?> <tomcat-users> <role rolename="manager"/> <user username="activiti" password="activiti" roles="manager"/> </tomcat-users>
Eclipse IDE Setup
You'll need to install the Maven and Subversion (SVN) plugins.
In the "Galileo - [http://download.eclipse.org/releases/galileo|http://download.eclipse.org/releases/galileo]" update site, which should be available automatically, install "Collaboration --> Subversibe SVN Team provider". After rebooting and adding an SVN repository, you'll be asked automatically to install one of the polarion connectors for SVN. Just take the latest version of the polarion connectors. In case that doesn't happen automatically install a polarion connector manually from "Subversive SVN Connectors Site [http://community.polarion.com/projects/subversive/download/eclipse/2.0/update-site/|http://community.polarion.com/projects/subversive/download/eclipse/2.0/update-site/]"
Install the Maven plugins from [http://m2eclipse.sonatype.org/sites/m2e|http://m2eclipse.sonatype.org/sites/m2e]
First check out the activiti root from SVN as one project. Then import existing projects and navigate to the modules directory. All the module projects should then be found and can be imported in one go.
In order to have BPMN code completion and validation, import BPMN's XML Schemas from activiti-engine/src/main/resources/org/activiti/impl/bpmn/parser into the Eclipse XML Catalog, which can be found in Preferences --> XML --> XMLCatalog.
We decided not to use GIT for now. These pointers are here for future reference when we would evaluate GIT again.
Currently there is a GIT repository fork from SVN, for experimental purposes. If you prefer to use GIT let Tom know and we can take that into account when deciding whether to stick with it.
To use GIT as a committer you will probably want to use ssh to authenticate automatically. Codehaus requires DSA tokens (not RSA) so you may need to create those first:
$ ssh-keygen -t dsa ... <accept the defaults>
Ensure that your
~/.ssh directory is only readable by you (
chmod 700 ~/.ssh should do it). You will also probably need a
~/.ssh/config that contains these lines:
Host git.codehaus.org User git Hostname git.codehaus.org PreferredAuthentications publickey IdentityFile ~/.ssh/id_dsa
Typical initial setup:
$ git config --global user.name "My Name" $ git config --global user.email email@example.com $ git config --global core.autocrlf input # All the --global above can be set locally if you prefer $ git clone ssh://firstname.lastname@example.org/activiti-git.git activiti $ cd activiti $ git branch -a ... (list of branches)