This page describes how to get started if you want to build Activiti Designer yourself or if you want to extend Activiti Designer's features. It assumes you have a working knowledge of how Eclipse, Maven and RCP development.
- Start by downloading a Helios version of Eclipse for RCP and RAP Developers from here: http://www.eclipse.org/downloads/
- Download and install Maven 3 from here: http://maven.apache.org/download.html . Using Maven 2.x will not work, so make sure you have a compliant version. Commands listed further on will assume that you have the mvn command linked to Maven 3. Make sure your Maven settings are such, that Maven can access the Internet to access public repositories and download dependencies
- Add the Eclipse Modelling Framework (EMF) SDK
- Add the Web standard tools (WST) plugins
- Add Eclipse Graphiti SDK 0.7.1 from update site http://download.eclipse.org/graphiti/updates/0.7.1. We haven't moved to the new 0.8.x release of Graphiti yet and you may have trouble using it, so for the moment stick with 0.7.1
- Add a team provider for Subversion, such as Subversive
- Add the following location as source code repository: http://svn.codehaus.org/activiti/projects/designer/
As you can see, there are quite a number of projects in this tree. You will need to have all of them in your Eclipse workspace to build Designer yourself. It's important that you perform a checkout of all of these projects as top level projects in your workspace. Obviously, you can do without the examples folder, but you need the other projects.
- Checkout all of the folders in the source control location as top level Eclipse projects.
- Open a console and navigate to the directory of your Eclipse workspace and then into the org.activiti.designer.parent directory, which is of course the directory of the project with the same name. Now perform the following Maven commands:
This might take a while because Maven will now download a lot of dependencies to your local repository and setup the projects. Make sure the command ends with a Build Successful so you know everything's OK as far as Maven is concerned.
- Go back to Eclipse, select all of the projects and right click and choose refresh. The information set by Maven will now be picked up by Eclipse. If you like being thorough, you can perform a Project > Clean command as well.
- Your projects will still have *lots* of errors at this point. This is because most of the projects depend on the org.activiti.designer.model project, which contains, as you may have guessed, the data model that is used for diagrams. At the moment, the model is still missing and you need to generate it. Open the org.activiti.designer.
Recently we decided to remove the generated org.activiti.designer.model sources from svn, so you also have to generated these sources with the .genmodel file (I think it is in the model dir). Open this file and right-click on the root element and choose "generate model code".
Then make sure you have installed Maven 3 and that you use this version to run the mvn command.
I always first run mvn clean install and then mvn eclipse:eclipse.
ou can then run the plugin by right-clicking the .eclipse project and selecting Run as > Eclipse application.