Login | Register
My pages Projects Community openCollabNet

Chapter 2. Building from source

Building ArgoUML from source requires around 350MB of free disk space depending on what modules you want to build and if you want to build the documentation or not. The ambition is to provide a way to download and build that is as simple and straight-forward as possible.

Currently there are two ways to do this, either the traditional way, resulting in a file structure called the repository layout because the directories are located as they are in the repository, or a file structure called the Eclipse layout because it works with Eclipse's project structure.

2.1. Quick Start

The recommended way is to use the Eclipse as the development environment when developing ArgoUML. Here is the quickest, step by step instruction to set up your Eclipse development environment:

  1. Download and install Eclipse. This is if you don't already have it installed. See http://www.eclipse.org/downloads/.

    You need the Eclipse IDE for Java EE Developers, Eclipse for RCP/Plug-in Developers, or Eclipse Classic 3.3.2.

  2. Download and install Subclipse. This is if you don't already have it installed in your Eclipse. See http://subclipse.tigris.org/install.html.

  3. Download the Project Set File for the ArgoUML project and save it on your file system.

    The main file is called argouml-core-projectset.psf and is available at http://argouml.tigris.org/nonav/psf/argouml-core-projectset.psf

  4. In a new workspace, Import the Project Set File. The project will download several Eclipse projects and automatically build them.

    If some fails to build, try to do refresh or clean. It should work but there has been reports of problems at first download.

  5. Start ArgoUML using ArgoUML configuration.

Details of this can be found at Section 2.9, “Setting up Eclipse 3”.

If you want to work without Eclipse in Windows, the following commands will build ArgoUML from source and run it. If you are using Unix/Linux, the equivalent commands for your particular shell should work.

C:\Work>svn checkout http://argouml.tigris.org/svn/argouml/trunk/src http://argouml.tigris.org/svn/argouml/trunk/tools argouml --username guest
Password:  (give empty password if prompted)
C:\Work>set JAVA_HOME=C:\Programs\jdkwhatever
C:\Work>cd argouml
C:\Work\argouml\src>build run

A newly compiled ArgoUML will open in a new window.


JDK Java5 or later is required

If you don't understand these instructions or they don't work, please read the rest of the chapter for more detailed instructions on how to build ArgoUML.