Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Building a distribution from the source

Dependencies

JDK 56+ : Make sure that you do not use code constructs that require JDK 6 7 or higher.
Maven 23.0.94
Ant 1.78.1

Source Code

https://svn.codehaus.org/activiti (see http://xirclesgithub.codehaus.orgcom/projects/activiti/repo for more links including anonynmous access for non-committers).Activiti/Activiti

Building the distribution

  1. Check out the latest version from trunk: 'svn co Github (more details see http://svngithub.codehaus.orgcom/activiti/activiti/trunk/'Activiti/Activiti)
  2. Go into the distro subfolder and run the following ant command: 'ant clean distro'
  3. The distribution can now be found in the target folder.

...

Code Block
activiti.home=/Users/tombaeyens/Documents/workspace/activiti/distro/target/activiti-5.0.alpha1-SNAPSHOT14
downloads.dir=/Users/tombaeyens/Downloads
tomcat.enable.debug=true

...

Code Block
  <?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.

...

http://www.vitorrodrigues.com/blog/2009/07/10/debugging-ant-tasks-in-eclipse/

GIT pointers

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:

No Format
$ 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:

Code Block
Host git.codehaus.org
	User git
	Hostname git.codehaus.org
	PreferredAuthentications publickey
	IdentityFile ~/.ssh/id_dsa

Typical initial setup:

No Format
$ git config --global user.name "My Name"
$ git config --global user.email my.email@my.address.com
$ git config --global core.autocrlf input
# All the --global above can be set locally if you prefer
$ git clone ssh://git@git.codehaus.org/activiti-git.git activiti
$ cd activiti
$ git branch -a
... (list of branches)

...